Get started in 30 seconds
Detect the display, push text, flip orientation, and loop updates on either size.
Install
brew install just
just build
./display-fs show "Hello"
0.96" quick hits
./display-fs show --auto "Status OK"
./display-fs show --detect
./display-fs preset clock --loop
3.5" examples
./display-fs show --model large \
--baud-rate 1152000 --auto "Studio"
./display-fs spotify --model large \
--baud-rate 1152000 --loop
Japanese/CJK
just build-jp
just install-jp
./display-fs show "東京"
Orientation + flip
./display-fs show --orientation portrait \
--flip "Tall text"
./display-fs show --model large \
--orientation landscape
Hardware notes
Both Display FS V1 panels use USB 2.0 Full Speed CDC and RGB565.
0.96" display
80×160 RGB565 over CH340/CH341 @ 115200 baud.
3.5" display
320×480 RGB565 over USB CDC @ 1,152,000 baud.
Sensors
3.5" model includes humidity + temperature telemetry.
What you can display
Built-in presets for system stats, Spotify now-playing, and auto-fit text on both sizes.
Auto-fit text
Largest readable type on 160×80 or 320×480 canvases, automatically.
Orientation + flip
Portrait or landscape, with 180° rotation for inverted installs.
Presets
Clock, CPU, memory, git status, IP, and more on a loop.
Spotify (macOS)
Live now-playing with smooth refresh on either panel.
Model overrides
Force `--model small|large` and override baud when detection is ambiguous.
More details in the README
Full CLI reference, examples, and build options are in the repo documentation.