Portable 3D model library for artists, collectors, and 3D printing enthusiasts.
Status: pre-release (v0.1.0-alpha) | Platform: Windows x64 | License: MIT
MiniCodex is a portable Windows desktop application for cataloging 3D models (STL, OBJ, 3MF, PLY) with a unified model card, associations (references, renders, photos of finished work, print profiles), tags, search, built-in 3D viewer, and scale converter.
- Library grid with soft shadows, hover metadata (size, polygons, file count), 4-angle preview rotation on hover, context menu, double-click to open
- Incremental scanning of source folders (by path, size, and modification date)
- Auto-generated 4-angle previews cached per model, invalidated by source change
- Built-in 3D viewer - drag to rotate, mouse wheel to zoom, wireframe toggle, adjustable shadow softness
- Model card - unified card with 5 tabs: Associations, Files, Tags, Scale, Notes
- Associations - attach reference images and photos of finished work via drag-and-drop, auto-link by filename
- Tags with usage counts and sidebar filter
- Search by name, tag, author, source URL
- Scale converter - 43 presets in 7 categories, manual input, bidirectional real/model height calculation
- Integrations with 12 slicers and 3D editors (Bambu Studio, PrusaSlicer, OrcaSlicer, UltiMaker Cura, Lychee, CHITUBOX, Anycubic Slicer, Anycubic Slicer Next, Blender, ZBrush, 3D-Coat, Meshmixer) - auto-detect via Registry plus manual override
- Themes light / dark / auto with amber accent
- Localization Russian + English, autodetect by system locale
STL, OBJ, 3MF, PLY.
ZIP / RAR / 7Z archives are planned for v1.1.
MiniCodex does not require installation and does not need admin rights.
All data is stored next to the executable in ./data/:
data/library.db- SQLite databasedata/cache/previews/- preview cache (PNG)data/cache/asset-thumbs/- association thumbnailsdata/assets/- associated files (hybrid storage)
First run creates data/ automatically.
- Download
MiniCodex-v0.1.0-alpha-win-x64.zipfrom the Releases page. - Extract to any folder (for example
D:\Apps\MiniCodex\). - Run
MiniCodex.exe.
Windows SmartScreen may warn about an unsigned executable. Click More info -> Run anyway. Code signing is planned for a future release.
- Windows 10 or 11, x64
- 100 MB free disk space (plus size of your model library)
- No additional software required (self-contained, .NET runtime bundled)
Requires .NET 8 SDK (or .NET 9 SDK; both build net8.0 targets).
git clone https://github.com/SantidioEsanti/MiniCodex.git
cd MiniCodex
dotnet build src/MiniCodex.sln
dotnet test src/MiniCodex.sln
powershell -ExecutionPolicy Bypass -File ".\build-release.ps1"
Output: dist/MiniCodex-v0.1.0-alpha-win-x64.zip.
- HANDOFF - current project state, architecture, patch workflow
- ROADMAP - MVP roadmap
- ARCHITECTURE - architectural decisions
- DB_SCHEMA - database schema
- UI_UX - screens specification
- SCALES - scale presets table
MVP is complete. v0.1.0-alpha is the first pre-release. See ROADMAP for the list of deferred features (v1.1+).
Solo development. Feedback welcome via GitHub Issues.
If MiniCodex is useful to you, you can support the author on Boosty. Completely optional - the project is and will remain free.
Names of slicers and 3D editors (Bambu Studio, PrusaSlicer, OrcaSlicer, UltiMaker Cura, Lychee Slicer, CHITUBOX, Anycubic Slicer, Anycubic Slicer Next, Blender, ZBrush, 3D-Coat, Meshmixer) are property of their respective owners. MiniCodex is not affiliated with them and does not claim their trademarks. Integrations work by launching external executables configured by the user.
MIT. See LICENSE.
Copyright (c) 2026 Santidio Esanti.




