Skip to main content

Installing the Happy-Hare Plugin

Back up your configuration before installing

Happy-Hare will modify Klipper and Moonraker configurations. Back up /usr/share/printer_data/config before installing, and answer the installation script's questions based on your actual MMU hardware.

Installing Happy-Hare​

The current Happy-Hare installation script can automatically detect FLYOS-FAST and uses /data/klipper, /data/moonraker, and /usr/share/printer_data/config.

Pulling or updating the plugin​

This step requires a connection to GitHub. After confirming the pull is successful, run the installation script.

cd /data
if [ -d /data/Happy-Hare/.git ]; then
  git -C /data/Happy-Hare pull --ff-only
else
  git clone https://github.com/moggieuk/Happy-Hare.git /data/Happy-Hare
fi
Loading...

Running the installation script​

-i indicates first-time interactive installation, and -z skips the script's internal online update check. Therefore, this step no longer depends on GitHub.

cd /data/Happy-Hare
chmod +x install.sh
./install.sh -i -z
Loading...

The installation script will write the configuration based on your selections and restart Moonraker and Klipper when finished. Do not use the example answers directly without understanding your MMU hardware parameters.

Verifying the services​

systemctl is-active klipper
systemctl is-active moonraker

After both commands return active, continue debugging based on the configuration generated by Happy-Hare.

Installing Happy-Hare KlipperScreen​

Applicability conditions

Only install this if your device already uses KlipperScreen and you genuinely need the Happy-Hare-specific interface. The installation will replace /data/KlipperScreen; the original directory will be preserved as /data/KlipperScreen-original.

Pulling the interface for the first time​

This step only downloads the new interface and will not stop or replace the current KlipperScreen.

cd /data
git clone https://github.com/kluoyun/KlipperScreen-Happy-Hare-Edition.git /data/KlipperScreen-Happy-Hare
Loading...

If the replacement has already been done, subsequent updates can be performed separately:

git -C /data/KlipperScreen pull --ff-only

Replacing and installing the interface​

First confirm that /data/KlipperScreen-original does not exist. If this backup directory already exists, do not run the directory replacement command again.

Change GATES=12 to the actual number of filament channels:

GATES=12
systemctl stop klipperscreen
mv /data/KlipperScreen /data/KlipperScreen-original
mv /data/KlipperScreen-Happy-Hare /data/KlipperScreen
cd /data/KlipperScreen/happy_hare
chmod +x install_ks.sh
./install_ks.sh -z -g "$GATES"
Loading...

-z skips the installation script's internal online checks. The script will automatically restart KlipperScreen when finished.

Verifying the interface service​

systemctl is-active klipperscreen

A return value of active indicates the service has started; interface functionality still needs to be checked against your actual MMU configuration.

Loading...