Turn a ~$5 AliExpress clock into a physical AI usage dashboard (Claude, Codex, multi-account). No firmware flashing.
Clarify usage windows and clock-free customization from user questions
click6067-ship-itd19445d757e7
diff --git a/docs/hardware-compatibility.md b/docs/hardware-compatibility.mdindex 3f7a384..2ed508d 100644--- a/docs/hardware-compatibility.md+++ b/docs/hardware-compatibility.md@@ -7,7 +7,7 @@ not "probably fine".| Clock | Firmware web UI | What TokenTV uses | Checked || --- | --- | --- | --- |-| The author's 240×240 GeekMagic SmallTV-style Wi-Fi clock (bought on an AliExpress sale for about ₩6,000 / $5) | Stock firmware with the **SD_PRO** web UI and a photo album | `/theme/list`, `/photo/list`, `/photo/upload`, photo theme id `2` | One unit, Linux host |+| The author's 240×240 GeekMagic SmallTV-style Wi-Fi clock (receipt: ₩5,650 on a Korean AliExpress discount; prices vary by region) | Stock firmware with the **SD_PRO** web UI and a photo album | `/theme/list`, `/photo/list`, `/photo/upload`, photo theme id `2` | One unit, Linux host |TokenTV never flashes firmware and never deletes your photos. It uploads one picture, switches theclock to its photo theme, and `token-tv run --restore-display` puts the original theme back.diff --git a/docs/setup.ko.md b/docs/setup.ko.mdindex 6c61258..0b66d10 100644--- a/docs/setup.ko.md+++ b/docs/setup.ko.md@@ -9,7 +9,7 @@**AI 사용 한도를 작은 책상 시계에.** Claude와 Codex 사용량을 여러 계정으로, 시계 펌웨어를 바꾸지 않고 보여줍니다.-Grok은 CLI 예산 정보를 보여주는 실험적 기능입니다. 제작자의 시계는 할인가 약 6,000원(약 $5)에 샀으며 가격과 배송비는 다를 수 있습니다. 켜 두는 컴퓨터(호스트)가 필요합니다.+Grok은 CLI 예산 정보를 보여주는 실험적 기능입니다. 제작자의 시계 구매 영수증은 5,650원(한국 알리익스프레스 할인가)이며 가격은 지역마다 다릅니다. 다른 기기는 확인하지 않았습니다. 켜 두는 컴퓨터(호스트)가 필요합니다.240×240 책상 시계와 브라우저에서 확인하며, 계정별 인증 홈을 분리하고 실제 조회 실패와 오래된 값을 표시합니다.@@ -96,11 +96,19 @@ Grok이 한도 수치를 제공하지 않으면 `quota_unavailable`로 표시합이 과정은 도구를 끈 짧은 확인 응답 하나를 요청하므로 구독 사용량을 소량 소비할 수 있습니다.인증 파일의 토큰을 직접 수정하거나 다른 머신으로 복사하지 않습니다.+**5시간과 주간 중 무엇을 보여 주나요?** 둘 다 읽습니다. 시계는 사용률이 더 높은 쪽과 그 창의 리셋 시간을+보여 줍니다. 웹 대시보드도 같은 창을 먼저 보여 주고, 그 아래 다른 창 항목을 펼치면 나머지를 볼 수 있습니다.++**다른 화면(HYTE, Apple Watch)도 되나요?** 브라우저 대시보드는 있지만,+HYTE Y70 화면에서의 레이아웃은 시험하지 않았습니다. Apple Watch 앱은 현재 없습니다.+## 내 디자인 만들기-**동작하는 화면에서 시작하세요. 포크해서 바꾸고, 보여 주세요.** 시계 화면은 240×240을 그리는-Python 함수 하나입니다. [docs/clock-faces.md](clock-faces.md)를 따라 시계나 로그인 없이 샘플 데이터로-만들 수 있습니다. 내 포크에서 바로 실행되고, 대시보드 **Themes** 목록에 *Local*로 나타나 시계에 적용할 수 있습니다.+**동작하는 화면에서 시작하세요.** 시계·로그인·포크 없이 [Game Boy 예제](../examples/gameboy)를 실행하고+AI에게 바꿔 달라고 하면 됩니다. 시계 화면은 240×240을 그리는 Python 함수 하나이며,+[docs/clock-faces.md](clock-faces.md)를 따라 샘플 데이터로 만들 수 있습니다. 예제를 복사하거나 포크하는 것만으로는 등록되지 않습니다. 가이드대로 `RENDERERS`와 `STYLES`에 등록하면+대시보드 **Themes** 목록에 *Local*로 나타나 시계에 적용할 수 있습니다. 수정본은 로컬에 보관해도 되고,+GitHub에 보관하고 싶으면 포크하세요.다른 사람과 나누려면 *New clock face* 템플릿으로 PR을 보내 주세요. 공유된 화면은 다음 릴리스부터**Themes**에서 **Popular**(테마별 GitHub 이슈의 👍) 또는 **New** 순으로 보입니다. 좋아요는 릴리스 전에diff --git a/docs/setup.md b/docs/setup.mdindex e7239df..f04aac9 100644--- a/docs/setup.md+++ b/docs/setup.md@@ -33,10 +33,12 @@ GIF that the stock photo album plays; it is re-sent only when a number changes o## Make it yours-**Start with a working face. Fork it, change it, show us yours.** A face is one Python function-that draws 240×240 pixels; [docs/clock-faces.md](clock-faces.md) walks through it with sample-data, no clock or login needed. Your face runs from your own fork right away and shows up in the-dashboard's **Themes** list as *Local*.+**Start with a working face.** No clock, login or fork needed: run the+[Game Boy example](../examples/gameboy) and ask your AI to change it. A face is one Python function+that draws 240×240 pixels; [docs/clock-faces.md](clock-faces.md) walks through it with sample data.+Copying the example or forking does not register it: after you add it to `RENDERERS` and+`STYLES` as the guide shows, it appears in the dashboard's **Themes** list as *Local*. Keep your+copy locally, or fork if you want your version on GitHub.Want others to use it? Open a pull request with the *New clock face* template. Shared faces appear in**Themes** for everyone on the next release, sorted by **Popular** (👍 on each theme's GitHub issue)@@ -46,7 +48,8 @@ or **New**. Likes are counted by hand before releases, so the list says when the<summary><b>Hardware</b></summary>- A GeekMagic **SmallTV**-style 240×240 Wi-Fi clock whose stock firmware has a photo album page.- The author's cost ₩6,000 (about $5) on an AliExpress sale; prices vary.+ The author's receipt shows ₩5,650 (a Korean AliExpress discount); prices vary by region.+ No other device has been checked.- Any always-on machine on the same network with Python 3.10+ and the official CLIs you use.The stock photo API (`/theme/list`, `/photo/list`, `/photo/upload`) is verified on the author's@@ -67,6 +70,13 @@ Every login is checked against the email you configured. The clock gets only a pnever a password, token or cookie. Polling runs every five minutes; old readings say OLD andmissing data shows a dash, never a fake 0%. Claude accounts with `refresh_with_cli: true` mayrefresh an expired login through the CLI, which sends one tiny prompt.++**5-hour or weekly?** Both windows are read. The clock shows whichever is more used, with that+window's reset time. The web dashboard shows the same window first; open the other windows+under it to see the rest.++**Other screens (HYTE, Apple Watch)?** There is a browser dashboard,+but its layout on a HYTE Y70 display has not been tested. There is no Apple Watch app.</details><details>