.NET React Three.js Docker License
Modelibr is a self-hosted game asset library. It keeps models, texture sets, environment maps, sprites, and sounds in one place, lets you preview them in the browser, and helps you organize them into projects and reusable packs.
Native installers for Windows, macOS, and Linux are published in the GitHub Releases page. They bundle the local web UI, WebApi, asset processor, and PostgreSQL so non-technical users can run Modelibr without setting up Docker.
Main Site | Documentation | Live Demo | Discord | GitHub Issues
The live demo stores its data in your browser, so what you add there is visible only to you.
| Title | Description |
|---|---|
| All your asset types in one place | Store models, texture sets, environment maps, sprites, and sounds in the same library instead of spreading them across different tools. |
| Projects and packs | Group assets into project-specific collections or reusable packs you can use again later. |
| Model version history | Keep multiple versions of the same model and switch between them when needed. |
| Built-in previews | Browse models, environment maps, sprites, and sounds with generated previews, including a lit Three.js environment map viewer. |
| Environment map variants | Upload panoramic files or six cube faces (px/nx/py/ny/pz/nz), keep multiple size variants, choose the preview variant, and override it with a custom thumbnail when needed. |
| Texture set workflows | Attach texture sets to model versions, choose defaults, and work with channel-packed maps. |
| Dual-panel workspace | Open tabs side by side and keep your current layout in the URL for easy sharing and return visits. |
| WebDAV access | Work with the library through a file-browser style workflow when that fits better than a browser-only flow. |
| Blender CLI at runtime | Download Blender CLI from Settings when you need it instead of treating it as a fixed install requirement from day one. |
| Recycle bin and deduplication | Restore deleted assets and avoid wasting storage on identical files. |
Download the installer for your platform from the GitHub Releases page and run it. Two installers are published:
- Modelibr (host) — the full self-contained app for users who can't run the Docker stack. It bundles the database, WebApi, and worker runtime and runs from a tray / menu-bar icon. Open its Show Status window for live service health, the frontend URL, and a Configuration panel (app port, worker process count, jobs per worker, GPU acceleration). The host checks GitHub Releases for newer versions and surfaces an update prompt in the tray and status window.
- Modelibr Client (optional) — a thin desktop window that opens a running host in its own app frame instead of a browser tab. Point it at the host URL shown in the host's status window.
The app and WebDAV are exposed on the same local configurable port.
git clone https://github.com/Papyszoo/Modelibr.git
cd Modelibr
cp .env.example .env
docker compose up -dOpen https://localhost:3010 in your browser. The first visit uses a self-signed certificate, so your browser may ask you to continue manually.
- WebDAV gives Modelibr a more file-browser style workflow, which is useful when you want the library to sit closer to art-pipeline tools.
- Environment maps are exposed through WebDAV globally and inside packs/projects, alongside the rest of the library.
- Native installers expose WebDAV through the local launcher port by default.
- Blender-related flows are part of the repository, and Blender CLI can be downloaded at runtime from the Settings page when you want that workflow.
- If you want more detail, start with the main site and the documentation.
npm run test:all # run any subset of the 10 test suites (interactive picker) npm run test:all:full # run everything, non-interactive npm run test:site # Test Studio — browse every test, CI lanes, timings; run with live output npm run test:audit # flag test suites not tracked by the runner manifest
Suites are self-contained (Docker stacks start/stop themselves). See scripts/test-runner and scripts/test-catalog.
.obj.fbx.gltf.glb.blend
- panoramic uploads in common image formats supported by the preview pipeline
.hdr.exr- six-face cube uploads using
px,nx,py,ny,pz, andnz
- Feature requests and general feedback: Discord
- Bug reports: Discord or GitHub Issues
Business Source License 1.1 — free to use, modify, and self-host. See LICENSE for details.