登录

turing-smart-screen-python

mathoudebineGPL-3.0活跃维护

用 Python 驱动 Turing Smart Screen、TURZX 等小型 USB-C IPS 副屏，实时显示 CPU、内存、温度等系统监控数据。

Unofficial Python system monitor and library for small IPS USB-C displays like Turing Smart Screen / TURZX

3.10.0发布于 2026-04-12 21:54 UTC2,343star +1 / 7 天436fork同步于 2026-11-10 05:43 UTC
系统监控副屏显示串口通信Python 库硬件监控
对比 GitHub 官网lcd-displaypythonserial-communicationsmart-displaysmart-screen

怎么上手

README 里没有找到可直接复制的安装命令
原文

README 里没有找到可直接复制的安装命令，请到 README 或官方文档查看安装方式。

硬件要求

README 没有说明硬件要求。

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

这个项目的说明还在生成中，先参考下面「最近发版」和 README。

最近发版

5 个版本3.10.0
全部 release
  1. 3.10.03.10.0 - 🚀 New TURZX models support最新正式版2026-04-12 · 2026-04-12 21:54 UTC

    [!IMPORTANT] Getting anti-virus alerts for this program? Click here to know more: https://github.com/mathoudebine/turing-smart-screen-python/wiki/Troubleshooting#windows-installer--portable-zip-are-flagged-by-my-anti-virus

    🚀 New TURZX models support!

    This release brings the long-awaited support for the new Turing / TURZX models. These new models work differently as they do not communicate using a virtual serial port but using USB. They require libusb-1.0 library which should be already installed in Linux distributions, can be installed with brew on macOS, and is bundled in Windows installers.

    • TURZX 4.6" (960x320) - tested by @smandon
    • TURZX 5.2" (1280x720) - tested by @mathoudebine
    • TURZX 8" (1280x800) - tested by @mathoudebine
    • TURZX 8.8" (1920x480) - tested by @mathoudebine
    • TURZX 9.2" (1920x462) - tested by @mathoudebine
    • TURZX 12.3" (1920x720) - not tested but should work

    [!NOTE] 9.2" models have a 1920x462 resolution, but in this program they will use the themes made for the 8.8" model (1920x480) that will be slightly cropped. This is to avoid developing themes for the 2 models separately. It is the same in TURZX main program.

    Many thanks to the everyone who helped, especially the following contributors:

    • @phstudy who decoded the new USB protocol and implemented https://github.com/phstudy/turing-smart-screen-cli a command-line interface tool for controlling the new TURZX USB models
    • @drivin who fixed the issue with the 1MB frame limit by implementing PNG-to-JPEG compression with its PR #950
    • @smandon who added support for the 4.6" model and a theme for it

    Please report issues on GitHub as usual.

    🎨 Themes

    Some themes have been written for the new models (except the 12.3") or have been scaled from an existing theme with similar screen ratio: for example, all themes written for the 8" model (1280x800) and the 5.2" (1280x720) have been scaled from the original Turing 5" themes (800x480). A Python script res/themes/scale_theme.py is available if you want to do it for other themes of your own themes.

    python scale_theme.py theme.yaml output.yaml --from 480x800 --to 800x1280

    🖼️ New theme materials (backgrounds & renders) are available in res/themes/--Theme examples/ to help you get started.

    What's Changed

  2. 3.9.73.9.7 - New LibreHardwareMonitor with PawnIO and 2.8" Turing support2026-01-17 · 2026-01-17 12:51 UTC
    查看更新说明

    ⚠️ Getting anti-virus alerts for this program?

    Click here to know more: https://github.com/mathoudebine/turing-smart-screen-python/wiki/Troubleshooting#windows-installer--portable-zip-are-flagged-by-my-anti-virus

    ✅ New LibreHardwareMonitor library for Windows

    The LibreHardwareMonitor library used on Windows platforms to get hardware data has been updated to its latest official release https://github.com/LibreHardwareMonitor/LibreHardwareMonitor/releases/tag/v0.9.5

    This new version replaces the obsolete WinRing0 driver with the new open-source Pawn.IO driver, which fixes the issue #902

    ✨ Now supported: Turing 2.8" circular screens support

    The Turing 2.8" circular screens are now listed as supported! Because they use the same protocol and resolution as the 2.1" models, all existing 2.1" themes can be used.

    What's Changed

    Full Changelog: https://github.com/mathoudebine/turing-smart-screen-python/compare/3.9.6...3.9.7

  3. 3.9.63.9.6 - ✨ WeAct 0.96" and 3.5" support2025-10-27 · 2025-10-27 16:56 UTC
    查看更新说明

    ⚠️ Getting anti-virus alerts for this program?

    Click here to know more: https://github.com/mathoudebine/turing-smart-screen-python/wiki/Troubleshooting#windows-installer--portable-zip-are-flagged-by-my-anti-virus

    ✨ Now supported: WeAct Studio Display FS V1 0.96" and 3.5"

    This new release adds the support for two new screen models on all OS (Windows/Linux/MacOS):

    ✅ WeAct Studio Display FS V1 0.96"✅ WeAct Studio Display FS V1 3.5"

    The 3.5" model can use existing themes made for other 3.5" screens like Turing.

    For the 0.96 model, the 4 default themes from WeAct have been imported, and Theme Editor supports creating themes for it. You may need to use the zoom buttons in the Theme Editor preview window.

    What's Changed

    Full Changelog: https://github.com/mathoudebine/turing-smart-screen-python/compare/3.9.5...3.9.6

  4. 3.9.53.9.5 - 🏢 Weather city search, reset screen on startup2025-10-20 · 2025-10-20 21:32 UTC
    查看更新说明

    ⚠️ Having anti-virus alerts for this program?

    Click here to know more: https://github.com/mathoudebine/turing-smart-screen-python/wiki/Troubleshooting#windows-installer--portable-zip-are-flagged-by-my-anti-virus

    Weather city search (#823)

    Thanks to @rud01f, the configuration window now allows you to search for a city instead of manually entering the latitude/longitude.

    The results are pulled using openweathermap Geo API, and require entering valid API key. The search results are also selected language agnostic, resulting in localized country and state names.

    RESET_ON_STARTUP option (#828)

    A new option RESET_ON_STARTUP has appeared in config.yaml to solve issues with some 3.5" screens not being able to connect after a reset. By default it is set to true like it was in previous versions: screen is always reset when program starts unless explicitly told not to.

    Better max. fan speed assumption (#835)

    When using Python for hardware monitoring on Linux, maximum fan speed is sometimes unknown to the system. Previously, this limit was arbitrarily set to 1500 RPM. Thanks to @vsalvador, it is now dynamically set based on the current fan speed. Not a perfect solution but still better.

    Rev. C (Turing 2.1/5/8.8") asleep/awake detection fix (#873)

    On some Linux systems, a Turing screen can be detected as both sleeping and awake (2 serial ports listed). In this case, try to wake it up once then assume it is awake to avoid being stuck in a wake loop.

    What's Changed

  5. 3.9.33.9.3 - Fix for Turing 8.8" scrambled display2025-05-21 · 2025-05-21 17:15 UTC
    查看更新说明

    This release fixes the issue #724 with Turing Smart Screen 8.8" and ROM version > 88 Please not it is NOT the support for the newer Turing 8.8" screens with hardware revision V1.1 (issue still open: #727)

    What's Changed

    Full Changelog: https://github.com/mathoudebine/turing-smart-screen-python/compare/3.9.2...3.9.3

用户点评

登录用户的真实使用记录，可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译
    在 GitHub 打开

    Icon turing-smart-screen-python

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

    Linux Windows macOS Raspberry Pi Python Licence

    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.exeFront 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 lcd4linuxNot 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.

    > 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:

    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

    > List and preview of included themes

    ... view full list

    > Themes creation/edition (using theme editor)

    > Themes shared by the community

    and more... Share yours!

    Control the display from your Python projects

    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.

    > Control the display from your code

    Troubleshooting

    If you have trouble running the program as described in the wiki, please check open/closed issues & the wiki Troubleshooting page

    They're talking about it!

    Star History

    相关项目

    同分类里 star 最高的项目
    对比全部 →
    btop
    aristocratos·C++

    终端里的资源监控工具，实时显示 CPU、内存、磁盘、网络和进程占用，界面美观、操作顺手，适合在服务器或本地随时查看系统状态。

    系统监控+4系统监控
    35317+321.3kv1.4.82026-11-09 18:56 UTC
    vorssaint-utils
    vorssaint·Swift

    一款免费开源的 macOS 菜单栏工具箱，把窗口切换、应用卸载、访达增强、防休眠等常用小功能集中到菜单栏，省去装一堆零散工具。

    菜单栏工具+4系统监控
    33911+5061.7kv3.4.32026-11-10 03:38 UTC
    hyperfine
    sharkdp·Rust

    命令行基准测试工具，能对任意 shell 命令做多次运行统计，自动给出耗时分布和置信区间，方便比较不同实现的性能差异。

    基准测试+3系统监控
    29233+8641v2.0.02026-11-01 03:02 UTC
    systeminformer
    winsiderss·C

    一款免费强大的系统监控与调试工具，可实时查看进程、性能、网络等资源占用，还能辅助排查恶意软件。

    系统监控+4系统监控
    16460+221.8kv4.0.26241.1382026-11-10 03:36 UTC