Ulanzi TC001

v1.0.3

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.),...

0· 733· 4 versions· 0 current· 0 all-time· Updated 5h ago· MIT-0
byFelipe Ouro Preto@felipeouropreto

Install

openclaw skills install ulanzi-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).

Version tags

latestvk972gc6wr3tgg5r08ekp8qpgcn81ee6h