Skip to content

OmarchyTV 2.21.0: your TV, wired into your AI agents

Latest

Choose a tag to compare

@piermark piermark released this 19 Nov 09:33
· 4 commits to main since this release

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 tool
omarchy-link watch -- make release                                  # ✓ / ✗ on the TV when it ends
omarchy-link notify --level alert --speak "prod is down"            # with a chime, read aloud

Hermes 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 first

Allow, 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+C

Agents 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 tiled

1-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-tv

Everything 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 AUD

A 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 logs gives the log for bug reports,
    tv backup saves the TV's settings and tv restore puts 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