CheapSpoolDisplay

Version …

A versatile NFC scanner for 3D printer filament spools

CheapSpoolDisplay is a versatile firmware for the ESP32 Cheap Yellow Display (CYD) supporting multiple tag standards (OpenSpool, OpenPrintTag, OpenTag3D, Snapmaker, Bambu Lab). It allows you to scan, view, and organize your 3D printer filament spools using standardized formats. It also serves as an external filament scanner for the SnapmakerU1-Extended-Firmware.

Multiple Tag Standards Scans and writes OpenSpool, OpenPrintTag, and OpenTag3D. Reads proprietary Snapmaker and Bambu Lab tags.

Visual Interface Modern UI powered by LVGL to display Brand, Filament, Material, Color, and Weight.

Spoolman Integration Browse and load spools directly from your Spoolman inventory.

Printer Integration Directly load spools to Snapmaker U1 or trigger custom Webhooks.

Quick Setup Guide

Connect your CYD to this computer via USB.
Click Connect & Flash Device to push the firmware.
Once complete, click Logs & Console in the installer window to open the console and configure:
- set wifi <ssid> <password> to configure your wireless network
- set tag_format <openspool|opentag3d|openprinttag|ask> to set default writing format
- set bambu_salt <hex_string> to enable Bambu Lab tag support
- set spoolman <url> to enable Spoolman enrichment
- set u1_host <ip> to enable Snapmaker U1 integration
- set webhook <url> to set your webhook URL
- set tools <1-16> to set the number of tools (default 1 or 4 if u1_host is set)
- set display_timeout <seconds> screen auto-off time (0 = always on)
- set sleep_timeout <seconds> idle time before deep sleep
- set power_mode <0|1|2> (0=Always On, 1=Deep Sleep, 2=Smart USB)
Type get config anytime to verify your settings.

Need more help? Check out our Full Documentation.