Skip to content

Developer Guide

Basic setup for an enviroment to do development of KlipperScreen.

Alfrix Note:

I use a standard Linux distro with a desktop enviroment.

Clone the repo

Clone your fork, for example:

cd ~
git clone

Install the dependencies on the host

The X11 or Wayland dependencies should not be needed if you are running a desktop GNU/Linux distro. See scripts/system-dependencies.json

Create a virtual environment

For example:

cd ~/KlipperScreen
python3 -m venv .venv
source .venv/bin/activate
pip install -r scripts/klipperscreen-requirements.txt

Set configurations

Create klipperscreen.conf and place it on the repo folder

# disable screen timeouts
# disable Fullscreen and start in a specified size
# 480 x 320 is the minimum size to target
# setting width or height will disable fullscreen and it's the intended behavior 

At this point you can add your actual printer section with the IP (and port of needed) to the config or/and add a virtual printer

Optional: Virtual printer

You may use a virtual printer like it's described in the klipper docs, or it's alternative that uses docker

Using a Virtual printer will need klipper and moonraker need to be installed in the machine too.


The virtual printer has various limitations, like constant temperature and limited availability of pins, it's not a limitation of klipperscreen

Optional: Configure the IDE

  • Set interpreter to the virtual environment created
  • Set the run configuration to KlipperScreen/