Repository navigation
OmarchyTV 2.21 in 68 seconds (with music):
OmarchyTV-2.21.mp4
What's new in OmarchyTV 2.21
OmarchyTV becomes the screen of your agents and dashboards. Here is what you can try in five minutes. Every
command runs on your paired Omarchy PC. On the TV, turn on Settings › Grok Bot & AI › AI agent alerts while you watch for
notifications and questions.
Your agents talk to you on the TV
omarchy-link notify "Tests green" --from "Claude Code" # waits while a film plays
omarchy-link notify --level alert --title Deploy "prod is down" # shows at once
omarchy-link ask "Merge the PR?" --choice Merge --choice Wait # you answer with the remote
claude mcp add omarchytv -- omarchy-link mcp # Claude Code gets every TV toolomarchy-link watch -- make release # ✓ / ✗ on the TV when it ends
omarchy-link notify --level alert --speak "prod is down" # with a chime, read aloudHermes Agent: one mcp_servers entry and a skill (examples/hermes.md). Ready-made hooks for
Claude Code and Codex, a GitHub Actions job that tells the TV when CI fails, Home Assistant
(doorbell → camera full screen, alert spoken aloud) and a dashboard page are in examples/.
Approve from the couch
omarchy-link agents approvals on # Claude Code's "Allow this?" goes to the TV firstAllow, Deny or On the PC, with the remote. No answer means Claude Code asks as usual: nothing is allowed by itself.
Your PC talks to the TV
omarchy-link hook add all # PC is up, Omarchy updated, battery low (spoken), font, theme
omarchy-link remind 20m "Pizza in the oven" # said aloud on the TV at the time
omarchy-link room post hermes "Backup done" # a pane on the Home with a room's last 5 lines
omarchy-link console # this tmux pane on the TV, read-only, until Ctrl+CAgents get the same with the MCP tools tv_room_post and tv_remind.
Dashboards on the TV, Hyprland style
omarchy-link pages add home "Home" http://192.168.1.20:8080/ --icon H --badge 2 # a tile on the Home
omarchy-link page http://192.168.1.20:8080/ http://192.168.1.21:3000/ # two pages tiled1-4 or the colour keys switch windows, and BACK closes them. A page takes the TV's colours with one line of
JavaScript:
<script src="http://<tv>:47800/v1/sdk/omarchytv.js"></script>
<script>OmarchyTV.connect({ token: "otva_…" }).followTheme(); OmarchyTV.remote();</script>Make the token with omarchy-link token add "Home" --scope read, or on the TV in Settings › Connect Omarchy Linux › New app
token (shown as a QR code).
From anywhere: Tailscale
Install the Tailscale app on the TV, then turn on Settings › Connect Omarchy Linux › Allow Tailscale (tailnet). On the PC:
omarchy-link tailscale on
omarchy-link discover
omarchy-link pair living-tvEverything then works from the office or the beach house, over IPv4 and IPv6. For a machine elsewhere on the
tailnet, omarchy-link token add "NAS" --scope notify --remote prints its curl line, its claude mcp add command
and its Hermes block. On a 1-2 GB TV, omarchy-link tv keepalive on keeps it reachable right after a reboot. LG and Samsung need a Raspberry Pi as a bridge:
TAILSCALE.md, RASPBERRY-PI.md.
Agents in the cloud: Cloudflare Tunnel
omarchy-tv cloudflare setup omarchytv-mcp tv-mcp.example.com
omarchy-tv mcp --cloudflare omarchytv-mcp --access-team TEAM --access-aud AUDA cloud agent can then read and talk to you, but not drive the TV, unless you allow it. The TV itself is never on
the internet. See CLOUDFLARE.md.
Quieter, lighter, fixed
- Home no longer starts music by itself. If you liked it, Radiomarchy › Settings › Music on Home brings it back.
- Radiomarchy has a sleep timer, and shows the song's page as a QR code for your phone.
- On LG, Radiomarchy no longer goes silent after the first song.
- Fractals are lighter: each scene is its own shader, and auto quality stops at "high".
- Home is Last Horizon "Eyes Wide" again (Erik Johansson's eyes, looping; a lighter copy on weak TVs). Only if you
never picked a wallpaper: your choice stays, and the fractals are one click away in Settings › Wallpaper. - Grok Bot diretto copes with ntfy.sh rate limits (#70). Grok Bot is built for Tom Ballard's Agent Desktop v0.3.3.
- LG and Samsung: Arrange panels really reorders the Home widgets, and every menu title follows the TV's language.
- On LG and Samsung, agents have their own key: an agent can never answer its own question.
- Install notes for Hisense, TCL, accessibility after updates and more: INSTALL-TIPS.md.
- Settings › System info shows the TV's state. On the PC,
omarchy-link tv logsgives the log for bug reports,
tv backupsaves the TV's settings andtv restoreputs them back. - Eight community pull requests are merged. Thank you!
Guides: the 2.21 user guide (every switch and command), remote access and AI
agents (Tailscale, Cloudflare, MCP, Claude Code, Codex, Hermes), the developer reference
INTEGRATIONS.md. The full list is in the CHANGELOG.
Guides
Thanks
- Chris OHearn (@chrisohearn): #144, #152, #153, #155 (Link reachable after boot, updates and sleep; fixed cast port; T3 Code as an agent source; Radiomarchy notification permission).
- Anderson Leite (@andersonleite): #146, #147, #149, #156 (a PC without an Omarchy theme leaves the TV's theme alone; one VoiceInput for every mic; the AI panel stays on screen; ai credits rows).
- Erik Johansson (@erikrjohansson), for Last Horizon "Eyes Wide", the Home wallpaper again in 2.21.
- Tom Ballard (@tcballard), for Agent Desktop: Grok Bot is built for Agent Desktop v0.3.3.
Downloads and SHA256SUMS
The APK is signed with the OmarchyTV release certificate (SHA-256: 90aa68d9f45e623eadfd349ab1eb66042356f95ff6347a4568c3f3a78f8ea33d), so adb install -r upgrades over 2.20.0 and earlier and keeps your settings. The Tizen widget is unsigned: sign it with your own Samsung certificate (see tizen/INSTALL-TIZEN.md). OmarchyTV-2.21.mp4 is the 68-second video of this release.
| File | Size | SHA-256 |
|---|---|---|
omarchytv-release-2.21.0.apk |
15.0 MB | 0e0593b1b448718159374b9bc525b7631fb68a95c8204077f3d56737a17ab8f5 |
omarchytv-webos-2.21.0-testing.ipk |
12.5 MB | 452d642fca4095728d0732a15525c2e4a15ebbf8cc2c2c423e4e7fbaaf6e7142 |
OmarchyTV-tizen-2.21.0-unsigned.wgt |
12.6 MB | 746d34f08a841b8ed896df4f0d8de3de73c45274b029ae99a0cc5b3a34303563 |
omarchy-tv-pc-plugin-2.21.0.tar.gz |
354 KB | 04604a05d9c8630bfc5e293bb74791153b8a01d11bf8f20d2fa1afa81c5d7239 |
omarchy-tv-2.21.0.tar.gz |
93 KB | 0852f56ebf0817698a2c090951e9544d57e91f484f404fdf77ce36cf9d827ef6 |
omarchy-link-2.21.0.tar.gz |
249 KB | eae81e7046892c037756f5d2487de1d69e049df19ca9a9c0e91b119601252a96 |