External monitor for Klipper & Moonraker
A compact, Wi‑Fi‑enabled display for Klipper/Moonraker printers. Built on a Wemos D1 mini (ESP8266) and a 1.3″ SH1106 OLED, it provides real‑time printer data — temperatures, progress, ETA, fan speeds, and more — in a polished, minimal interface. Designed for broad compatibility and easy integration with any Klipper‑based setup.
The monitor cycles through six pages, presenting key details such as printer status, temperatures, metadata, and fan activity. It also issues an alert when filament runs out.
states
The different states shown on the status page and what each of them means.
| STATE | STATE MEANING |
|---|---|
| Ready | Printer idle and cold |
| Idle | Heating or moving |
| Preparing | Gcode file loaded |
| Printing | Active print |
| Paused | Print paused |
| Cooling | Print finished / cooling nozzle |
| Finished | Print complete and nozzle cooled |
| Filament runout | Filament runout, change filament |
Quickstart
- Download the firmware and open it in Arduino IDE
- Install the ESP8266 board package
- Install required libraries: ArduinoJson, Adafruit GFX, Adafruit SH110X
- Edit WiFi credentials + Moonraker IP in the .ino file
- Wire the OLED: SDA → D2, SCL → D1
- Select board: LOLIN(WEMOS) D1 R2 & mini
- Upload the firmware
- Power the monitor — it will connect automatically and begin displaying data
circuit diagram
Connect the OLED display to the Wemos exactly as shown in the wiring diagram. Be sure to power the display from the 3.3 V pin—not the 5 V pin. Also keep in mind that some OLED modules have the SCL and SDA labels swapped, so double‑check the pin order before wiring.
For detailed instructions, please see the included README.TXT file.
3D PRINTED ENCLOSURE
This project includes a custom 3D‑printable enclosure designed to house the Wemos D1 and the OLED-display. The enclosure is available in two variants: one slightly over‑engineered, and one streamlined version without unnecessary features.
TYPE A
TYPE B
DOWNLOAD
Download the ZIP file containing the source code, documentation, and 3D printable enclosure.
LICENSE
This project is licensed under the Creative Commons Attribution‑NonCommercial 4.0 International License (CC BY‑NC 4.0).
You may use, modify, and share the project for personal and non‑commercial purposes only. Commercial use of any kind is strictly prohibited.
See the LICENSE.TXT file for full details.
contribute
If you’ve found value in this project and would like to show your support, a coffee is always appreciated.
