ulanzi-tc001
v1.0.3Control 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”.
Installation
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)
2) 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|offgadget on|off <name>brightness auto | manual <0-100>nightmode on|off | start HH:MM | end HH:MMtimezone 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 /andPOST /app_switchwith form data. Seereferences/tc001-api.md. - Keep YouTube API key private (if used).