Skip to content

Turn a ~$5 AliExpress clock into a physical AI usage dashboard (Claude, Codex, multi-account). No firmware flashing.

Make the clock-free face customization path visible

click6067-ship-itc467f9ea04c8
diff --git a/README.ko.md b/README.ko.md
index b8063d4..014df81 100644
--- a/README.ko.md
+++ b/README.ko.md
@@ -6,5 +6,7 @@
약 5달러 Wi-Fi 책상 시계에 Claude·Codex 사용 한도를 띄웁니다. 펌웨어는 그대로예요.
**구경하기:** [라이브 데모](https://token-tv.vercel.app) 또는 `npx github:click6067-ship-it/token-tv demo`, 시계·로그인 없이 바로.
**설치하기:** 이 저장소를 AI에게 주고 *"TokenTV 설정해줘"* 라고 하세요. AI는 [AGENTS.md](AGENTS.md)를 따릅니다.
-**내 화면 만들기:** 포크한 뒤 AI에게 화면 하나 바꿔 달라고 하세요. [가이드](docs/clock-faces.md)
+**내 화면 만들기:** 시계 없이 [Game Boy 예제](examples/gameboy)에서 시작해 AI에게 바꿔 달라고 하세요. [가이드](docs/clock-faces.md) · [공유하기](https://github.com/click6067-ship-it/token-tv/issues/new?template=share_a_face.md)
자세히: [설정](docs/setup.ko.md) · [호환 시계](docs/hardware-compatibility.md) · MIT · [English](README.md)
+
+<p align="center"><a href="examples/gameboy"><img src="examples/gameboy/comparison.png" width="640" alt="내 화면 만들기: 같은 샘플 사용량으로 그린 원래 픽셀 화면과 4색 Game Boy 예제"></a></p>
diff --git a/README.md b/README.md
index 635b737..1adfe59 100644
--- a/README.md
+++ b/README.md
@@ -6,5 +6,7 @@
Your Claude and Codex usage limits on a ~$5 Wi-Fi desk clock. No firmware flashing.
**Try it:** [live demo](https://token-tv.vercel.app) or `npx github:click6067-ship-it/token-tv demo`, no clock or login needed.
**Set it up:** give this repo to your AI and say *"Set up TokenTV for me."* It follows [AGENTS.md](AGENTS.md).
-**Make your own face:** fork, then ask your AI to change one. [Guide](docs/clock-faces.md) · [Share it](https://github.com/click6067-ship-it/token-tv/issues/new?template=share_a_face.md)
+**Make your own face:** no clock needed, start from the [Game Boy example](examples/gameboy) and ask your AI to change it. [Guide](docs/clock-faces.md) · [Share it](https://github.com/click6067-ship-it/token-tv/issues/new?template=share_a_face.md)
Details: [setup](docs/setup.md) · [compatible clocks](docs/hardware-compatibility.md) · MIT · [한국어](README.ko.md)
+
+<p align="center"><a href="examples/gameboy"><img src="examples/gameboy/comparison.png" width="640" alt="Change a face: original pixel style and a four-colour Game Boy example, rendered from the same sample readings"></a></p>
diff --git a/examples/gameboy/README.md b/examples/gameboy/README.md
index 11d794d..bbc6545 100644
--- a/examples/gameboy/README.md
+++ b/examples/gameboy/README.md
@@ -11,12 +11,26 @@ This is a separate example. It is **not** registered as a product theme and was
The first two images use the same sample: Claude A 25% (5H, 3h 41m), Codex A 72% (WK, 2d 6h), Grok A 94% (BUD, 12d 3h).
The third image marks Codex as an old reading and gives Grok no data.
-## Run
+## Run it (no clock, no login, no fork)
+
+Checked on Linux (2026-10-04). Python 3.10+.
```bash
-PYTHONPATH=. python3 examples/gameboy/gameboy.py
+git clone https://github.com/click6067-ship-it/token-tv && cd token-tv
+python3 -m venv .venv && .venv/bin/pip install -e .
+.venv/bin/python examples/gameboy/gameboy.py # writes before.png, after.png, after-old-unknown.png here
```
+## Make your own in three steps
+
+1. Copy the folder (commands below were checked on Linux):
+ `.venv/bin/python -c "import shutil; shutil.copytree('examples/gameboy', 'examples/my-face')"`
+2. In `examples/my-face/gameboy.py`, change the four colours on the line `DARKEST, DARK, LIGHT, LIGHTEST = ...`
+ (or ask your AI for a different look).
+3. Run `.venv/bin/python examples/my-face/gameboy.py` and open `examples/my-face/after.png` (240×240).
+
+Want to keep it on GitHub? Fork the repository and commit your folder. Want others to see it? [Share a face](https://github.com/click6067-ship-it/token-tv/issues/new?template=share_a_face.md).
+
## What the face does
- Four LCD shades only (`#0f380f #306230 #8bac0f #9bbc0f`). The final image is snapped to those four.