About
Spoolman is a self-hosted web service designed to help you efficiently manage your 3D printer filament spools and monitor their usage. It acts as a centralized database that seamlessly integrates with popular 3D printing software like OctoPrint and Klipper/Moonraker. When connected, it automatically updates spool weights as printing progresses, giving you real-time insights into filament usage.
Suggested by
App Stores
The Big Bear Universal Apps repository is the single source of truth for all Big Bear app definitions. Apps are maintained in a universal, platform-agnostic format and automatically converted to platform-specific formats.
The BigBearUniversal Apps repo syncs to these.
- BigBearCasaOS: https://github.com/bigbeartechworld/big-bear-casaos
- Big Bear Runtipi: https://github.com/bigbeartechworld/big-bear-runtipi
- Big Bear Umbrel: https://github.com/bigbeartechworld/big-bear-umbrel
- Big Bear Cosmos: https://github.com/bigbeartechworld/big-bear-cosmos
- Big Bear Dockge: https://github.com/bigbeartechworld/big-bear-dockge
- Big Bear Portainer: https://github.com/bigbeartechworld/big-bear-portainer
Pull Request
Documentation
Spoolman makes it easy to track your 3D-printer filament spools, whether you’re working with one printer or managing a print farm.
Key Features
- Filament Management: Track types, manufacturers, weights, and usage across all your spools.
- API Integration: Powerful REST API for linking to other software or custom workflows.
- Live Updates: Automatic spool weight adjustments via Websockets.
- Community Database: Access a collaborative, growing list of filaments and brands.
- Multi-Printer Ready: Spoolman handles updates from multiple printers at once.
- Web-Based Interface: Modern, easy-to-use web dashboard.
Supported Integrations
- OctoPrint (with plugin)
- Klipper/Moonraker (and front-ends like Fluidd, KlipperScreen, Mainsail)
- OctoEverywhere
- Home Assistant
Default Configuration
- Default Port: 7912
- Database: SQLite (default, can switch to MySQL/PostgreSQL/CockroachDB)
- App Data Location:
/home/app/.local/share/spoolman - Automatic Backups: Yes (nightly with SQLite)
Environment Variables
TZ: Timezone (defaultUTC)SPOOLMAN_DB_TYPE: Database engine (sqlite,mysql,postgres,cockroachdb— defaultsqlite)SPOOLMAN_LOGGING_LEVEL: Level (DEBUG,INFO,WARNING,ERROR,CRITICAL— defaultINFO)SPOOLMAN_AUTOMATIC_BACKUP: Enable/disable automatic backups (defaultTRUE)
More Information
For advanced configuration, setup, and troubleshooting, visit the Spoolman Wiki.
App Support
- GitHub: Spoolman
- GitHub Issues for bug reports/requests