Skip to content

canbedir/television-controller

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Television Controller

Turn your computer into a remote for your TV. Television Controller runs a small app in your browser that detects your Android TV on the same network and lets you control it — navigation, volume, playback, apps and more — without reaching for the physical remote or installing anything on the TV.

Television Controller

Overview

Lost the remote? Tired of switching devices? Television Controller gives you a full, on-screen remote right in your browser. Everything happens locally on your own network — there is no cloud account, no pairing app on your phone, and nothing extra to install on the television itself.

It speaks Google's official Android TV Remote protocol, the same one the Google Home app uses, so you don't need developer mode, ADB, or any cables.

Features

  • Automatic discovery of Android TVs on your network, or connect by IP
  • Secure pairing with a 6-digit code shown on the TV — paired once, then remembered
  • Smart reconnect that restores the connection automatically after a drop, with no re-pairing
  • Full remote: D-pad, OK, power, volume, mute, channels, media playback, home and back
  • App shortcuts with real logos — launch YouTube, Netflix, Prime Video, Disney+, Spotify and more; add, remove and reorder your own
  • Number pad and search to enter channels or type straight into the TV's search box
  • Live status — the volume bar and the currently open app update in real time
  • Keyboard control — arrows to navigate, Enter to select, Space to play/pause, and more
  • Press and hold to repeat volume, seeking and navigation
  • Clean, responsive interface that fits on one screen, with light and dark themes

How it works

  1. Start it. Run the launcher. It boots a small local server and opens the interface in your browser at http://localhost:3000.
  2. It finds your TV. The app scans your local network and lists the Android TVs it discovers. You can also type the TV's IP address directly.
  3. Pair once. Pick your TV and a 6-digit code appears on the screen. Enter it in the browser. The pairing is remembered, so you only do this the first time.
  4. Control it. Use the on-screen remote — every press travels straight to your TV over your local network, instantly.

Getting started

You only need Node.js 18 or newer installed.

Windows — double-click start.bat

macOS / Linux — run ./start.sh

The first launch installs what it needs and builds the interface, then opens it in your browser automatically. Later launches start in seconds.

Keyboard shortcuts

When connected, your keyboard doubles as the remote:

Key Action
Arrow keys Navigate (D-pad)
Enter Select / OK
Backspace / Esc Back
Space Play / pause
+ / - Volume up / down
M Mute
H Home
P Power

Requirements

  • A computer and an Android TV / Google TV on the same local network
  • Node.js 18 or newer

Supported TVs

Any Android TV or Google TV based television or device, including Grundig, Sony, Philips, TCL, Nvidia Shield and Chromecast with Google TV.

Very old Grundig models that are not Android-based (Linux/Zeasn) are not supported, since they don't speak the same remote protocol.

Privacy

Nothing leaves your network. The connection is made directly to the TV, and the pairing certificate is stored locally on your machine and never shared.

License

MIT

About

Browser-based remote control for Android TV / Google TV on your local network.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors