360 Secure SkillHub
360 安全技能中心

Ulanzi TC001

使用 Python 脚本向 Ulanzi TC001 像素时钟的本地 HTTP 接口发送表单请求，查询设备状态，并管理亮度、夜间模式、时区、切换速度、滚动速度以及各类小组件开关等设置。设备地址取自 config.json 或 TC001_HOST 环境变量。

felipeouropreto
felipeouropreto
热度 62.31
最近更新 2026-05-17 12:14:35
分类：自动化依赖：代码执行 / 第三方 API / 读写文件应用场景：自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add ulanzi-tc001
Metadata
name
ulanzi-tc001
description
Control the Ulanzi TC001 (Pixel Clock) over local HTTP. Use to list tc1/tc001 commands, read status, enable/disable gadgets (time/date/youtube/matrix/etc.), or change settings like brightness, night mode, timezone, switch speed, or scroll speed. Trigger on commands starting with “tc1” or “tc001”.

Ulanzi TC001

Control the Ulanzi TC001 Pixel Clock using its local HTTP endpoints (no browser needed).

Quick start

  1. Set the device IP in config.json (preferred):
{ "host": "192.168.1.32" }

(Env fallback is supported: TC001_HOST)

  1. Use the helper script:
python3 scripts/tc001.py status
python3 scripts/tc001.py gadgets list
python3 scripts/tc001.py gadget on youtube
python3 scripts/tc001.py brightness manual 80
python3 scripts/tc001.py nightmode on
python3 scripts/tc001.py timezone GMT-3

Supported commands (script)

  • status → JSON summary (sys settings + gadgets on/off)
  • gadgets list|on|off
  • gadget on|off <name>
  • brightness auto | manual <0-100>
  • nightmode on|off | start HH:MM | end HH:MM
  • timezone GMT-3 | AUTO (see mapping in script)
  • switch <10|15|20|25|30|35|40|45|50|55|60|noswitch>
  • scroll <0-10>

Full config (sys)

sys <field> <value> fields:

  • language: english|chinese
  • autobrightness: auto|manual
  • brightness: 0-100
  • nightbrightness: 0-100
  • switchspeed: noswitch|10|15|20|25|30|35|40|45|50|55|60
  • scrollspeed: 0-10
  • timezone: GMT-3 (or AUTO)
  • timeformat: HH:mm|HH:mm:ss
  • dateformat: DD/MM|MM/DD
  • showweek: show|hide
  • firstday: sunday|monday
  • nightmode: on|off
  • nightstart: HH:MM
  • nightend: HH:MM

Full config (app)

app <field> <value> fields:

  • citycode
  • bilibili_uid / bilibili_animation / bilibili_color / bilibili_format
  • weibo_uid / weibo_animation / weibo_color / weibo_format
  • youtube_uid / youtube_apikey / youtube_animation / youtube_color / youtube_format
  • douyin_uid / douyin_animation / douyin_color / douyin_format
  • awtrix_server / awtrix_port
  • showlocalip: on|off

Animations: swipe|scroll · Colors: default|red|orange|yellow|green|cyan|blue|purple · Format: none|format

Gadgets (names)

time, date, weather, bilibili, weibo, youtube, douyin, scoreboard, chronograph, tomato, battery, matrix, awtrix, localip

Notes

  • Uses POST / and POST /app_switch with form data. See references/tc001-api.md.
  • Keep YouTube API key private (if used).