Happy Hare v2 available here

Read more on how MMU Panels work...

KlipperScreen Happy Hare edition is quite a mouthful! It is a forked (but up-to-date) version of KlipperScreen designed to run/manage any MMU using the Happy Hare driver software. Click here to access the original documentation.

📌 KlipperScreen is an amazing piece of software but unfortunally lacks the level of panel integration and features I needed for this project. I hope in the future to have changes integrated so that this becomes a layered install rather than a fork. Until then you must follow these install directions closely. Also note that I regularly (every 2 weeks) re-merge with the master project so the Happy Hare addition is only additive and all original functionality is untouched.

Firstly, make sure Happy Hare software is completely up-to-date. Features were added to support this KlipperScreen add on.

Install and setup a base KlipperScreen from the original source. Get it working. Don't skip this step because I cannot help with basic KlipperScreen and system setup. Once you have that installed and working, log into you Rasberry Pi and execute the following commands. You can cut'n'paste...

cd ~
mv KlipperScreen KlipperScreen.orig
git clone https://github.com/moggieuk/KlipperScreen-Happy-Hare-Edition.git KlipperScreen

cd ~/KlipperScreen/happy_hare
./install_ks.sh -g <num_gates>

(where <num_gates> is the number of selectors you built with, e.g. 9)

KlipperScreen will be restarted and hopefully you should now be running the enhanced version!

Notes:

Note that the base KlipperScreen is up-to-date (and I will continue to merge with master every 2 weeks) with changes in the original but also includes extra menu functionality that can be used in the creation of your custom menus. See the generated ercf_klipperscreen.conf for clues!

I can offer limited help on the Discord channels so would prefer if you submit an issue report via github so I can manage them. Also, some folks have asked about making a donation to cover the cost of the all the coffee I'm drinking. I'm not doing this for any financial reward but it you feel inclined a donation to PayPal https://www.paypal.me/moggieuk will certainly be spent making your life with MMU more enjoyable.

Thank you!

I have only tested on a single screen. A 640x480 resolution BTT TFT5.0. It is possible that you might find layout problems on other (likely smaller) displays. Also, I have only tested in and optimized for horizonal orientation. I doubt it will be effective in vertical but I don't know of any Voron owners with vertically mounted panels.

JFYI the installer will alter or add the KlipperScreen entry in moonraker.conf:

[update_manager KlipperScreen]
type: git_repo
path: /home/pi/KlipperScreen
origin: https://github.com/moggieuk/KlipperScreen-Happy-Hare-Edition.git
env: /home/pi/.KlipperScreen-env/bin/python
requirements: scripts/KlipperScreen-requirements.txt
install_script: scripts/KlipperScreen-install.sh
managed_services: KlipperScreen

The CSS style only specifies a "Free Mono" font to be used (this is the same as original KlipperScreen") for all textual displays. I use the Unicode Box character set in that font to render the selector status, filament positions and TTG map. A couple of users have reported issues with this part of the display, either not appearing or not spaced correctly. E.g.

If this occurs the first thing to try is to run the following, then restart KlipperScreen:

sudo apt install fontconfig
fc-cache -f -v
sudo systemctl restart KlipperScreen

If this doesn't fix the problem I suggest installing a new font set.

cd ..to where you extracted font files../fonts/ttf
sudo cp *.ttf /usr/share/fonts/truetype
fc-cache -f -v

cd ~/KlipperScreen/styles

font-family:      JetBrains Mono;

sudo systemctl restart KlipperScreen

It has come to my attention that sometimes a system (OS) update can break KlipperScreen. This is nothing to do with KlipperScreen but rather the installation of a slightly broken video driver fbturbo. Luckily the fix is simple. After OS upgrade run:

sudo apt purge xserver-xorg-video-fbturbo

If you are upgrading and see a message like this when accessing the main MMU panel it is probably because of a version mismatch with Happy Hare on your printer. Follow the instructions in the popup!

The original Klipperscreen panels can be found here

All screen shots are taken with the "Colorize" theme (my preference because the buttons are more defined). The default is z-bolt and looks slightly different