Description
couch-tv is a GitHub repository offering an open-source solution for creating a personalized Google TV home screen and a phone-based remote control. This project aims to enhance the smart TV experience by providing users with greater customization and control over their entertainment systems. A key feature is the optional integration of a Claude assistant, allowing for more interactive and intelligent control capabilities.
Read More
The project supports a wide array of television platforms, including Android TV, Google TV, Fire TV (Vega OS), Roku OS, LG, Samsung, and Apple TV (tvOS). This broad compatibility ensures that a diverse range of users can implement couch-tv on their existing devices. The repository includes various components such as `bridge` for connecting devices, `on-tv` for the on-screen interface, and specific drivers for different TV brands like `lg`, `samsung`, `roku`, `titan` (Philips Titan OS), and `vega` (Fire TV).
Users can set up couch-tv by handing the repository to an AI agent, indicating a developer-centric approach to deployment and configuration. The project also provides examples for Docker deployment, simplifying the setup process for those familiar with containerization. Configuration options are available through `config.example.json` and `env.example`, allowing for customization of features like smart home integration via Home Assistant.
The core value proposition of couch-tv lies in its ability to offer a highly customizable and unified control experience across multiple smart TV ecosystems. By providing a single, personalized home screen and a versatile phone remote, it addresses the fragmentation often found in smart home entertainment. The optional Claude assistant further extends its utility, potentially enabling voice commands or more sophisticated automation within the TV environment. The project is actively maintained, with recent commits indicating ongoing development and feature enhancements across its various modules.
- CategoryOther AI Tools
- Pricing ModelOpen source
- DeploymentCloud, Self-hosted
- PlatformsAndroid
couch-tv's Core Features
Custom Google TV home screen
Phone remote control functionality
Optional Claude assistant integration
Support for Android TV
Support for Google TV
Support for Fire TV (Vega OS)
Support for Roku OS
Support for LG TVs
Support for Samsung TVs
Support for Philips Titan OS TVs
Support for Apple TV (tvOS)
Docker deployment examples
Smart home integration via Home Assistant
Configurable pairing keys and origin lists
Open-source codebase
Getting Started with couch-tv
Clone the repository: Obtain the project files by cloning the couch-tv GitHub repository to your local machine.
Review documentation: Consult the `README.md` and `docs/` folders for detailed setup instructions and platform-specific guides.
Configure settings: Customize the `config.example.json` and `env.example` files to match your specific TV setup and desired features, such as Claude integration or Home Assistant.
Deploy the bridge: Set up the `bridge` component to facilitate communication between your phone remote and TV devices.
Install on TV: Follow instructions for installing the `on-tv` component or specific drivers for your TV platform (e.g., Android, Roku, LG, Samsung, Apple TV).
Connect devices: Pair your phone remote with your TV using the configured settings and pairing keys.
Utilize AI agent: Optionally, hand the repository to your AI agent for automated setup and management.
Test functionality: Verify that the custom home screen, phone remote, and any integrated assistants are working as expected.
couch-tv's Use Cases
- Personalized TV Experience
- Universal Phone Remote
- AI-Assisted TV Control
- Developer TV Customization
- Smart Home Entertainment Hub
- Cross-Platform TV Management
- Enhanced Media Navigation








