Spoolman
Keep track of your inventory of 3D-printer filament spools.
What is Spoolman?
Keep track of your inventory of 3D-printer filament spools.
Overview of Spoolman
What it is
Spoolman is a self-hosted web service designed to help manage 3D printer filament spools and monitor their usage. It acts as a centralized database that integrates with 3D printing software like OctoPrint and Klipper/Moonraker. When connected, it automatically updates spool weights as printing progresses, providing real-time insights into filament usage. The project is open source under the MIT license.
Key features
- Filament Management: Keep records of filament types, manufacturers, and individual spools.
- API Integration: REST API allows integration with other software for automated workflows and data exchange.
- Real-Time Updates: Live spool updates through Websockets provide immediate feedback during printing.
- Central Filament Database: A community-supported database of manufacturers and filaments simplifies adding new spools.
- Web-Based Client: Built-in web client lets you view, create, edit, delete filament data; search, group, filter by manufacturer, material, location; add custom fields; design and print QR labels; contribute to translations into 18 languages.
- Database Support: SQLite, PostgreSQL, MySQL, and CockroachDB.
- Multi-Printer Management: Handles spool updates from several printers simultaneously.
- Advanced Monitoring: Integrate with Prometheus for historical analysis of filament usage.
Use cases
Spoolman is used by 3D printer operators to track filament inventory, monitor usage across multiple printers, and integrate with existing printing workflows. It is suitable for hobbyists, makerspaces, and small print farms that need a centralized database for filament spools. The API and Websocket features enable integration with automation systems, home assistant setups, and AI assistants via the Model Context Protocol.
Getting started
Please see the Installation page on the Wiki for details how to install Spoolman. If the new client misbehaves on your setup, set SPOOLMAN_LEGACY_CLIENT=TRUE to go back to the previous one. Both ship in every release and talk to the same API, so your data is untouched either way — but please report the problem so it can be fixed.
License and pricing
The project is open source under the MIT license. Pricing is not stated; it is self-hosted and free to use.
Based on the project's public README and repository metadata.