Repolode
Submit
piermark

piermark/omarchytv

An Omarchy-style home screen and launcher for Android TV, LG webOS and Samsung Tizen TVs, with a PC/Mac companion plugin.

View on GitHubWebsite
Stars
494
Forks
52
Open issues
7
Last commit
2 days ago

What is it?

OmarchyTV replaces the home screen of an Android TV or Google TV device with a tiling-window layout modeled on the Omarchy Linux desktop. It includes a top bar, workspaces for Home, TV inputs, all apps, PC link and system settings, plus 28 bundled MIT-licensed themes with 4K wallpapers that can be switched live.

The project also ships an Omarchy-styled terminal assistant called Grok Bot that runs local TV commands such as switching themes, launching apps and starting a screensaver. When paired with a desktop through the omarchy-tv and omarchy-link plugin, it can forward questions to a signed-in AI CLI on the PC. A native MCP server exposes the TV to desktop AI agents over stdio or localhost HTTP.

An Android phone companion can scan the local network and install the launcher on a TV over wireless ADB without a PC. LG webOS and Samsung Tizen builds are available as experimental releases. The project is labeled beta and has been tested on a limited set of devices.

Key features

  • 01Omarchy-style tiling layout with a top bar and five workspaces on Android TV
  • 0228 bundled MIT themes with 4K wallpapers, switchable live
  • 03Grok Bot terminal assistant with offline TV commands and paired PC AI CLI forwarding
  • 04Native MCP server for controlling the TV from desktop AI agents
  • 05Wireless install from an Android phone over ADB without a PC
  • 06Experimental LG webOS and Samsung Tizen builds

Use cases

  • Turning an Android TV or Google TV into a themed desktop-style home screen
  • Controlling a TV from a Linux or macOS desktop, including app launch and media casting
  • Letting desktop AI agents such as Claude Desktop or Cursor operate a TV through MCP
  • Installing a launcher on several TVs over the local network from a phone

Quick start

  1. 1

    Download the Android TV APK from the GitHub or GitLab release page

  2. 2

    Install the APK on your TV with adb (the README uses adb install -r to upgrade)

  3. 3

    Optionally install the PC plugin from the release tarball and use omarchy-tv to send media to the TV

Things to know

  • Beta software that has been tested on only a few TVs, so bugs and missing features are expected.
  • The webOS and Tizen builds are experimental testing releases.
  • The PC companion plugin works only on Omarchy Linux and macOS.
  • The metadata license is listed as NOASSERTION, although the README states MIT.

In collections

Android ADB and debloat toolsMCP servers

Topics

#android-tv#home-screen#launcher#theme#mcp#smart-tv#adb#linux

FAQ

What is omarchytv?
An Omarchy-style home screen and launcher for Android TV, LG webOS and Samsung Tizen TVs, with a PC/Mac companion plugin. OmarchyTV replaces the home screen of an Android TV or Google TV device with a tiling-window layout modeled on the Omarchy Linux desktop. It includes a top bar, workspaces for Home, TV inputs, all apps, PC link and system settings, plus 28 bundled MIT-licensed themes with 4K wallpapers that can be switched live.
Is omarchytv free to use? What license does it have?
omarchytv is open source under the Other license. Check the license terms before using it in commercial products.
Is omarchytv still maintained?
Actively maintained. The last commit to omarchytv was on Nov 5, 2026.
What can I use omarchytv for?
Turning an Android TV or Google TV into a themed desktop-style home screen Controlling a TV from a Linux or macOS desktop, including app launch and media casting Letting desktop AI agents such as Claude Desktop or Cursor operate a TV through MCP Installing a launcher on several TVs over the local network from a phone
How do I install omarchytv?
Download the Android TV APK from the GitHub or GitLab release page Install the APK on your TV with adb (the README uses adb install -r to upgrade) Optionally install the PC plugin from the release tarball and use omarchy-tv to send media to the TV
Where can I get omarchytv?
The source code and installation instructions are on GitHub: https://github.com/piermark/omarchytv

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects