🐧 Turing Smart Screen — Linux Edition

Versión mejorada para Linux / Ubuntu · por pilahito

Monitor de sistema en mini pantalla USB Turing (3.5", 5", 8.8"…) con instalación en un comando,
41+ temas, menú en el Escritorio, autostart, FPS, ventiladores CPU/GPU y galería visual.

📖 Guía Linux completa · ⬇️ Releases · 🔧 Changelog Linux

---

¿Por qué esta versión?

Fork mantenido de mathoudebine/turing-smart-screen-python (GPL-3.0) con mejoras pensadas para uso real en Linux:

Mejora	Descripción
Instalador Ubuntu	./scripts/install-ubuntu.sh — venv, dialout, tema, autostart
Menú interactivo	Escritorio + turing-menu.sh — temas, galería, reinicio, log
Autostart	systemd user + .desktop — Cinnamon, GNOME, MATE, XFCE
41+ temas 3.5"	Incluidos + comunidad (RedLineGraphs, CpuGpuStatsMono…)
Tema estable	Cyberdeck por defecto (landscape 3.5" probado) · Pilahito = variante cyan
Galería HTML	Previews en el navegador antes de elegir tema
Pantalla virtual	Ver la mini pantalla en tu monitor (modo SIMU + espejo)
FPS en Linux	turing-fps.service — Hz del monitor o MangoHud
Ventiladores	Gigabyte B760 (it87) + NVIDIA vía nvidia-smi
USB QinHeng	Detección /dev/ttyACM* (1a86:5722)

Instalación rápida

git clone https://github.com/pilahito/turing-smart-screen-linux.git
cd turing-smart-screen-linux
./scripts/install-ubuntu.sh

Menú en el Escritorio: ./scripts/install-desktop-menu.sh

Capturas de temas

Ver todos los temas →

---

Note

Proyecto base: este repo incluye el código completo de turing-smart-screen-python más scripts y documentación Linux.
No está afiliado a Turing / XuanFang / Kipye. Ver avisos legales abajo.

📚 Documentación original del proyecto upstream (Windows, macOS, API, wiki…)

turing-smart-screen-python (upstream)

[!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

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+

✅ Supported smart screens models:

✅ 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)

> What is my smart screen model?

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!

How to start

> Follow instructions on the wiki to configure and start this project.

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.

System monitor

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!

> Configure and start system monitor

• Fully functional multi-OS code base (operates out of the box, tested on Windows, Linux & MacOS).
• Display configuration using GUI configuration wizard or config.yaml file: 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) with theme.yaml files 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.

> List and preview of included themes

> Themes creation/edition (using theme editor)

> Control the display from your code

Avisos

Este software es una alternativa open-source basada en turing-smart-screen-python (GPL-3.0).
No está afiliado a Turing, XuanFang, Kipye ni a sus fabricantes.
Para hardware Turing: foro oficial.

Autor Linux Edition

David / pilahito — scripts, menú, autostart, temas y documentación para Ubuntu/Debian.