couch-tv
couch-tv is a self-hosted TV home screen and phone remote, with an optional Claude assistant, for people who want an ad-free Google TV or Android TV home.
What it is good for
- Replacing a TV home screen that is full of ads
- Finding a show and starting it from a phone
- Picking up shows across streaming apps from one place
- Setting up a custom TV home with an AI agent
At a glance
- Who it is for
- Setup difficulty
- Technical ยท Guided command-line setup
Level 4 of 5. You copy and paste commands into a terminal by following the instructions. Comfortable territory for vibe coders.
- Cost
- Free and open source
- Type
- Agent app
- Tasks
- Works with
- Claude Code, Google TV, Android TV, Fire TV, Samsung, LG
How to get started with couch-tv
- Check whether your TV works using the compatibility table in the README or the website's checker.
- Open the repo folder in Claude Code or another coding agent.
- Tell the agent "set this up on my TV".
- Answer its questions about who watches, the look, and your apps.
- Read the plan it gives back and say yes to apply changes.
From the project's own documentation. If a step does not match what you see, the official pages have the latest instructions.
Before you try it
- The agent route needs a computer on the same Wi-Fi as the TV.
- Some setups need a computer at home that stays on.
- On Google TV, the phone-only route leaves Google's Home button in place.
- Samsung, LG and Roku get the app only, and the maker's Home button still opens the maker's menu.
Momentum
- Rank this week
- Not ranked yet
- Best rank
- None yet
- GitHub stars
- 1,374
GitHub numbers as of Nov 16, 2026. Updated weekly.
Official links
Questions
- Is couch-tv free?
- Yes. It is free and open source (MIT license).
- Do I need to know how to code to use couch-tv?
- You do not need to write code, but setup means copying and pasting commands into a terminal by following its instructions.
- What does couch-tv work with?
- According to its own documentation, it works with Claude Code, Google TV, Android TV, Fire TV, Samsung, and LG.
- How do I get started with couch-tv?
- 1. Check whether your TV works using the compatibility table in the README or the website's checker. 2. Open the repo folder in Claude Code or another coding agent. 3. Tell the agent "set this up on my TV". 4. Answer its questions about who watches, the look, and your apps. 5. Read the plan it gives back and say yes to apply changes.
- What should I know before trying couch-tv?
- The agent route needs a computer on the same Wi-Fi as the TV. Some setups need a computer at home that stays on. On Google TV, the phone-only route leaves Google's Home button in place. Samsung, LG and Roku get the app only, and the maker's Home button still opens the maker's menu.
- What is couch-tv good for?
- Replacing a TV home screen that is full of ads, finding a show and starting it from a phone, picking up shows across streaming apps from one place, and setting up a custom TV home with an AI agent.
Similar agents to couch-tv
- Jarvis
Private desktop assistant with voice and text chat, not a TV home screen or remote.
- Khoj
Answers questions from documents and the web, with no TV control.
- career-ops
Agent for job search, run with a coding agent instead of controlling a TV.
- dsh-Go
dsh-Go is an Android app that runs a DeepSeek coding agent on your phone or controls the one on your computer, for mobile users.
- Mika
Mika is an Android agent app that operates your phone apps and the web from one plain-language request, for people who want tasks done without tapping through them.
- Osaurus
Osaurus is an agent app that keeps your AI memory, tools, and identity on your Mac for people who want private, offline AI work.