Help
Short answers to what you'll actually run into. If something's missing, email support@modelist.app and I'll add it.
Download the build for your operating system from the Download section: macOS (Apple Silicon or Intel/Universal .dmg), Windows (x64 Setup.exe), or Linux (x86_64 AppImage / .deb). ARM builds for Windows and Linux are published with releases when supported.
The free version has every feature unlocked but is capped at 50 files. No time limit. The intent is for you to point Modelist at your real folders and confirm it actually works for your library before paying.
On first launch Modelist asks you to add a watched folder. Pick the folder where most of your STL/3MF/OBJ/STEP files live. Modelist scans in the background, generating previews and pulling out embedded thumbnails from 3MFs. You can keep using the app while the scan runs.
Add folders for Modelist to watch from the sidebar (drag a folder from Finder/Explorer onto the watched-folders area, or use the + button). Modelist indexes everything inside, including subfolders. You can add as many watched folders as you want and reorder them by dragging.
STL, 3MF, OBJ, and STEP files. Archive packages are also indexed - ZIP, RAR, 7Z, TAR, TAR.GZ, TAR.BZ2 - Modelist reads the contents without you having to extract them yourself. Archives appear as locked groups in your library. Files up to 200MB are rendered with the built-in 3D viewer; archives up to 500MB are scanned by default. Both limits are configurable in Settings → General.
Modelist syncs automatically when the app starts and detects new files in watched folders during normal use. You can also trigger a manual rescan from the toolbar at any time. We avoid live filesystem watchers because they tend to thrash with network drives and large libraries.
Paste a Makerworld, Printables, or Thingiverse URL into a file's details and Modelist pulls in images, descriptions, and metadata from the source page. Useful for files that arrived as bare STLs without context. There's also an opt-in setting (Settings → General → Extract download URLs) that auto-detects source pages from file metadata - off by default, requires an app restart to take effect.
If the auto-generated preview isn't what you want, drop your own image onto a file to override the thumbnail. Useful for multi-part prints where the full assembly is what you want to see, or for files where the rendered preview is misleading.
Settings → General → Display Settings is where appearance options live: dark mode toggle (Modelist remembers your choice across launches), scrollbar visibility, max cards shown at once (default 505 - higher values are smoother but use more memory), and the default Banderole text used for newly-discovered files.
Settings → General → Model Settings lets you pick the colour Modelist uses to render 3D previews - so STLs don't all look like the same blue blob. After changing it, click "Regenerate all thumbnails with new colour" to apply across your existing library.
If a file fails to render a preview, Modelist marks it unrenderable after a few attempts (otherwise it'd retry forever). Settings → Unrenderable shows the count and lets you reset the status to retry - useful after an update or after fixing whatever caused the failure.
Modelist gives you three layers of organization on top of your folder structure: tags, collections, and groups. None of them move or rename your files - they're metadata Modelist tracks about your library.
Custom labels you can attach to any file. Create them as you go. Tags work well for cross-cutting attributes like "Print Ready", "Articulated", or "Gifts" - things that don't fit a folder hierarchy.
Settings → Tags is the central place to rename, delete, or reorganize tags across your whole library at once. Useful when you've accumulated near-duplicates ("Print Ready" vs "print-ready" vs "PrintReady") and want to consolidate.
Named groupings that exist only inside Modelist. Drag a file onto a collection in the sidebar to add it. A file can live in multiple collections at once. Collections are great for projects, print queues, gifts for specific people - anything that doesn't map to a folder.
Collections can contain other collections. Faction → Unit → Variant works fine. Use the Move Collection picker to reparent existing collections.
Save a search and Modelist keeps the result current as your library grows. Examples: "All Bambu files I haven't tagged yet", "STLs over 50MB", "Things marked To Print". They're live, not snapshots - new matching files appear automatically.
Manually cluster related files - parts of a multi-piece print, variants of the same model, accessories that go together. Give the group a name and a custom thumbnail. Whole groups can be bulk-added to a collection or multi-selected for tagging and other actions.
A customizable status flag attached to each file. Set the values you actually use - "To Print", "Review", "In progress", whatever fits your workflow. The default text Modelist applies to newly-discovered files is configurable in Settings → General (default is "NEW FILE"). To reset every file's banderole at once, use the Clear Banderole option in Settings.
Per-file freeform notes. Print settings that worked, where you found the file, license terms, what went wrong last time - whatever you want to remember. Notes are searchable.
Select multiple files (or whole groups) and tag, add to collections, or delete them in one operation. Multi-select works the way you'd expect: click + shift-click for range, cmd/ctrl-click for individual.
For tracking the physical side of your printing setup.
Settings → Printers lists the 3D printers you own. Add them by name (e.g. "Bambu Lab P2S", "A1", "H2D"). Useful for filtering files by which printer to use, or tracking what's been printed where.
Settings → Materials lists the filaments and other materials you have on hand. Add manually as you load them. Useful for grouping models by material requirements and finding files that work with what's loaded right now.
Settings → Colours is your colour library. Colours get added automatically when 3MFs are imported, or add them manually. Drag colours into named groups (Reds, Blues, Whites, etc.) for quick filtering. Once you've seeded a few colours per group, click Auto-assign to sort the rest based on hex values.
Search runs locally - nothing leaves your computer. Results update as you type. Modelist searches across filename, source description, your notes, your tags, and metadata. When viewing a collection, search is scoped to that collection only.
Beyond text search, you can filter by file format, size range, date, tags, source platform, banderole status, and whether a file is in a collection or not. Save any filter combination as a Smart Collection.
Toggle fuzzy matching when you can't quite remember what the file was called. Modelist forgives a typo or two.
Modelist runs three duplicate-finding methods together:
Settings → Duplicate Finder is the dedicated UI for working through detected duplicates. It walks you through every set Modelist found and lets you decide which to keep, which to delete, and which to leave alone.
Modelist doesn't favor any particular slicer. By default it opens files with whatever your OS has registered as the default app for that extension - STLs open in your default STL app, 3MFs in your default 3MF app, and so on. To send a file somewhere else, use Open With.
Add any application Modelist should be able to send files to - Bambu Studio, PrusaSlicer, OrcaSlicer, Cura, SuperSlicer, Blender, Fusion 360, Meshmixer, your own scripts, anything. Configure custom command-line arguments per app if you want to pass a profile or flag at launch.
Once you've used Open With on a file, Modelist remembers that choice and defaults to it next time. Useful when one model always goes through OrcaSlicer and another through Bambu Studio.
Running two copies of the same slicer side-by-side? Supported - Modelist lets you pick which instance to send to.
Open share.modelist.app on your phone (iOS or Android) and pair it with the desktop app via the QR code shown in Settings. After that, hit the share button on any 3D model link and it lands in your desktop's Inbox - no emailing yourself, no copy-paste.
Anything shared with you - whether from your phone or another Modelist user - lands in the Inbox first. Review, accept, or decline. Accepted files enter your library; declined ones are dropped. Expired share links are tracked so you know when something's no longer available.
Send a file to another Modelist user and they see your gallery, descriptions, and tags - not a bare STL. Free-tier users can receive shared files even at the 50-file limit; sending requires a paid license.
Sharing features (mobile and user-to-user) require a login. They're off by default - turn them on in Settings if you want them. Modelist works fully offline without ever using cloud sharing.
No. Modelist reads files to render previews and extract metadata, but never moves, renames, or rewrites them. The only destructive action is delete, and it's a manual choice you confirm in a dialog. Your folder structure on disk is always the source of truth.
If you delete a file from inside Modelist (with the confirmation dialog), the file is removed from disk and the Modelist index is updated. If you delete a file from Finder/Explorer, Modelist notices on the next sync and marks it unavailable; if you restore the file from your trash to its original location, Modelist reconnects it with all its metadata, tags, and notes.
Move a file between folders on the same drive and Modelist still recognizes it as the same file - your tags, notes, custom thumbnail, and collection memberships all come along. Cross-drive moves currently look like a delete + re-add and lose attached metadata.
The watched folder is marked unavailable in the sidebar until the drive reconnects. Files stay in the database, marked as unavailable, with all metadata preserved. Once the connection is back, files become available again - no re-scan needed.
Rename or move a watched folder and Modelist will mark it unavailable. You'll need to remove the entry and re-add it at the new location, which triggers a re-scan. We're working on letting you update a watched folder's path in-place to preserve metadata across moves.
The core app works offline. Source enrichment (pulling from Makerworld/Printables/Thingiverse URLs) and update checks make outbound requests when triggered. Cloud sharing (mobile and user-to-user) sends data only when you explicitly use it. There's no analytics or telemetry on your library.
Modelist checks for updates on launch. When an update is available you'll get a notification; downloading and installing happens with your confirmation. Your settings and library data are preserved across updates.
Open Settings → License & Version to see the in-app changelog. Every release ships with notes about what changed and why.
The free tier is everything-unlocked at a 50-file cap, no time limit. €20 buys v1 - all v1.x updates included. €60 buys lifetime - every major release of Modelist forever, including v2 when it lands. One-time payment in either case.
Settings → License & Version shows the current version and build. Useful when reporting bugs.
Email support@modelist.app for anything - questions, bug reports, feature ideas, edge cases your library exposes. When reporting a bug, please include your OS, your Modelist version, and steps to reproduce.
Bigger ideas live at ideas.modelist.app. Vote on what's already there, or post something new.
The full release history (with notes) lives on GitHub. Useful if you need to roll back, or compare what shipped when.
Settings → Logs shows recent app activity. Useful for troubleshooting an issue yourself or sharing context when reporting a bug.