BambuMan is a companion app for Spoolman. It allows you to easily import spools by reading the Bambu Lab filaments NFC tag info.

The app tries to match the tag info with the existing SpoolmanDB entry. When a match is found, the app creates the filament and spool. Imported spools will have the same tray_uuid as the AMS reports over MQTT.

If you use bambuddy (GitHub) or OpenSpoolMan to track your filament usage, it will be able to automatically match the spool inserted into the AMS, no additional action is necessary.

• NFC tag reading on Android (built-in NFC) and Windows desktop (PCSC compatible reader)
• Automatic filament matching with SpoolmanDB — covers most Bambu Lab filaments
• Inventory tracking — groups scanned spools by material with AMS tray UID tracking
• Research Data Contribution — opt-in NFC tag data upload to the bambuman.ee tag library
• QR code scanner for quick Spoolman URL setup
• Configurable import defaults — buy date, price, lot number, location
• Log viewer with email export for troubleshooting
• Auto-setup — creates required extra fields and default vendor in Spoolman

• Android application (your phone has to support NFC)

  Main	Settings	Logs	Research Data Contribution

• Windows desktop application (a PCSC compatible NFC reader like ACR122U or ACR1252U is needed)

  

1. Install the apk, either manually or use F-Droid.
2. Go to settings and scan the Spoolman URL with QR code or enter it manually.
   • BambuMan supports basic authentication, URL format http[s]://username:password@host[:port]/
   • If the password contains special characters (like @ :) it must be URL encoded
3. Go back to main window. BambuMan will connect to Spoolman and create the necessary extra fields and default vendor.
4. Once all three status indicators Settings, Spoolman and NFC are green, you can start reading NFC tags.

1. You will need .NET Desktop Runtime 10 installed
2. Download the released BambuMan.exe or compile from source
3. Paste the Spoolman URL and click Change Url button
   • BambuMan supports basic authentication, URL format http[s]://username:password@host[:port]/
   • If the password contains special characters (like @ :) it must be URL encoded
4. The app connects to Spoolman and creates the necessary extra fields and default vendor.
5. You can start reading NFC tags.

If you have F-Droid installed on your phone, you can install BambuMan from our F-Droid repository.

Contributed NFC tag data is publicly available at bambuman.ee. You can browse the library or download the full archive.

To participate, enable Research Data Contribution in the app settings. Uploaded data is published under the MIT license.

• You can't read filaments in foil bags! The foil blocks the NFC signal. You can still inventory them when you open the bag before use.
• Most Bambu Lab filaments are supported including
  • PLA (Basic, Matte, Silk+, Wood, Glow, Aero, Sparkle, Tough+)
  • PETG (HF, Transparent, Translucent),
  • ABS, ABS-GF, ASA, ASA-CF, PA6-GF, PA6-CF, PAHT-CF, TPU, PC, PVA, Support filaments, and multi-color spools.
• Some niche variants may still need manual matching.

• Spoolman v0.22.1, v0.23.0, v0.23.1
• bambuddy v0.1.6+ (recommended)
• OpenSpoolMan v0.1.8

• Make extra fields optional
• More intuitive UI
• Google Play Store availability

• Bambu-Research-Group for reverse engineering the NFC tag specification
• Plugin.NFC for providing a plugin to use NFC in MAUI

This project is licensed under the AGPL-3.0 License.