CYD_SnapMaker_U1

CYD Snapmaker U1 Screen

A custom, standalone touchscreen firmware for the Snapmaker U1 (or any Klipper/Moonraker printer) using the “Cheap Yellow Display” (CYD) ESP32 board.

I built this because I wanted a dedicated, physical screen for my printer without having to deal with the overhead of a Raspberry Pi screen. This firmware talks directly to Moonraker’s API to give you live stats, temperature control, toolhead management, and file launching—all from a $15 screen.

By Nate’s Print Shop


✨ Features


🛠️ Hardware Requirements


⚡ How to Install (The Easy Way)

You do not need to download VS Code or compile anything yourself!

  1. Plug your CYD screen into your computer using a data cable.
  2. Open Google Chrome or Microsoft Edge.
  3. Go to the Web Flasher here: CYD Snapmaker Web Flasher
  4. Click Connect, select your ESP32’s COM port, choose your screen size, and hit Install.

⚙️ Initial Setup Guide

Once the screen is flashed, here is how to get it connected to your printer.

1. Connect to Wi-Fi

On first boot (or if it loses connection), the screen will show a “Wi-Fi Setup Required” page.

2. Touch Calibration

After connecting to Wi-Fi for the first time, it will ask you to calibrate the screen.

By default, the screen looks for a printer at 192.168.1.100. To change this:

  1. Tap the Settings (S) icon on the bottom of the left sidebar.
  2. Tap Edit IP.
  3. Use the numpad to type in your actual printer’s IP address and hit SAVE.
  4. The screen will now connect to your printer! You can also use the Edit Name button to change what the printer is called on the home screen.

4. The Web Dashboard (Advanced Settings)

To access Themes, Sensor Calibration, and Display modes:

  1. Open a web browser on your PC or phone (must be on the same Wi-Fi network).
  2. Go to the exact URL shown on your screen’s Settings tab under URL: (By default, it will be http://u1-display-XXXX.local, where XXXX is the last 4 digits of your screen’s MAC address).
  3. Go to the Hardware Diags tab to customize your screen!

🖨️ How the “Print” Tab Works

To use the Print tab effectively, you must have a MicroSD card inserted into the CYD screen.

When you select a file and turn on custom options (like Advanced Tool Mapping), the ESP32 downloads the gcode from Klipper, modifies the file on the local SD card in a folder called dump_zone, and then pushes the patched file back to the printer to launch it.

Without an SD card, the screen has nowhere to store the temporary files while it works!


💻 Compiling from Source (For Developers)

If you want to tweak the UI, change colors, or add features:

  1. Clone this repo.
  2. Open the folder in VS Code with the PlatformIO extension installed.
  3. The platformio.ini is already set up with multiple environments (cyd_28, cyd_28_dual_usb, cyd_40).
  4. Set your default environment at the top of the .ini file.
  5. Make your changes in src/main.cpp and hit the PlatformIO Upload button.

Note: If you mess up your touch calibration while developing, just go to the Settings tab and hit the “Calibrate” button to wipe it and start over.