Files
cleanyourtv/docs/workflows/theme.md
T
simandClaude Opus 5.5 5865347dfc docs: AGENTS.md's recipes move to docs/workflows/, word for word
Each recipe becomes its own workflow file with a "When to use this" line and the test command at
the end, as perf-ab.md does; AGENTS.md's Workflows section lists them all. Links into the old
recipe anchors point at the new files. tests/test_agents_md.py now checks the paths each workflow
names and that every workflow has its line in AGENTS.md.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-23 13:43:21 +10:00

875 B

Workflow: Add a theme

When to use this: a new look that the keys in themes/README.md already carry.

  1. Create themes/<name>/config.json using only keys from the table in themes/README.md; themes/default/config.json is the starting point.
  2. Add wallpaper.jpg or a wallpapers/ folder if it uses them: dark, 1920x1080, under about 300 KB each, and art you have the right to use.
  3. Push it to a real TV with tools/theme.sh themes/<name> and take screenshot.jpg of Home with the focus on the dock: a JPEG at 1280x720 (16:9), at most 300 KB. Not a mock-up, not an emulator. tests/test_themes.py fails without it.
  4. Add a row to the table in themes/README.md showing the screenshot, like the others.
  5. A look that needs a new key is a launcher switch first, in its own PR.

Then run the tests: python3 -m unittest discover -s tests -v.