The easiest way to sync Bambu Lab AMS filament with Spoolman
Tired of manually editing YAML files? SpoolmanSync provides a modern web UI for Bambu Lab filament tracking with Spoolman - no Home Assistant expertise required.
SpoolmanSync automatically tracks which filament spools are loaded in your Bambu Lab printer's AMS units and syncs this information with Spoolman for accurate filament inventory management. Works with all filament brands - not just Bambu Lab spools.
| Feature | SpoolmanSync | Other Solutions |
|---|---|---|
| Web UI for spool assignment | ✅ | ❌ |
| QR/Barcode scanning | ✅ | ❌ |
| Bundled Home Assistant option | ✅ | ❌ |
| No YAML editing required | ✅ | ❌ |
| Multi-AMS support | ✅ | Limited |
| Non-English Home Assistant support | ✅ | ❌ |
| Works with ANY filament brand | ✅ | Partial |
| Automatic filament usage tracking | ✅ | ✅ |
- Dashboard - View all your printers, AMS units, and tray assignments at a glance
- Spool Assignment - Click any tray to assign a spool from your Spoolman inventory
- QR Code Scanning - Scan Spoolman QR codes or custom barcodes to quickly look up and assign spools
- Bambu Cloud Login - Add printers by logging in with your Bambu Cloud account
- Bundled Home Assistant - Includes a pre-configured Home Assistant with ha-bambulab integration
- Webhook Integration - Receives tray change events from Home Assistant automations
- Activity Logging - Track all spool changes and sync events
The fastest way to get started using pre-built Docker images:
# Download the compose file
curl -O https://raw.githubusercontent.com/gibz104/SpoolmanSync/main/docker-compose.prebuilt.yml
# Start with embedded Home Assistant (recommended for most users)
docker compose -f docker-compose.prebuilt.yml --profile embedded up -d
# Or, if you already have Home Assistant with ha-bambulab
docker compose -f docker-compose.prebuilt.yml --profile external up -dThen open http://localhost:3000 and follow the setup steps below.
If you prefer to build locally or want to contribute:
git clone https://github.com/gibz104/SpoolmanSync.git
cd SpoolmanSyncSpoolmanSync requires a Docker Compose profile. Choose based on your setup:
| Mode | Command | Best For |
|---|---|---|
| Embedded | docker compose --profile embedded up -d |
Most users - includes bundled Home Assistant |
| External | docker compose --profile external up -d |
Users who already have Home Assistant with ha-bambulab |
Use this if you don't have Home Assistant or want a simpler setup.
docker compose --profile embedded up -dGo to http://localhost:3000 in your browser.
- Go to Settings in the navigation
- Click Add Printer
- Log in with your Bambu Cloud email and password
- Enter the verification code sent to your email
- Select your printer from the list
- Click Continue
Embedded.Step.3.mp4
- In Settings, scroll to the Spoolman section
- Enter your Spoolman URL (e.g.,
http://127.0.0.1:7912) - Click Connect
Embedded.Step.4.mp4
This enables automatic tray change detection.
- Go to Automations in the navigation
- Click Configure Automations
- The automations are automatically created in the embedded Home Assistant
Embedded.Step.5.mp4
Your dashboard should now show your printer with AMS trays. Click any tray to assign a spool from your Spoolman inventory.
Use this if you already have Home Assistant with ha-bambulab configured.
docker compose --profile external up -dGo to http://localhost:3000 in your browser.
- Go to Settings in the navigation
- Enter your Home Assistant URL (e.g.,
http://127.0.0.1:8123) - Click Connect with Home Assistant
- You'll be redirected to Home Assistant to authorize SpoolmanSync
- Enter you Home Assistant credentials and click "Log in"
External.Step.3.mp4
Your printers should automatically appear on the dashboard (discovered from ha-bambulab).
- In Settings, scroll to the Spoolman section
- Enter your Spoolman URL (e.g.,
http://127.0.0.1:7912) - Click Connect
External.Step.4.mp4
This enables automatic spool tracking and filament usage monitoring.
- Go to Automations in the navigation
- Enter the SpoolmanSync URL - the address where Home Assistant can reach SpoolmanSync (e.g.,
http://192.168.1.100:3000). Use your machine's IP address, notlocalhost, if Home Assistant is on a different machine. - Click Generate Configuration
- You'll see two YAML configurations:
- configuration.yaml - Copy and add to your Home Assistant's
configuration.yaml - automations.yaml - Copy and add to your Home Assistant's
automations.yaml
- configuration.yaml - Copy and add to your Home Assistant's
- Restart Home Assistant
- Return to SpoolmanSync and click Mark as Configured
External.Step.5.mp4
Your dashboard should now show your printers with AMS trays. Click any tray to assign a spool from your Spoolman inventory.
Always use the same profile you used to start:
# Embedded mode
docker compose --profile embedded down # Stop
docker compose --profile embedded up -d # Start
# External mode
docker compose --profile external down # Stop
docker compose --profile external up -d # Start-
Discovery: SpoolmanSync connects to Home Assistant and discovers Bambu Lab printers via the ha-bambulab integration entities.
-
Manual Assignment: Users can manually assign spools to trays via the dashboard or by scanning QR codes.
-
Automatic Sync: When Home Assistant automations detect tray changes, they call the SpoolmanSync webhook with tray information (color, material, tag UID). SpoolmanSync matches this to spools in Spoolman and updates the
active_trayextra field. -
Spoolman Integration: All spool assignments are stored in Spoolman's
extrafield asactive_tray, making it compatible with other Spoolman integrations.
You must specify a profile:
docker compose --profile embedded up -d
# or
docker compose --profile external up -dEmbedded mode:
- Make sure you've added a printer via the Add Printer button
- Check that your Bambu Cloud credentials are correct
External mode:
- Ensure ha-bambulab integration is installed and configured in your Home Assistant
- Verify your Home Assistant URL is correct and you authorized SpoolmanSync
- Check the Logs page for error messages
- Verify the automations were added to Home Assistant
- Make sure you clicked Mark as Configured after adding the automations
- Check that the SpoolmanSync URL you entered is reachable from Home Assistant (use your machine's IP address, not
localhost) - Check that SpoolmanSync is accessible from Home Assistant's network
- Ensure you've granted camera permissions in your browser
- Try using a different camera if available
- Use manual search as a fallback
MIT License - see LICENSE.txt
Contributions are welcome! Please open an issue or pull request.