Getting Started
What is Filament Tracker?
Filament Tracker is a web app for managing your 3D printing filament inventory. It shows real-time stock availability from Bambu Lab stores worldwide, tracks your owned filaments, and helps you manage what you have and what you need.
How do I select which filament types to view?
Use the sidebar on the left to check/uncheck filament types. Quick selection buttons:
- All - Select all filament types (non-filament groups are not included)
- Mine - Only types you own or have wishlisted
- Sale - Only items in the current bulk sale (when active)
- None - Deselect all types
How do I mark a filament as owned or wishlisted?
Click the status pill in the top-right corner of any filament card. It cycles through three states:
- Not Owned - You don't have this filament
- Wishlist - You want to buy this filament
- Owned - You have this filament
Tip: Long press (hold) a Wishlist pill to quickly remove it from your wishlist. The pill will fill red from left to right — release after it completes to confirm.
What do the colored dots in the sidebar mean?
The dots next to each filament type indicate your ownership:
- Green dot - You own at least one filament of this type
- Blue dot - You have at least one filament of this type on your wishlist
How do I use the Interactive Tour?
Click Tools & Settings at the bottom of the sidebar, then go to the Help tab and click "Show Interactive Guide". The tour will walk you through all the main features step by step.
How do I change the display theme?
Open Tools & Settings > Settings and use the Display Theme button. The app cycles between Auto, Light, and Dark. Auto follows your device preference.
What is Compact Cards mode on mobile?
On mobile layouts, enable Compact Cards in the top bar to switch to a denser layout. Each compact card shows quick status indicators and the filament image only; tap the image to open full details in a modal card.
On larger mobile/tablet widths, compact cards use fixed-width columns for better space usage while keeping the same actions.
Compact mode supports the same actions as full cards, including status changes, Buy More, Print Status, and inventory updates.
Inventory Tracking
How do I track my filament quantities?
When a filament is marked as Owned, an inventory panel appears at the bottom of the card with:
- Spools - Number of full, unopened spools
- Refills - Number of refill packs
- Open Spool Weight - Slider to track remaining grams on your current open spool (0-1000g)
What is "Buy More"?
The π shopping cart icon on owned filament cards marks them as "Buy More". When active π, it adds the filament to your Wishlist / Buy More filter, making it easy to track which owned filaments need restocking.
How do min / max stock levels work?
Enable min / max stock counters in Tools & Settings > Settings. Each owned filament card will then show Min and Max controls on the same row. Min compares your total remaining spool-equivalent stock against the minimum you set.
If a filament drops below that minimum, it is automatically flagged for Buy More and can be filtered with Status Filter > Below Min Levels. Max is a planning target for how much stock you want to keep on hand.
What is Print Status?
The π¨ printer icon on owned filament cards lets you mark filaments as:
- π¨ To Print - Filament you plan to use for an upcoming print (your "to load" queue)
- π¨ Loaded - Filament currently loaded in your printer
Use the To Print / Loaded filter to see all filaments with these statuses.
Tip: Long press the print-status icon to step backwards: Loaded β To Print, or To Print β Unloaded. Unloaded has no long-press action.
What are the stock badges on cards?
Each filament card shows availability badges:
- Spool - Full spools are in stock
- Spool - Full spools are out of stock
- Refill - Refills are in stock
- Refill - Refills are out of stock
The colored bars next to badges show stock history over the last 30 days (green = in stock that day).
What is ETA mode?
Toggle the Out of Stock switch in the filter bar to switch between:
- History - Shows 30-day stock availability bars
- ETA - Shows estimated restock date for out-of-stock items (when available)
What are archived filaments?
When Bambu Lab discontinues a filament color (no longer available in the store), it becomes "Archived". Archived filaments show an "Archived - Not in store" label, but you can still track your existing inventory for these colors. If you want to remove an archived filament from your view, you can delete it using the button on the card.
What is the "Open a Spool" workflow?
When you decrement a Full Spool or Refill, the app will ask if you want to "open" it. You have two choices:
- Yes, Open It - Removes the spool/refill and automatically creates a new 1000g Open Spool. If the removed item had a location assigned, that location is transferred to the new open spool.
- No, Just Remove - Simply removes the spool/refill without creating an open spool.
This saves you the manual step of decrementing stock and then separately adding an open spool with the correct weight.
Filtering & Searching
What filters are available?
Use the dropdowns in the top bar:
- Colour Group - Multi-select color families for filament items (OR logic; matching any selected group will show)
- Status Filter - Multi-select status conditions (AND logic; items must match all selected statuses), including Below Min Levels, Owned + Wishlist / Buy More, and In Library
- Location Filter - Multi-select storage locations (OR logic; matching any selected location will show, including Not Located)
- Store - Select which Bambu Lab regional store to check stock
To clear a filter quickly, open the dropdown and choose All ....
Can I save or share my current filters?
Yes. The app keeps filter state in the URL (search, status, colour groups, and locations), so you can bookmark or share your current view. Status selections are also saved locally and restored automatically when no status filter is provided in the URL.
Why didn't a card disappear after I changed status?
When status filters are active, cards you just edited can stay visible so you can finish related actions without losing context. If you prefer the old behavior, enable Always auto-apply filter changes in Tools & Settings > Settings > Filter Behavior.
How does search work?
The search box matches against:
- Colour name (e.g., "Jade White")
- Colour code (e.g., "11101")
- Hex color - Enter a hex code like "#FF5733" to find the closest matching colors!
How do I sort filaments?
Use the Sort by dropdown to add sort conditions. You can:
- Add multiple sort conditions (e.g., sort by Type, then by Name)
- Drag and drop sort pills to reorder priority
- Click the X on a pill to remove that sort condition
Available sort options: Type, Status, Name, Brand, Colour Group, ETA Back in Stock, Inventory Weight Asc, and Inventory Weight Desc.
How do I change the Bambu Lab store region?
Use the Bambu Store dropdown in the top bar. Available regions include US, EU, UK, AU, JP, and more. Stock availability varies by region.
Custom Items
How do I add custom filaments or accessories?
Click +Add Custom Item in the sidebar. Fill in:
- Supplier - Select from common brands or enter your own
- Type - Select the material/category type
- Name - Colour name for filament, or item name for accessories
- Colour Group + Hex - Used for filament color filtering and 3MF matching
- Product/Image URL - Optional links
When you select an accessory-style type (for example Accessories, Hotends, or Build Plates), the modal switches to accessory mode: color controls are hidden, the group defaults to Other, and inventory uses a single Qty counter.
You can add multiple purchase links for a custom item, open them from the Custom card badge, save a note from the note icon on the card, and use Save and Add More to keep the same supplier and type while starting the next item immediately.
How do I edit or delete a custom item?
Click the pencil icon on any custom card (filament or accessory). This opens the edit modal where you can modify details or delete the item. Use the copy icon next to it to duplicate an existing custom item into a new draft without re-entering everything from scratch.
Can I add my own filament types?
Yes! Go to Tools & Settings > Settings and scroll to Custom Filament Types. You can add types like "PLA Pro" or "PETG-CF" to any material group. These will appear in filters and dropdowns.
Advanced Features
What is Multiple Open Spools?
Enable this in Settings to track weight on multiple open spools of the same filament. Perfect for using up leftover filament from different projects.
When enabled, each filament card shows a summary of your open spools. You can also enable "Show full spool details on cards" in Settings to display all individual open spool weights directly on the card instead of a summary.
If you prefer counts instead of grams, enable Use simple open spool counter (no weights) in Settings.
You can also choose how open spool weights are entered. In Settings, use Open spool weight control to change slider granularity, or set it to 0 to switch to direct number-entry boxes.
What is Stock Locations?
Enable in Settings to track where each spool is stored. You can:
- Create custom location names (e.g., "Shelf A", "Printer", "Storage Box")
- Assign locations to individual spools, refills, open spools, printers, and accessories
- Flag locations as AMS / Printer so moving stock there auto-manages print status
- Filter by location to find items in specific places
- See "Not Located" items that haven't been assigned
Smarter Decrementing: When you decrement a spool or refill that has multiple items with locations assigned, the app will ask you which specific item/location you want to remove from, so you always know exactly what's being changed.
You can also enable "Show full location details on cards" in Settings to display all location assignments directly on the card instead of a summary.
If you prefer faster location entry for full stock, enable Use Bulk Locations for spools and refills. That mode lets you assign counts per location for full spools and refills, while open spools continue to use individual rows.
How does 3MF Upload work?
Click Upload 3MF in the sidebar to upload a Bambu Studio project file. The app will:
- Extract the filament colors used in the project
- Match them to filaments in your inventory by hex color
- Show which filaments you have and which you need
Note: This is experimental. Accuracy depends on hex color data in your filaments.
What is Scan Bambu Label?
Use Scan Bambu Label from the sidebar to capture or upload a photo of an official Bambu Lab filament side label, then review the detected match before adding stock to your inventory.
- Highly experimental: OCR accuracy depends on photo clarity, lighting, and label condition
- Current scope: matching only supports official Bambu Lab filament labels for now
- Private by default: OCR runs locally in your browser, and the label image is not uploaded anywhere
What is the 3MF File Library?
The 3MF Library lets you save uploaded 3MF projects for future reference. After uploading a 3MF file and selecting your filaments, click Save to Library to store the project. Access your library at any time using the View Library button in the sidebar.
You can choose an image embedded in the 3MF file (if available) as the project's thumbnail when saving to the library. The app caches this locally first for fast display, then uploads/syncs in the background for cloud accounts.
You can click library images (card thumbnails and project thumbnail previews) to expand them in the full-screen image viewer.
The Library shows each project's status at a glance:
- Ready to Print - You own all the required filaments
- Partial Inventory - You have some but not all filaments
- Missing Filaments - Required filaments are not yet owned
Each required filament can also store a required grams value, so the library can flag projects where you own the right colour but not enough material. Slot-number badges are shown in project views to make multi-slot matching easier.
You can organise projects with Categories (manage them in Settings), add notes, and filter by status. Use the "In Library" status filter on the main grid to see which filaments appear in your saved projects. This tracking is now always enabled by default (no separate toggle required).
Use the library grouping selector to switch between Group: Category and Group: Least Colour Changes, and watch for loaded badges in filament indicators when required filaments are currently loaded.
Categories are sorted alphabetically, and if a category is deleted, affected projects are automatically moved to Unassigned.
What is the Filament Stats panel?
Open Tools & Settings > Tools to see Filament Stats. It summarizes your owned filament by brand and type, plus approximate value and full-price totals using the pricing data from the currently selected store region.
What are Printers & Accessories?
The app includes official Bambu Lab printers and accessories alongside filaments. You can track which printers and accessories you own using the same status and inventory controls as filaments.
To filter accessories by compatibility:
- Go to Tools & Settings > Settings and find the My Printers section
- Select the printers you own
- The sidebar and grid will automatically filter accessories to show only those compatible with your selected printers
If no printers are selected, all accessories are shown. Printers and accessories appear under the Other group in the sidebar.
What is Cloud Sync?
Cloud Sync (for supporters) keeps your inventory synchronized across devices in real-time. Your data is encrypted before upload. Set up in Tools & Settings > Account.
Can I opt out of test-environment emails?
Yes. If you're signed into a Cloud Sync account, open Tools & Settings > Account and enable Opt out of test-environment email notifications. This preference is saved to your account.
Data & Backup
Where is my data stored?
By default, all data is stored locally in your browser. This means:
- Your data never leaves your device unless you enable Cloud Sync
- Clearing browser data will delete your inventory
- Different browsers/devices have separate data
How do I backup my data?
For a local backup file, go to Tools & Settings > Tools and click Export Backup. This downloads a .json file with your inventory, preferences, custom items, library data, and settings.
If Cloud Sync is enabled, you can also open Cloud Backup & Restore from the same Tools tab to create encrypted cloud backups manually or turn on automatic daily cloud backups.
How do I restore from a backup?
For a local .json backup, go to Tools & Settings > Tools and click Import Backup. Select your backup file. You can choose to:
- Full Restore - Replace all data with the backup
- Import Custom Filaments Only - Just add custom filaments from the backup
For cloud backups, open Cloud Backup & Restore, choose a backup, and click Restore. The app emails you a 6-digit restore code, creates a pre-restore safety backup, and then refreshes the app view once the restore completes.
How does Cloud Backup retention work?
Automatic cloud backups are cleaned up automatically to keep the list manageable:
- Automatic backups: one per day for the last 7 days, then one per week through day 35
- Pre-restore safety backups: kept for 7 days
- Manual backups: up to 10 are allowed at a time; delete one before creating an 11th
What is Bulk Import from CSV?
Use Bulk Import from CSV in Tools when you want to import many rows from a spreadsheet at once. You can download the template directly in the import flow.
- Supports Product URL and Image URL columns
- Lets you preview each row before import
- Can map unmatched rows to a new custom item and edit that custom draft before importing
What is Bulk Import from Text?
If you've copied filament info from an order or spreadsheet, use Bulk Import from Text in Tools. It parses common formats and matches them to official Bambu filaments.
The expected format matches line items shown in your Bambu Lab store account order details, so copy/paste from that view should import correctly.
For extra examples and tips, see the official Facebook page linked in the import modal and contact section.
How do I export for spreadsheets?
Click Export Owned/Wishlist as CSV in Tools to download a spreadsheet-compatible file of your inventory.