ulanzi-tc001

TotalClaw 作者 totalclaw

通过本地 HTTP 控制 Ulanzi TC001（像素时钟）。用于列出 tc1/tc001 命令、读取状态、启用/禁用小工具（时间/日期/youtube/矩阵/等），或更改亮度、夜间模式、时区、开关速度或滚动速度等设置。在以“tc1”或“tc001”开头的命令上触发。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~felipeouropreto-ulanzi-tc001

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~felipeouropreto-ulanzi-tc001/file -o felipeouropreto-ulanzi-tc001.md

## 概述（中文）

通过本地 HTTP 控制 Ulanzi TC001（像素时钟）。用于列出 tc1/tc001 命令、读取状态、启用/禁用小工具（时间/日期/youtube/矩阵/等），或更改亮度、夜间模式、时区、开关速度或滚动速度等设置。在以“tc1”或“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):
```json
{ "host": "192.168.1.32" }
```

(Env fallback is supported: `TC001_HOST`)

2) Use the helper script:
```bash
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).