How xiao-villamor/printstash works
PrintStash is a self-hosted 3D-printing library and printer-management web app. The main user journey is to upload or capture design files, review pending imports, organize Models, inspect previews, and optionally send a print and retain its result. The map also includes documented search, multipart projects, external library sources, and backup capabilities. Relationships are limited to README-documented workflows and the sampled storage and preview implementation; unsampled subsystems are represented at their exact enclosing directories, without asserting internal call paths.
Main entry points: thumbnail_engine.py Mesh Preview · ingestion Import and Inbox · library Models and Collections · storage_connections.py Storage Connections API
Components 18
Import and Sources
- Browser Capture
browser-extension/popup.ts - Import and Inbox
backend/app/modules/ingestion - Library Sources
backend/app/modules/sources
Library and Discovery
- Models and Collections
backend/app/modules/library - Multipart Projects
backend/app/modules/library/multipart_models.py - Search and Views
backend/app/modules/search
Preview and Media
- Mesh Preview
backend/app/modules/media/thumbnail_engine.py - STL Reader
backend/app/modules/media/stl_reader.py - Mesh Renderer
backend/app/modules/media/mesh_render.py
Printing
- Printer Fleet
backend/app/modules/printing
Storage and Operations
- Remote Storage
backend/app/modules/storage/storage_providers.py - Storage Connections API
backend/app/api/v1/storage_connections.py - Storage Backends
backend/app/modules/storage/storage_backend/contracts.py - Storage Operations
backend/app/modules/storage/storage_operations.py - Storage Records
backend/app/db/models/storage.py - Backups
backend/app/modules/backups - Access and Sharing
backend/app/modules/identity
Other components
- User
Connections 19
- User → Import and Inbox: uploads files
- User → Browser Capture: captures models
- Browser Capture → Import and Inbox: submits captures
- User → Library Sources: connects sources
- Import and Inbox → Models and Collections: imports models
- Library Sources → Models and Collections: indexes files
- User → Models and Collections: organizes library
- User → Multipart Projects: groups models
- User → Search and Views: searches library
- User → Mesh Preview: inspects files
- Mesh Preview → STL Reader: reads STL
backend/app/modules/media/thumbnail_engine.py - Mesh Preview → Mesh Renderer: renders mesh
backend/app/modules/media/thumbnail_engine.py - User → Printer Fleet: manages prints
- User → Remote Storage: configures storage
- Storage Connections API → Storage Records: reads and writes
backend/app/api/v1/storage_connections.py - Storage Connections API → Remote Storage: resolves providers
backend/app/api/v1/storage_connections.py - Storage Operations → Storage Backends: uses backend contract
backend/app/modules/storage/storage_operations.py - User → Backups: protects library
- User → Access and Sharing: shares and controls access