Skip to content

Multimaterial Support

Simple AF is adding full MMU support for either AFC or Happy Hare, initially this support is documenting how to install AFC and Happy Hare and enable MMU panels in grumpyscreen, in the future we will be adding custom hooks for filament cutters and the like to make integrating a MMU much easier.

Note

A community member is working on porting CFS to work with AFC, so far the results are looking promising, we will update the wiki if we get to a point where we are comfortable to release the code!

Install AFC

For more information head to https://github.com/AFCProject/AFC-Klipper-Add-On

Note

For Simple AF for RPI follow the AFC official guide instead.

First of all clone the repo, you must clone it to /usr/data, do NOT clone it to /root:

pip install crudini
git clone https://github.com/AFCProject/AFC-Klipper-Add-On.git  /usr/data/AFC-Klipper-Add-On
ln -s /usr/data/AFC-Klipper-Add-On /root
cd /root/AFC-Klipper-Add-On
./install-afc.sh -k /usr/data/klipper -m /usr/data/printer_data/config/moonraker.conf -y /usr/share/klippy-env/bin -p /usr/data/printer_data/config

Warning

The above approach will hopefully be greatly simplified soon as a few fixes have been made to the Creality OS support on the AFC repository but not released.

Install Happy Hare

For more information head to https://github.com/moggieuk/Happy-Hare

Note

For Simple AF for RPI follow the Happy Hare official guide instead.

The default installer needs to be executed with some different arguments

So first of all clone the repo:

git clone https://github.com/moggieuk/Happy-Hare.git /usr/data/Happy-Hare

Then run the installer:

cd /usr/data/Happy-Hare
./install.sh -k /usr/data/klipper -c /usr/data/printer_data/config -z -m /usr/data/moonraker -e
systemctl restart moonraker
systemctl restart klipper

Enable MMU in Grumpyscreen

To access the MMU panel in grumpyscreen you must modify the grumpyscreen.ini to enable your chosen backend:

image

Restart Grumpyscreen after making this change

Tip

You can restart Grumpyscreen via the Services menu in Fluidd or Mainsail, you can also Restart GUI from Grumpyscreen

When you restart Grumpyscreen there will be a MMU icon on the left panel, it will be grayed out until klipper starts and Grumpyscreen sees the required MMU configuration registered.

image