Install the screen, following the instructions provided by the manufacturer, Some screens don't neeed extra software but some need to be installed with a script. It's strongly recommended to test it and ensure your hardware is working with Raspbian, Ubuntu or any distro you like. Once you stablished that the screen is working, then proceed installing KlipperScreen.
This install process is meant for a non-desktop version of the OS for example Raspbian Lite, but it should work on other versions.
If you want to use it on a desktop (GUI version), then do
sudo systemctl set-default multi-user.target
if it's a Raspberry Pi, you can use
sudo raspi-config to set boot to console by choosing the following options in order:
KIAUH is a tool that helps you install or upgrade Klipper, Moonraker, Mainsail, and other extensions.
You can visit KIAUH on GitHub to learn more and view its documentation.
First install Klipper and Moonraker.
Execute the following commands:
cd ~/ git clone https://github.com/jordanruthe/KlipperScreen.git cd ~/KlipperScreen ./scripts/KlipperScreen-install.sh
This script will install packages that are listed under manual install, create a python virtual environment at
~/.KlipperScreen-env and install a systemd service file.
If you need a custom location for the configuration file, you can add -c or --configfile to the systemd file and specify the location of your configuration file.
At this point KlipperScreen should be working, if it doesn't start then go to the troubleshooting page
In moonraker.conf ensure that 127.0.0.1 is a trusted client:
force_logins: true requires the moonraker api key in KlipperScreen.conf
If you wish to use the update manager feature of moonraker for KlipperScreen, add the following block to the moonraker.conf:
[update_manager KlipperScreen] type: git_repo path: ~/KlipperScreen origin: https://github.com/jordanruthe/KlipperScreen.git env: ~/.KlipperScreen-env/bin/python requirements: scripts/KlipperScreen-requirements.txt install_script: scripts/KlipperScreen-install.sh managed_services: KlipperScreen
If you see warnings in other UIs ignore them until KlipperScreen finishes installing.