Universal Automated Filament Changer / MMU driver for Klipper
Happy Hare is the original open-source filament changer controller for multi-color printing. Its philosophy is to provide a universal control system that adapts to your choice of MMU (Multi-Material Unit). If you switch MMUs, the software transitions seamlessly with you. Currently, it fully supports ERCF, Tradrack, Box Turtle, Angry Beaver, Night Owl, 3MS, 3D Chameleon, QuattroBox, PicoMMU, KMS, BTT ViViD and various custom designs.
The system is implemented as a Klipper extension (primarily using Python modules) to control MMUs and AFCs. It also provides functionality that can be customized through Klipper macros. With extensive configuration options for personalization, it includes an installer to simplify the initial setup for popular MMU and MCU types. For details about the different conceptual types of MMUs and the functions of their various sensors, refer to the conceptual MMU guide. This guide is particularly useful for customized setups. For the best experience, pair it with the KlipperScreen for Happy Hare project, at least until Mainsail integration is completed. Extensive documentation is available in the Wiki.
Happy Hare is under active development, with a meticulous focus on the quality of multi-color printing. It has benefited from insights gained over two years from thousands of users. While the experience is highly polished, development continues in three key areas:
- Additional MMU Support: Striving for inclusivity—support for Prusa MMU and others is in progress
- v4 Rework: This release will allow for even more modularity and in particular support for dissimilar MMU/AFC's on the same printer! Yes, mix your old ERCF and BoxTurtle on the same machine or even direct to different toolheads in a IDEX design!
Some users have inquired about making donations to support this project (and to keep my coffee or G&T supply steady!). While this project is a labor of love and not financially motivated, it is a substantial undertaking—comprising 18,000 lines of Python code, 10,000 lines of documentation, 160 illustrations and 6,000 lines of macros/configuration. If you’ve found value in Happy Hare and wish to contribute, donations can be made via PayPal https://www.paypal.me/moggieuk. Any support will be spent improving your experience with your favorite MMU/AFC. Thank you!
Don't forget to join the dedicated Happy Hare community forum here: https://discord.gg/aABQUjkZPk
Just a few of the features:- Support almost any brand of MMU (including mods) or custom monsters:
- ERCF
- Tradrack
- Box Turtle
- Angry Beaver
- Night Owl
- 3MS
- 3D Chameleon
- Quattro Box
- PicoMMU
- MMX
- KSM
- BTT ViViD
- Custom...
- Klipperscreen and Mainsail/Fluidd UI
- Support for all type of sensor: pre-gate, post-gear, combiner gate sensors, extruder entry sensors, toolhead sensors
- Full Spoolman integration
- Multiple MMUs managed as one (limited to type-A until v4 release)
- Support for motorized eSpooler filament buffer systems for rewinding
- Suite of startup macros that include sophisticated parking options for filament change or error operations
- Implements a Tool-to-Gate mapping so that the physical spool can be mapped to any tool
- EndlessSpool allowing a spool to automatically be mapped and take over from a spool that runs out
- Sophisticated logging options (console and separate mmu.log file)
- Can define material type and color in each gate for visualization and customized settings (like Pressure Advance)
- Automated calibration and tuning for easy setup
- Supports MMU "bypass" gate functionality
- Moonraker update-manager support
- Moonraker gcode pre-parsing to extract important print information
- Complete persistence of state and statistics across restarts
- Optional integrated encoder driver that validates filament movement, runout, clog detection and flow rate verification!
- Vast customization options most of which can be changed and tested at runtime
- Integrated help, testing and soak-testing procedures
- Gcode pre-processor check that all the required tools are available!
- Drives LEDs for functional feed and some bling!
- Built in tip forming and filament cutter support (both toolhead and at MMU)
- Synchronized movement of extruder and gear motors (with sync feedback control) to overcome friction and even work with FLEX materials!
- Lots more... Detail change log can be found in the Wiki
Controlling my oldest ERCF MMU with companion customized KlipperScreen for easy touchscreen MMU control and new Mainsail/Fluidd integration!
Ok, ready to get started? The module can be installed into an existing Klipper setup with the supplied install script. Once installed it will be added to Moonraker update-manager to easy updates like other Klipper plugins. Full installation documentation is in the Wiki but start with cloning the repo onto your rpi:
cd ~ git clone https://github.com/moggieuk/Happy-Hare.git
 |
MMU's are complexd! Fortunately Happy Hare has elaborate documentation logically organized in the Wiki
Other Resources: 
Great (english) overview including Mainsail UI support
|
Although the journey to calibrating and setup can be a frustrating one, I wanted to share @igiannakas (ERCFv2 + Orca Slicer + Happy Hare) example prints here. Click on the image to zoom it. Incredible! 🆒 👏
Most of the development of Happy Hare was done on my trusty old ERCF v1.1 setup but as it's grown, so has my collection of MMU's and MCU controllers. Multi-color printing is addictive but can be frustrating during setup and learning. Be patient and use the forums for help! But first read the Wiki!
There once was a printer so keen,
To print in red, yellow, and green.
It whirred and it spun,
Mixing colors for fun,
The most vibrant prints ever seen!
(\_/)
( *,*)
(")_(") Happy Hare Ready
