Google TV Remote for Windows 📺 🎛️

A lightweight, modern, native Windows desktop remote control app for Google TV and Android TV devices. Control your TV directly from your computer over Wi-Fi with keyboard hotkeys, automatic device discovery, custom app launchers, and direct text input.

• 🎨 Modern Fluent Dark UI: Ergonomic anti-aliased physical remote with circular D-Pad, smooth volume/channel rockers, and hover feedback.
• ⚡ Instant Startup: Pre-cached high-DPI raster assets with lazy background networking (< 150ms cold boot).
• 🔍 Automatic Device Discovery: Auto-scans and lists Google TV / Android TV devices on your local network using mDNS (Zeroconf).
• 🌐 Manual IP Fallback: Direct connection option for hidden networks or stubborn network setups.
• 🔒 Secure Pairing Flow: Standard PIN-based pairing protocol (uses the exact same API and security protocol as Google's official Android/iOS Google TV apps).
• ⌨️ Full Keyboard Hotkeys: Navigate your TV instantly using your PC keyboard (arrow keys, Backspace, Enter, Space, and more) with an in-app legend overlay (F1).
• 📝 Direct Text Input: Type search queries, passwords, and URLs on your PC and send them directly to the TV input fields.
• 🚀 Quick Launch Streaming Grid: Launch preloaded apps (YouTube, Netflix, Prime Video, Disney+, Spotify, Plex) or custom package IDs.
• 📦 Single File Build: Bundle the entire application into a standalone Windows Executable (.exe) with custom .ico branding.

• Operating System: Windows 10 or Windows 11.
• Python: Version 3.10 or newer (only required if running from source).
• Network: Both the Windows PC and the Google TV / Android TV must be connected to the same Wi-Fi / LAN network.

1. Head to the Latest Releases page.
2. Download GoogleTVRemote.exe.
3. Double-click to launch — no installation, Python environment, or terminal commands needed.

1. Clone this repository:

   git clone https://github.com/MahmoudxFawzy/google-tv-remote-windows.git
   cd google-tv-remote-windows

2. Install dependencies:

   python -m pip install -r requirements.txt

3. Start the application:

   python main.py

1. Discover: Click the Discover button to scan for TVs on your network. Alternatively, type your TV's local IP address manually.
2. Connect: Select your device and click Connect.
3. Start Pairing: If this is your first time connecting to the device, click Start Pairing. A 6-character authentication PIN will pop up on your TV screen.
4. Submit PIN: Enter the PIN into the desktop app and click Submit PIN.
5. Enjoy: Once paired, your client certificates are securely saved in the local certs/ directory, meaning you only need to pair your TV once!

Control your TV like a power user. Press F1 inside the app to toggle the hotkey legend:

You can edit or extend the quick-launch sidebar by editing the tv_apps.json file in the application directory. It maps app names to their Android package identifier:

[
  {
    "name": "YouTube",
    "app_id": "com.google.android.youtube.tv"
  },
  {
    "name": "Netflix",
    "app_id": "com.netflix.ninja"
  }
]

Add any custom app by looking up its Android Package Name (e.g., from the Google Play Store URL) and appending it to the list.

You can compile the application into a single .exe file that runs on any Windows machine without needing Python installed.

1. Install PyInstaller:

   python -m pip install pyinstaller

2. Run the build script:

   pyinstaller --noconfirm --windowed --onefile --name GoogleTVRemote main.py

3. Your compiled executable will be located in the dist/ directory: dist/GoogleTVRemote.exe.

• TV Not Discovered: Ensure that your TV is powered on, connected to the same network, and mDNS/Zeroconf is not blocked by your router's client isolation settings. Try connecting manually by entering the TV's IP address.
• Connection Refused: Check if your PC's firewall blocks UDP port 5353 (for Zeroconf) or TCP port 6466 / 6467 (used by the Google TV pairing protocol).
• Re-pairing Needed: If you reset your TV or wish to pair fresh, delete the files inside the certs/ directory and reconnect.

This project is licensed under the MIT License - see the LICENSE file for details.