Skip to content

Repository files navigation

PixDeck Plus — Ulanzi TC002 像素时钟控制台(成品分发包)

无需安装 Python,解压即用。 这是 PixDeck(作者 cailurus)的增强版成品包:在独占模式Android APK系统托盘触屏支持生命游戏插件等增强基础上,打包成 Windows 可执行程序 + 安卓 App。

English README · 简体中文

屏幕 License


这是什么

PixDeck 是一个跑在电脑/手机上的本地网页应用,通过官方固件自带的 Custom App HTTP 协议把实时数据、小游戏、氛围动效推送到 Ulanzi TC002 像素时钟(52×16 RGB 点阵,832 像素)——无需刷机

本仓库发布的是打包好的成品

  • Windows:双击 PixDeck.exe 常驻系统托盘,浏览器打开 http://127.0.0.1:8000 控制
  • Android:安装 APK,打开即全屏控制台(触屏可用,设备 IP 自动记忆)

内置 20+ 插件:行情、天气、系统监控、贪吃蛇、吃豆人、落沙、星空、生命游戏等。

特性

  • 🖥️ 无需 Python 环境:PyInstaller 打包(Windows)与 Chaquopy 打包(Android),开箱即用
  • 🔒 独占模式:打开新效果自动关闭旧效果,时钟同一时刻只显示一个效果
  • 🎛️ 系统托盘常驻(Windows):右键托盘图标 → 「打开控制台网页」/「退出」
  • 📱 Android APK:全屏 WebView,触屏画板跟手,设备 IP 记忆(填一次即可)
  • 🏷️ 网页标签图标:像素时钟风格 favicon
  • 🧬 生命游戏插件:重生特效、循环检测、11 种配色、速度可调
  • 🧩 插件可扩展:往 plugins/ 目录丢一个插件文件夹即可自动发现
  • 🌐 HTTP / MQTT 双推送:帧格式一致,可接 Home Assistant 等智能家居
  • 🐍 纯 Python 标准库实现(源码模式零依赖)

快速开始

Windows

  1. 前往 Releases 页面 下载 PixDeck-v1.4-win64.zip 并解压
  2. 双击 PixDeck.exe —— 右下角系统托盘出现像素时钟图标(无窗口,静默运行)
  3. 右键托盘图标 → 「打开控制台网页」,浏览器打开 http://127.0.0.1:8000
  4. 点齿轮图标填入你的 TC002 时钟 IP(与电脑同一 Wi-Fi),开始推送

关闭:右键托盘图标 → 「退出」;再次运行:再双击 PixDeck.exe

Android

  1. 下载 PixDeck-Plus-Android-v1.4.apk 并安装(需允许"安装未知应用")
  2. 打开 App,等待"正在启动服务"结束,进入全屏控制台
  3. 齿轮填入 TC002 时钟 IP(同一 Wi-Fi),只需填一次,重启自动恢复
  4. ⚠️ 后台运行:请将 App 设为后台锁定/不受电池优化限制(各品牌路径见 android/README.md),否则服务可能被系统回收

📜 版本历史

每个版本的主要变动,快速了解更新内容。

版本 主要新增/变动
v1.4 📈 股价看板数据源改为新浪财经(国内直连免费);新增长鑫科技 CXMT(688825.SH) 轮播;美股+A股混合解析;自绘 CXMT 像素 logo
v1.3 🔒 独占模式(开新效果自动关旧效果);🤖 Android APK(全屏 WebView + 触屏 + IP 记忆);触屏画板修复
v1.2 🎛️ 系统托盘常驻;🏷️ 网页 favicon;🧬 生命游戏插件;exe 打包(无需 Python)

详细版本说明见各 Release

目录结构

PixDeck/
├── PixDeck.exe          ← 主程序(双击运行)
├── _internal/           ← Python 运行时(勿动)
├── web/dist/            ← 网页前端
└── plugins/             ← 插件(可增删/自定义)
    └── 你的插件/plugin.py   ← 放入即自动发现

🧬 生命游戏插件(本仓库新增)

康威生命游戏,52×16 元胞自动机,位于网页 视觉 分类:

  • 规则:活细胞恰好 2/3 个活邻居存活;死细胞恰好 3 个活邻居复活
  • 重生特效:生命全部死亡、或陷入循环重复 30 步、或单局满 4 分钟时,不突然切换——先淡出消散,再随机点亮新一局(约 2 秒)
  • 齿轮选项
选项 说明
初始生命密度(%) 1~100,控制开局活细胞数量
演化速度 慢(0.4s/代) / 标准(0.25s/代) / 快(0.12s/代) / 极快(0.06s/代)
颜色 4 种渐变组合(光阴/火焰/海洋/彩虹,按细胞存活年龄变色)+ 7 种单色

与上游 PixDeck 的差异

改动 说明
独占模式 打开新效果自动关闭旧效果(/api/toggle 后端统一实现)
Android APK 新增 android/ 工程(Chaquopy),全屏 WebView + 触屏支持 + IP 记忆
触屏画板修复 CanvasStage.vue 坐标按显示缩放换算,触摸落笔跟手
系统托盘常驻 新增 pixbar_tray.py(pystray),托盘菜单:打开网页 / 退出
exe 路径适配 pixbar_panel.py 打包后从 exe 目录查找 web/plugins/配置
端口占用提示 已有实例运行时弹出提示,避免静默失败
网页 favicon web/dist/ 增加像素时钟图标(favicon.png + <link>
生命游戏插件 新增 plugins/gameoflife/plugin.py(本仓库主打新功能)
股价看板升级 plugins/stock/plugin.py 数据源改为新浪财经(国内直连免费),支持美股+A股混合,新增长鑫科技 CXMT 轮播与自绘品牌蓝 logo

仓库结构

├── README.md / README.en.md    # 双语说明
├── RELEASE_NOTES_v1.3.md       # 版本说明
├── source/                     # 修改/新增的 Python 源码
│   ├── pixbar_panel.py / pixbar_tray.py / pixbar_core.py / pixbar_mqtt.py
│   ├── plugins/gameoflife/plugin.py
│   ├── plugins/stock/plugin.py + assets/cxmt1.png
│   └── make_*.py / test_gol.py
└── android/                    # 安卓工程源码(Chaquopy + Kotlin + Python)
    ├── app/src/main/java/...   # MainActivity(全屏 WebView)
    └── app/src/main/python/    # Python 运行时 + 插件 + 前端

致谢

  • 本项目的上游是 PixDeck,作者 cailurus(More Zhou)。感谢他开源了这个无需刷机、纯标准库实现的优秀项目,以及他对 TC002 官方固件 Custom App 协议的逆向整理。上游采用 GPL-3.0 许可。
  • 本仓库在遵循上游许可的前提下进行增强与打包。

Contributors / 贡献者

贡献者 角色
cailurus 上游 PixDeck 作者(基础框架与协议)
deepseek-ai 增强功能开发(独占模式、安卓版、生命游戏、托盘、触屏适配、打包与测试)——经 DeepSeek Harness(DSH) 协助生成

说明:deepseek-ai 为组织账号,GitHub 不支持将组织添加为仓库协作者,故在本文档中署名致谢。

关于 DSH

本项目的增强开发(独占模式、安卓版、生命游戏插件、托盘、触屏适配、打包与测试)由 DeepSeek Harness(DSH) 协助完成。DSH 是一个 AI 智能体运行环境,在用户需求驱动下生成、修改并验证代码。

开源许可

本项目基于 GNU General Public License v3.0(GPL-3.0) 发布,与上游 PixDeck 一致。


与 Ulanzi 官方无关联的个人/学习项目。使用风险自负。

About

Ulanzi TC002 像素时钟控制台增强版:Windows 成品包 + 安卓 APK,独占模式、生命游戏插件、触屏支持、设备 IP 记忆,无需刷机。基于 cailurus/PixDeck(GPL-3.0)

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages