BambuMan

BambuMan imports Bambu Lab filament spools into your inventory by reading their NFC tag. It supports two inventory backends — bambuddy and Spoolman — selectable in the app settings.

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.

Download

Google Play	F-Droid

Note: Google Play updates may arrive 1–7 days after the GitHub/F-Droid release due to Google's review process.

Features

• NFC tag reading on Android (built-in NFC) and Windows desktop (PCSC compatible reader)
• Two inventory backends — choose bambuddy or Spoolman in the settings
• 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 backend URL and API key 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

The app is available in two versions

• 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)

  

How to setup

Android — bambuddy

The Android app can inventory into bambuddy. Pick the backend with the selector at the top of the settings page.

1. In bambuddy, create an API key with both the Manage Inventory and Read Status permissions:

   • Manage Inventory — lets BambuMan create and update spools (what the NFC scan writes).
   • Read Status — lets BambuMan list spools, so re-scanning a tag updates the existing spool instead of creating a duplicate.
   

2. Copy the generated key.

   

3. In BambuMan settings, switch the backend to bambuddy, enter the bambuddy address (for example http://host:8000), then scan or paste the API key.

   

4. Go back to the main window. Once Settings, bambuddy and NFC are green, you can start reading NFC tags.

Tip: The API key is long and awkward to type on a phone. On your computer, turn the URL or key into a QR code with a free, no-signup generator like QRCode Monkey, then scan it with the in-app scan button. The API key is a secret, so only paste it into a generator you trust.

Note: bambuddy spools have no Buy date or Lot nr, so those import options are hidden in bambuddy mode. The matched Bambu filament also sets the bambuddy slicer preset automatically.

Android — Spoolman

1. Install from Google Play, F-Droid, or download the APK manually from GitHub releases.
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.

Windows

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.

F-Droid repository

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

NFC Tag Library

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 publicly available without restrictions.

Known limitations

• 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.

Tested with

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

Roadmap

• Make extra fields optional
• More intuitive UI

Big thanks to

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

License

This project is licensed under the AGPL-3.0 License.