Universal Automated Filament Changer / MMU driver for Klipper
Happy Hare is the original open source filament changer controller for multi-colored printing. The philosophy behind it is to have a universal control system that can adapt to whatever MMU to choose - you change MMU, the software will go with you... Currently it fully supports ERCF, Tradrack, Box Turtle, Angry Beaver, Night Owl, 3MS, 3D Chameleon, as well as other custom designs.
It is implemented as a klipper extension (mostly as python modules) for controlling MMU's / AFC's but implements functionaly that you may like to customize as klipper macros. It has extensive configuration options for customization but also has an installer to help simplify the initial setup for common MMU and MCU types. The different conceptual types of MMUs and the function and operation of their various sensors can be found here and should be consulted for any customized setup. It is best partnered with KlipperScreen for Happy Hare project at least until the Mainsail integration is complete :-)
Extensive documentation can be found in the Wiki
Happy Hare is actively being developed and strives to be maticulous about the quality of multi-colored printing learning from many thousands of users over the past 2+ years. Whilst the experience is very complete today work is continuing in three important areas:
- Addtional MMU support: No one left behind - Prusa MMU, KMS, Open AMS, Pico MMU and others are in the works
- Multi-MMU support: Type-A MMU designs are easy to scale through additional gates. Type-B designs are generally limited to a max of 4 gates. Therefore you might want to set up multiple (perhaps different MMU types) on the same printer.
- Mainsail/Fluidd plugin: The klipperscreen extension provides a rich user interface but many have requested a similar treatment for Mainsail. The wait will be over soon!
Some folks have asked about making a donation to cover the cost of the all the coffee I'm drinking (actually it's been G&T lately!). Although I'm not doing this for any financial reward this is a BIG undertaking (13000 lines of python, 8500 lines of doc, 5500 lines of macros/config). I have put hundreds of hours into this project and if you find value and feel inclined a donation to PayPal https://www.paypal.me/moggieuk will certainly be spent making your life with your favorate MMU more enjoyable. Thank you!
Don't forget to join the dedicated Happy Hare community forum here: https://discord.gg/aABQUjkZPk
- Support almost any brand of MMU or user defined monsters:
- ERCF
- Tradrack
- Box Turtle
- Angry Beaver
- Night Owl
- 3MS
- 3D Chameleon
- Custom...
- Synchronized movement of extruder and gear motors (with sync feedback control) to overcome friction and even work with FLEX materials!
- Support for all type of sensor: pre-gate, post-gear, combiner gate sensors, extruder entry sensors, toolhead sensors
- Full Spoolman integration
- Support for motorized 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 for easy setup
- Supports MMU "bypass" gate functionality
- Moonraker update-manager support
- Moonraker gcode pre-parsing to extract important print infomation
- Complete persistence of state and statistics across restarts
- Highly configurable speed control
- 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 avaialble!
- Drives LEDs for functional feed and some bling!
- Built in tip forming and filament cutter support (both toolhead and at MMU)
- 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!
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: 
German instructional video created by Crydteam
|
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