Warning
This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Turing / XuanFang / Kipye brands, or any of theirs subsidiaries, affiliates, manufacturers or sellers of their products. All product and company names are the registered trademarks of their original owners.
This project is an open-source alternative software, NOT the original software provided for the smart screens. Please do not open issues for USBMonitor.exe/ExtendScreen.exe or for the smart screens hardware here.
- for Turing Smart Screen, use the official forum here: http://discuz.turzx.com/
- for other smart screens, contact your reseller
Note
This fork adds a multi-page display platform on top of the stock project — everything is purely additive (no upstream files modified) and documented in DISPLAY.md:
- 🎠 Page carousel — rotate YAML-defined stat pages (live-reloaded, per-page dwell/refresh)
- ⚡ Diff-based partial rendering — only changed bands cross the serial link; in-page value ticks are wipe-free and CPU/RAM stays tiny (~1% of one core, ~30 MB)
- 🗺️ Animated network map — hosts up/down as a star topology, packet dots on spokes with live traffic
- 📊 Widgets:
bar,metric,radial(traces existing theme ring art — works great over the stock Cyberdeck background),text,graph(multi-series history),cores(per-core mini-bars) - 🔌 Pluggable data sources — local psutil values plus named sources (Prometheus implemented), so pages can show Kubernetes, fleet, or any scraped metric next to host stats
- 🌙 Extras: backlight night/away schedule, serial auto-reconnect, net rates with auto units, RAPL CPU watts, systemd unit
Quick start: venv/bin/python display.py with display.yaml (mode: standard runs the stock
engine untouched). Proposed upstream in
mathoudebine/turing-smart-screen-python#1011.
Everything below this block is the original upstream README.
-000000?style=for-the-badge&logo=apple&logoColor=white){kind=icon}
A Python system monitor program and an abstraction library for small IPS USB-C displays.
Supported operating systems : macOS, Windows, Linux (incl. Raspberry Pi), basically all OS that support Python 3.9+
| ✅ Turing Smart Screen / TURZX |
|---|
      |
| All available sizes and hardware revisions supported: 2.1" / 2.8" / 3.5" / 4.6" / 5" / 5.2" / 8.0" / 8.8" / 9.2" / 12.3" UART and USB protocols supported. Note: no video or storage support for now |
| ✅ XuanFang 3.5" | ✅ UsbPCMonitor 3.5" / 5" | ✅ Kipye Qiye Smart Display 3.5" |
|---|---|---|
 |
 |
 |
| revision B & flagship (with backplate & RGB LEDs) | Unknown manufacturer, visually similar to Turing 3.5" / 5". Original software is UsbPCMonitor.exe |
Front panel has an engraved inscription "奇叶智显" Qiye Zhixian (Qiye Smart Display) |
| ✅ WeAct Studio Display FS V1 0.96" | ✅ WeAct Studio Display FS V1 3.5" |
|---|---|
 |
 |
| ❔ AIDA64 / AX206 / USB2LCD... | ❔ ACEMAGIC S1 Mini PC - integrated 1,9″ display |
|---|---|
   |
 |
| Not supported for now. Produced by multiple manufacturers, all use the same Appotech AX206 hacked photo frame firmware. Supported by AIDA64 and lcd4linux | Not supported for now but could be integrated: protocol has been decoded, see here. |
| ❔ NXElec BeadaPanel 3/4/5/6/7 |
|---|
   |
| Not supported for now but could be integrated: Pankel-Link V1.0 Protocol Specification / Status-Link V1.1 Protocol Specification. |
| ❌ Waveshare 2.1inch / 2.8inch / 5inch / 7inch USB-Monitor | ❌ GUITION Smart screen 3.5" |
|---|---|
 |
 |
| Sold on Waveshare shop or Aliexpress. Managed by proprietary Windows software "Waveshare PC Monitor". Cannot be supported by this project: needs a firmware. | Managed by proprietary Windows software "GUITION Smart screen". Cannot be supported by this project: see here. |
| ❌ (Fuldho?) 3.5" IPS Screen |
|---|
 |
Managed by proprietary Windows software SmartMonitor.exe. Cannot be supported by this project: see here. |
Please note all listed smart screens are different products designed and produced by different companies, despite having a similar appearance. Their communication protocol is also different.
This project offers an abstraction layer to manage all of these products in a unified way, including some product-specific features like backplate RGB LEDs for available models!
If you haven't received your screen yet but want to start developing your theme now, you can use the "simulated LCD" mode!
There are 2 possible uses of this project Python code:
- as a System Monitor, a standalone program working with themes to display your computer HW info and custom data in an elegant way. Check if your hardware is supported.
- integrated in your project, to fully control the display from your own Python code.
This project is mainly a complete standalone program to use your screen as a system monitor, like the original vendor app.
Some themes are already included for a quick start!
- Fully functional multi-OS code base (operates out of the box, tested on Windows, Linux & MacOS).
- Display configuration using GUI configuration wizard or
config.yamlfile: no Python code to edit. - Compatible with multiple smart screen models (Turing, XuanFang...). Backplate RGB LEDs are also supported for available models!
- Support multiple hardware sensors and metrics (CPU/GPU usage, temperatures, memory, disks, etc) with configurable refresh intervals.
- Allow creation of themes (see
res/themes) withtheme.yamlfiles using theme editor to be shared with the community! - Easy to expand: custom Python data sources can be written to pull specific information and display it on themes like any other sensor.
- Auto-detect COM port based on the selected smart screen model.
- Tray icon with Exit option, useful when the program is running in background.
... view full list
and more... Share yours!
If you don't want to use your screen for system monitoring, you can just use this project as a module from any Python code to do some simple operations on the display:
- Display custom picture
- Display text
- Display horizontal / radial progress bar
- Screen rotation
- Clear the screen (blank)
- Turn the screen on/off
- Display soft reset
- Set brightness
- Set backplate RGB LEDs color (on supported hardware rev.)
This project will act as an abstraction library to handle specific protocols and capabilities of each supported smart screen models in a transparent way for the user.
Check simple-program.py as an example.
If you have trouble running the program as described in the wiki, please check open/closed issues & the wiki Troubleshooting page