A remote for your Android TV, in your phone's or computer's browser
Webmote is an open-source remote for Android TV and Google TV that works in a web browser. Install it on the TV, open the address it shows on any phone, tablet or computer on the same Wi-Fi, type the PIN from the TV screen, and you have a remote like Google TV's: D-pad, OK, Back, Home, volume, play/pause, an Apps sheet and a keyboard for typing searches.
There is nothing to install on the phone and no account to sign in to, and nothing leaves your home network. Add the page to your phone's home screen and it opens full screen, like an app.
Left: the remote page (demo TV and apps). Right: Webmote on the TV, with the address and PIN blurred.
On a computer or a tablet on its side, the remote spreads out to fit the window (demo TV).
- Google-TV-style remote: D-pad with OK, Back, Home, volume up/down, mute, play/pause, and TV settings
- Turn off: hold the power button for a second, so a stray tap doesn't
- Apps sheet: every app on the TV with its banner; tap one to open it
- Keyboard: type on your phone and the text appears in the TV's focused search or text box, then Enter to search
- Now playing: the TV's name, the app in front, and the volume, kept up to date
- Hold to repeat on the D-pad and volume, with a small vibration on phones that have it
- Desktop keyboard shortcuts: arrows, Enter, Backspace or Esc, H, + and −, M, Space, K for the keyboard, A for apps
- Home-screen app: a web app manifest and icons, so it opens full screen from the home screen
- Paired, not open: a 6-digit PIN pairs each browser; wrong guesses lock pairing for longer each time; New PIN signs every device out. See Security
- Small: one ~45 KB APK, plain Java, no libraries, no tracking
- A module card for the Clean Your TV launcher ("Webmote · Phone remote"); on any other home it's an ordinary app
- An Android TV or Google TV device on Android 11 or newer (on Android 13 and newer the D-pad works everywhere; see Known Limitations for 11 and 12)
- A phone, tablet or computer with a modern browser, on the same network as the TV
- To install: a computer with ADB and Developer options → Network debugging on the TV, or any sideloading app on the TV
- Download
Webmote-x.y.z.apkfrom the latest release. - Install it and switch on its remote service:
TV_HOST=<tv ip> APK=Webmote-0.1.1.apk ./install.sh
This installs the APK withadb, adds Webmote's remote service to the accessibility services already on (keeping theirs), and opens Webmote on the TV.
Installing without a computer: sideload the APK with any file manager or downloader app, open Webmote, choose Remote service and switch on Webmote in Accessibility settings. Some TVs hide that screen; then use install.sh once from a computer.
JDK 17 and Android SDK platform 34 with build-tools 34.0.0:
TV_HOST=<tv ip> ./install.sh
It builds the app and installs it the same way. To build only: ./gradlew assembleRelease; the JVM tests run with ./gradlew testReleaseUnitTest. Where macOS blocks the stock adb, set CLEANYOURTV to a clone of Clean Your TV with its tools set up, and its tools/tv.py is used instead.
- Open Webmote on the TV. It shows an address like
http://192.168.1.20:8080and a 6-digit PIN. - Open that address in the browser on your phone or computer, and type the PIN. The TV also shows the PIN in a corner while the browser is on the pairing page, so after the first time you can skip opening Webmote on the TV. The browser stays paired.
- Add it to your home screen:
- iPhone and iPad (Safari): Share → Add to Home Screen. It opens full screen, like an app.
- Android (Chrome): ⋮ → Add to Home screen. Over plain HTTP, Chrome adds a shortcut that opens in a browser tab; tap the full-screen button at the top of the remote to hide the browser bars.
- Computer: bookmark it, and use the keyboard shortcuts listed under the remote.
The address is the TV's address on your network. If your router hands it a new one, Webmote shows the new address; give the TV a fixed address (a DHCP reservation in the router) to keep the home-screen icon working. If port 8080 is taken, Webmote uses the next free port, up to 8089.
On the TV, New PIN (press OK twice) makes a new PIN and signs out every paired phone and computer.
For scripts and home automation, the same calls the page makes are documented in docs/api.md.
Phone / computer Android TV
┌────────────────┐ home Wi-Fi ┌──────────────────────────┐
│ Browser │ HTTP + key │ Webmote │
│ remote page ├────────────────►│ ├─ tiny HTTP server │
│ (home screen) │◄────────────────┤ ├─ pairing (PIN → key) │
└────────────────┘ status, apps │ └─ accessibility service│
│ presses the keys │
└──────────────────────────┘
Webmote runs a small HTTP server inside its accessibility service, so it serves the page while the service is on and stops when it's off. The page is a single HTML file inside the app.
- D-pad, OK, Back, Home and Turn off are Android's own global actions for accessibility services, the same ones a switch-access device uses. No ADB, no root, and no input injection.
- Volume and mute go through the audio service, and the TV shows its own volume bar. Play/pause is a media key, delivered to whichever app is playing.
- Typing finds the text box that has focus on the TV and sets its text, like the Google TV app's keyboard does. Netflix draws its own keyboard with no text box behind it, so there Enter opens Netflix's search for what you typed, through the link Netflix offers for searching.
- Apps are the ones with a TV launcher entry, opened the way the home screen opens them.
Anything that can press a TV's keys can open apps and change settings, so Webmote is locked down by default:
- Only devices on your home network (private addresses, and VPN ranges like Tailscale's) can connect at all.
- Every control call needs a key that the TV gives out only for the PIN on its screen. After 5 wrong PINs, pairing locks for 30 seconds, doubling up to 5 minutes. A browser on the pairing page can ask the TV to show the PIN in a corner of its screen for a minute; that shows it to the room, not to the browser.
- The TV stores only hashes of the keys. Pages on other websites can't use your paired browser to control the TV (no CORS, DNS-rebinding protection).
- No accounts, no cloud, no analytics: nothing leaves your network.
Never forward port 8080 to the internet. Webmote speaks plain HTTP on the home network, the usual trade-off for a local device. To use it away from home, use a VPN to your home network. Details, and how to report a vulnerability: SECURITY.md.
- It can't turn the TV on. A TV in standby is off the network, so nothing on Wi-Fi can reach Webmote. Use the TV's remote, HDMI-CEC from another device, or a voice assistant to turn it on.
- The D-pad on Android 11 and 12 works in most apps, not all. The D-pad actions for accessibility services arrived in Android 13. Before that, Webmote moves the TV's focus itself and OK clicks what has it. That follows apps built from standard Android views (home screens, settings, most app menus), but not apps that draw their own screen, such as some games and video players. Not yet tested on an Android 11 or 12 TV: reports welcome. Android 10 and older aren't supported.
- Android Chrome won't install it as a full app over HTTP. Browsers only install web apps from HTTPS, which a TV on a private address can't get. iPhone home-screen web apps open full screen anyway; on Android use the full-screen button.
- Some apps ignore the keyboard. Apps that draw their own on-screen keyboard instead of a real text box can't receive typed text; use the D-pad there. Netflix is the exception: type, then press Enter to search it.
- The remote service has to stay on. Some TVs turn accessibility services off after an update or when memory is short; open Webmote on the TV to see whether it's on.
MOKA R8G (Android 14). Verified from a computer on the same network: pairing with the PIN and refusing a wrong one; calls without a key refused; a request with a host name instead of the TV's address refused; Home, Back, left and right, and TV settings; the Apps list (73 apps), app banners and opening an app, with an app outside the TV launcher list refused; the TV's name and the app in front; "no text box has focus" when there was none; the pairing surviving an app update. The remote page was checked in desktop Chrome against a stand-in for the TV.
Not tested yet: volume, mute and play/pause (the test TV stayed muted), Turn off, typing into a real text box, and the page on an iPhone or Android phone, including the home-screen app. Reports welcome: open an issue.
This project is licensed under the MIT License.
See the LICENSE file for details. Full license text: https://opensource.org/licenses/MIT
Pull requests are welcome. Open an issue first to discuss ideas or report bugs. See CONTRIBUTING.md and the Code of Conduct.
- Clean Your TV: debloat tools and a lean launcher for Android TV, whose module cards Webmote supports
- Corner Player: your own camera or stream in a corner of the TV, over any app
- ShackScreen: an Android TV dashboard for radio operators
The remote's layout follows the familiar Google TV remote; the icons and art are Webmote's own.
Android™, Android TV™ and Google TV™ are trademarks of Google LLC, and iPhone® and Safari® are trademarks of Apple Inc.; they are used here solely to describe compatibility. Webmote is not affiliated with or endorsed by Google or Apple.
All other trademarks are the property of their respective owners.



