The QIDI Q2 is a genuinely good printer: fast, enclosed, Klipper-powered, and happy to eat engineering filament for breakfast. Its stock touchscreen, however, feels like a very polite kiosk standing in front of a full Linux computer.
I could not find a ready-to-run way to put real KlipperScreen on the built-in 480×272 panel, so I made one.
What the installer does
- runs directly on the printer over SSH;
- installs KlipperScreen on the stock display — no extra Pi or HDMI screen;
- calibrates the original touchscreen;
- keeps the QIDI interface intact;
- adds full-screen gestures: swipe up for KlipperScreen, swipe down for the factory UI;
- includes backup, uninstall, and rollback paths.
The factory client is not deleted. I like experiments, but I also like having a parachute.
Tested on QIDI Q2 firmware 01.01.02.03. Read the compatibility notes and make a backup before installing; the printer is still a Linux computer wearing heaters.
Repository and installation guide: https://github.com/jeecrypt/klipperscreen-q2
If you have the same hardware/firmware and find a weird edge case, open an issue with logs. Weird edge cases are just undocumented features wearing fake moustaches.
Top comments (0)