diff --git a/_plugins/spooltracker.md b/_plugins/spooltracker.md new file mode 100644 index 000000000000..391e896f0b71 --- /dev/null +++ b/_plugins/spooltracker.md @@ -0,0 +1,68 @@ +--- +layout: plugin + +id: spooltracker +title: SpoolTracker +description: Simple filament tracking - load a spool, print until empty, repeat. No Spool Management +author: thatguymendel +license: AGPLv3 + +# today's date in format YYYY-MM-DD, e.g. +date: 2025-06-10 + +homepage: https://github.com/thatguymendel/OctoPrint-SpoolTracker +source: https://github.com/thatguymendel/OctoPrint-SpoolTracker +archive: https://github.com/thatguymendel/OctoPrint-SpoolTracker/archive/main.zip + +tags: +- filament +- spool +- tracking +- management +- farm + +screenshots: +- url: /assets/img/plugins/spooltracker/sidebar.png + alt: sidebar screenshot +- url: /assets/img/plugins/spooltracker/popup.png + alt: popup screenshot + +compatibility: + python: ">=3,<4" # Python 3 only + +--- + +Created by AI, this plugin simplifies filament management for farm printers. The workflow is straightforward: + +1. Load a new spool +2. Enter the spool's total weight +3. Print as normal +4. Plugin automatically tracks remaining filament using gcode +5. Use remaining Filament to manage prints +6. When spool is empty, repeat with a new one + +No complex spool management, no tracking multiple spools - just a simple way to know how much filament is left on your current spool. Perfect for farm printers where you want to maximize filament usage and avoid mid-print filament changes. + +## Profiles + +There is a save as profile option for quickly loading regularly used filament + +To use a profile +1. Enter in Spool Info +2. Input profile name +3. Save profile +4. Use the Load profile dropdown to select the profile and the info will be automatically updated + +## G-code Requirements + +The plugin looks for the following G-code at the end of your print file to calculate filament usage: + +; filament used [g] = + + +Make sure your slicer includes this comment at the end of the G-code file for accurate filament tracking. + +## Things to Improve if anyone else actually wants to use this + +1. Add a settings page where the user can specify the gcode to look for +2. Add optional text input to color option \ No newline at end of file diff --git a/assets/img/plugins/spooltracker/popup.png b/assets/img/plugins/spooltracker/popup.png new file mode 100644 index 000000000000..7817f862ecd4 Binary files /dev/null and b/assets/img/plugins/spooltracker/popup.png differ diff --git a/assets/img/plugins/spooltracker/sidebar.png b/assets/img/plugins/spooltracker/sidebar.png new file mode 100644 index 000000000000..5c594de1b4a5 Binary files /dev/null and b/assets/img/plugins/spooltracker/sidebar.png differ