📺 vibetv

Vibecode your TV menu. Lose the ads.

Swap your TV's ad-filled home screen for one you describe to your AI coding agent, and watch it update on the big screen every time you save.

Android TV · Google TV · Fire TV · Roku · LG webOS

Everyone is trying to vibecode their TV menu: rip out the sponsored rows and autoplaying promos, and build a home screen that shows just their apps, their way. The catch is that an AI agent pointed at a TV is blind. It can't see the screen, can't press the remote, and doesn't know a D-pad from a mouse. vibetv closes that loop.

• Build your own menu: describe it, and your agent builds a home screen that lists and launches your installed apps. Make it the TV's Home with one command, and undo it with another.

• Remove the ads: a menu you wrote has no sponsored content. On Android TV, the reversible quiet-android-tv-home tweak also turns off the stock recommendations feed.

vibetv changes your TV's menu, not other apps: ads inside YouTube, Netflix and other streaming apps aren't touched.

 you: "make my home screen show my apps as big cards, with the weather and a clock"
  │
  ▼
 AI agent edits web/app.js ──► vibetv serve live-reloads it on the TV
  ▲                                         │
  └── vibetv screenshot / tv_screenshot ◄───┘   (the agent *sees* the result)

What you get

Related MCP server: adb-tv-mcp

Quick start (5 minutes)

1. Install

# with uv (recommended)
uv tool install git+https://github.com/Uchebuzz/vibetv
# or pipx
pipx install git+https://github.com/Uchebuzz/vibetv

For Android TV / Google TV / Fire TV you also need adb: winget install Google.PlatformTools · brew install android-platform-tools · sudo apt install adb

2. Put your TV in developer mode (full guide)

• Android TV / Google TV: Settings → System → About → click Build 7 times → Developer options → turn on USB debugging / Network debugging

• Fire TV: Settings → My Fire TV → About → click the device name 7 times → Developer options → ADB debugging on

• Roku: on the remote press Home ×3, Up ×2, Right, Left, Right, Left, Right and set a password

3. Connect

vibetv doctor                 # checks your setup
vibetv discover               # finds TVs on your network
vibetv add 192.168.1.42       # Android: accept the prompt on the TV
vibetv add 192.168.1.50 --password <roku-dev-password>   # Roku
vibetv screenshot             # 🎉 saved tv-screenshot.png

4. Vibecode

vibetv new android-tv "Living Room"
cd living-room
vibetv deploy                 # installs the app once (or grab the APK GitHub Actions builds for you)
vibetv serve --open           # live-reload from now on

Now open your AI agent in that folder and ask for what you want:

"Turn this into my home screen: big cards for my installed apps sorted by most used, a weather widget for Lagos, and a dark theme. Check it on the TV when you're done."

The project's AGENTS.md / CLAUDE.md tells the agent how to screenshot the TV, press keys, read logs and follow TV UI rules, so it can check its own work.

Give your agent superpowers (MCP)

# Claude Code
claude mcp add vibetv -- vibetv mcp

// Cursor, Windsurf, Claude Desktop, ... (mcpServers config)
{ "mcpServers": { "vibetv": { "command": "vibetv", "args": ["mcp"] } } }

Templates

vibetv templates

No Android SDK? You don't need one. Push your project to GitHub and the included workflow builds the APK. Download it from the run's artifacts, then run vibetv install app-debug.apk.

Recipes

# Make your vibecoded app the Home screen (reversible)
#   1. uncomment the HOME intent-filter in app/src/main/AndroidManifest.xml, redeploy
vibetv launcher set com.vibetv.livingroom
vibetv tweak revert custom-launcher        # back to stock

# Use your app as the screensaver
vibetv screensaver set com.vibetv.livingroom/.WebDreamService --preview

# Speed up a sluggish TV box
vibetv tweak apply snappy-animations

# Drive the TV from a script
vibetv key home right right ok
vibetv type "lofi beats"
vibetv launch com.google.android.youtube.tv

More prompts to paste into your agent: prompts/.

All commands

vibetv doctor | discover [--scan] | add <ip> | devices | use <name> | remove <name> | info
vibetv key <keys...> | type <text> | screenshot [file] | apps | launch <app> | install <apk> | open <url>
vibetv templates | new <template> <name> | serve [--open] | logs [-f] | deploy
vibetv tweak list|show|apply|revert <preset> | launcher set <pkg> | screensaver show|set <component>
vibetv mcp

Every device command takes -d <name-or-ip> to target a specific TV.

Safety

• vibetv never uninstalls system apps. It uses pm disable-user, which is fully reversible.

• Every tweak records the previous value in ~/.vibetv/undo.json, and vibetv tweak revert puts it back.

• Presets are labelled safe, moderate or advanced, and non-safe ones ask before applying.

• Developer-mode passwords are stored locally in ~/.vibetv/config.json, never in your project.

• Turn developer/network debugging off when you're done if your network isn't trusted.

Platform support

🚧 = help wanted! See CONTRIBUTING.md.

Contributing

PRs are very welcome, especially new tweak presets (just a JSON file), templates, prompts, and Tizen/webOS support. See CONTRIBUTING.md.

License

MIT