> ## Content Index
> Fetch the complete content index at: https://claudefox.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# couch-tv gives Google TV a clean home screen and a phone remote, with an optional Claude assistant
- URL: https://claudefox.com/couch-tv-google-tv-home-screen-phone-remote-claude/
- Published: 2026-11-16T03:28:33.000Z
- Updated: 2026-11-16T03:34:00.000Z
- Description: couch-tv (Seagey/couch-tv) is a free, MIT-licensed home screen for Google TV and Android TV with a phone remote and an optional Claude assistant. Samsung, LG and Roku get it as an app or channel that an always-on computer opens.
- Author: hupicake
- Tags: Built with Claude

couch-tv (GitHub: Seagey/couch-tv) puts your own home screen in front of the ad-filled Google TV home, which stays installed behind it: scenes with a glass clock, your apps in your order, Keep watching across apps, and a phone remote that finds a show by name and starts it, plus an optional assistant. It is free and MIT-licensed; GitHub lists Python as its main language. Created on October 26, 2026, it had 1,351 stars and 193 forks as of November 16, 2026, and 16,967 release APK downloads.

## Quick facts

- Full support: Google TV and Android TV; the 0.12 apps need Android 7.1+, and Android 6 support is on main for the next release. Fire TV on Fire OS works partly; Amazon's home flashes up first.
- Samsung, LG and Roku run it as an app or channel opened by an always-on computer, and their Home button still opens the maker's menu. LG has run on thirteen real sets; Roku on one real TV, not yet with the bridge. Apple TV, VIDAA, Philips, Panasonic, VIZIO and TiVo have Beta paths.
- Setup computer: macOS or Linux with Python 3.11+ (no Windows bridge; the separate Setup app runs on Mac and Windows). On a Mac, allow Local Network access when asked. The phone remote build needs Node 20.19+ or 22.12+.
- Free, MIT. Latest release 0.12 (November 9, 2026, per the README); many later fixes are on main.

## How to install

Three ways to run it: A is the home screen only, with no computer left on. B adds a Python bridge on an always-on Mac, Linux box or Raspberry Pi for the phone remote, cross-app Keep watching, power-on from the phone and the Claude assistant. C runs the bridge inside a second TV app; no computer, but the phone cannot wake the TV.

Official routes: open the repo in Claude Code or another coding agent and ask it to set the TV up; use the project's setup site with its free Setup app; go phone-only, which on Google TV leaves the Home button with Google; or follow docs/SETUP.md by hand. No release is marked pre-release. To test a TV without changing it:

```
git clone https://github.com/Seagey/couch-tv.git && cd couch-tv
python3 --version
python3 -m venv .venv && .venv/bin/pip install -r bridge/requirements.txt
.venv/bin/python scripts/find-tvs.py
.venv/bin/python scripts/check-tv.py <tv address>
```

## First setup

On the TV, unlock Developer options (press the build number seven times in About) and turn on USB debugging, plus Network debugging if present. Allow every computer you will use at the first "Allow USB debugging?" prompt before installing; one Google TV set up by an older version stopped showing it. Download couch-tv-home.apk from Releases, look first with tv-home/tools/survey-tv.py, then install for option A as below (option B adds BRIDGE\_URL=http://my-computer.local:5400).

```
TV_IP=<your tv address> APK=couch-tv-home.apk sh tv-home/tools/apply.sh
```

Streaming logins stay on the TV. Show lookups (JustWatch) and weather (Open-Meteo) need no key. The assistant needs Claude Code logged in on the bridge computer (B) or your own API key (C); without it, everything else works.

## What stands out

- Setup written for an agent. AGENTS.md has the agent find the TV, ask plain questions and read the plan back, changing nothing on the TV until you say yes, and never asking for streaming passwords.
- Switch off, never delete. The TV's own home and setup app stay on; a Home-button watcher brings couch-tv forward. 0.11 adopted this after 0.10 left some TVs, a Sony Bravia among them, in a restart loop.
- Show by name. "Put on Bluey" finds where it streams in your country and deep-links into that app, past "Who's watching?" on Android TV.
- Opt-in privacy clean (Beta): PRIVACY=1 makes apply.sh reversibly disable known tracking, ad and ACR apps; DRY\_RUN=1 lists them first.
- Per-person Keep watching, a Kids mode behind a parent PIN, Home Assistant tiles and fifteen languages.

## How it was built with Claude

Of 544 commits on main from October 26 to November 15, 305 carry a Claude Co-Authored-By trailer (279 Opus 5.5, 26 Sonnet 5.5) and eight are authored by Claude; the maintainer, Seagey, authored 418\. CLAUDE.md just points to AGENTS.md, which addresses the agent installing couch-tv on someone's TV rather than development. The bridge's assistant reaches the TV only through the project's own MCP server, bridge/mcp\_server.py.

## How it compares with Free My TV and CleanYourTV

Free My TV (simbasjungles/free-my-tv), covered here earlier, is also an MIT home screen for Google TV, LG and Samsung that an AI assistant installs over ADB; our article describes no phone remote, and picks need a TMDB key. CleanYourTV (Gathin23/cleanyourtv) instead has your agent debloat the TV, then adds a simple launcher. couch-tv adds a phone remote, show-by-name playback, an assistant and a no-computer mode, but its full feature set needs an always-on bridge serving plain http on your Wi-Fi.

**Try it with your AI.** To have your own coding agent check whether your TV can run couch-tv and draft a plan, without touching the TV, give it this prompt:

```
Help me check whether my TV can run couch-tv (github.com/Seagey/couch-tv) and plan the
setup. In this session, change nothing on the TV.

1. Check first: ask me to confirm the TV, a [TV brand and model], is on and on the same
   Wi-Fi as this computer. Run python3 --version and stop if it is older than 3.11; tell
   me how to upgrade instead of installing anything. Confirm this is macOS or Linux; on
   a Mac, tell me to allow local network access if asked.
2. Clone the repo into [an empty folder you choose], work inside that folder, read its
   AGENTS.md and follow its rule that nothing on the TV changes before I say yes.
3. Create .venv there and install only bridge/requirements.txt. Run .venv/bin/python
   scripts/find-tvs.py, read me the TVs it lists, then run .venv/bin/python
   scripts/check-tv.py [the TV's address] without --adb. Tell me which options (A, B or
   C) it reports.
4. Ask who watches and whether a computer can stay on at home, then write a plan: the
   option, which docs/SETUP.md steps apply, and how docs/UNINSTALL.md undoes it.
5. Show me the plan and wait for my confirmation. For this check, do not run check-tv.py
   --adb, pair_tv.py or apply.sh, do not install Homebrew, system packages or Node, and
   do not open any router port. Never ask for my streaming passwords or API keys.
```

## Known limits

- No password on the phone remote by default. In option B the bridge serves it over plain http on port 5400 to anyone on your Wi-Fi, who can change channels, turn the TV off and, if Ask is on, ask Claude. Setting bridge.pairing\_key requires a key, but TV homes need an app newer than 0.12 and the Samsung, LG and Roku apps must be rebuilt. Never forward the port: the bridge has no login; use a private VPN for remote access. Option C pairs each phone with a 6-digit code.
- Bridge assistant. Option B runs Claude Code (claude -p, Sonnet) on your own Claude plan with ANTHROPIC\_API\_KEY stripped, so no API key is billed. Per bridge/claude.py, the prompt carries your request, who is asking, the local time, the previous ask and a taste summary; only the TV tools are allowed.
- On-TV assistant. Option C needs your own API key (Claude Haiku 5.5 by default; OpenAI, Gemini or a local model also work). Each ask sends the question, the person's name, the country, the names of installed TV apps and tool results to that service. The key is sent only to the address it was saved for, but sits on the TV, readable by anyone with ADB access: use a dedicated key with a spend limit.
- ADB is the core risk. Each computer you allow keeps a key (for example \~/.android/adbkey) and can connect to the TV again later, so press Allow only for your own machines. On current Fire OS the on-TV app cannot use the TV's own ADB, so option C cannot press keys or type there.
- Versions 0.10 and older could trap a TV in a restart loop; TROUBLESHOOTING.md has recovery steps. Privacy clean does not remove all tracking, and the project makes no support promise.

## Problems and feedback

Report bugs and TV results as GitHub issues (80 issues and 5 pull requests open on November 16). To remove couch-tv, stop the bridge first, or it can undo your undo, then run the command below (docs/UNINSTALL.md has details); DEV\_OFF=1 also turns debugging off.

```
TV_IP=<your tv address> DEV_OFF=1 sh tv-home/tools/remove-all.sh
```

## FAQ

Which TVs get everything? Google TV and Android TV on Android 7.1 or newer. On other TVs, the README suggests plugging in a Google TV box such as the Google TV Streamer and setting couch-tv up on that.

Can someone else on my Wi-Fi use the remote? With option B, yes, unless you set bridge.pairing\_key.

Does the Claude assistant cost extra? With the bridge it uses your existing Claude plan through Claude Code and never an API key. In on-TV mode you pay your chosen API provider; the docs estimate about a fifth of a US cent per ask on Claude Haiku 5.5.

Source: [GitHub: Seagey/couch-tv](https://github.com/Seagey/couch-tv?ref=claudefox.com), [couch-tv README](https://github.com/Seagey/couch-tv/blob/main/README.md?ref=claudefox.com), [couch-tv AGENTS.md (instructions for the setup agent)](https://github.com/Seagey/couch-tv/blob/main/AGENTS.md?ref=claudefox.com), [couch-tv setup guide](https://github.com/Seagey/couch-tv/blob/main/docs/SETUP.md?ref=claudefox.com), [How couch-tv works, privacy and limits](https://github.com/Seagey/couch-tv/blob/main/docs/HOW-IT-WORKS.md?ref=claudefox.com), [The phone remote](https://github.com/Seagey/couch-tv/blob/main/docs/REMOTE.md?ref=claudefox.com), [Ask with any AI service (on-TV mode)](https://github.com/Seagey/couch-tv/blob/main/docs/ASK-PROVIDERS.md?ref=claudefox.com), [couch-tv config reference](https://github.com/Seagey/couch-tv/blob/main/docs/CONFIG.md?ref=claudefox.com), [Privacy clean (Beta)](https://github.com/Seagey/couch-tv/blob/main/docs/PRIVACY.md?ref=claudefox.com), [On-TV mode README](https://github.com/Seagey/couch-tv/blob/main/on-tv/README.md?ref=claudefox.com), [couch-tv troubleshooting](https://github.com/Seagey/couch-tv/blob/main/docs/TROUBLESHOOTING.md?ref=claudefox.com), [Take couch-tv off your TV](https://github.com/Seagey/couch-tv/blob/main/docs/UNINSTALL.md?ref=claudefox.com), [couch-tv bridge Claude module](https://github.com/Seagey/couch-tv/blob/main/bridge/claude.py?ref=claudefox.com), [couch-tv bridge requirements](https://github.com/Seagey/couch-tv/blob/main/bridge/requirements.txt?ref=claudefox.com), [couch-tv releases](https://github.com/Seagey/couch-tv/releases?ref=claudefox.com), [couch-tv commit history](https://github.com/Seagey/couch-tv/commits/main?ref=claudefox.com), [couch-tv issues](https://github.com/Seagey/couch-tv/issues?ref=claudefox.com), [couch-tv setup site](https://couchtv.sites.underseage.studio/?ref=claudefox.com), [Claudefox: Free My TV](https://claudefox.com/free-my-tv-ad-free-google-tv-home-screen-built-with-claude-code/), [Claudefox: CleanYourTV](https://claudefox.com/cleanyourtv-debloat-android-google-tv-claude-code/)

This story first appeared in the [claudefox daily briefing for November 16, 2026](https://claudefox.com/daily-2026-11-16/).