{"id":49843290,"url":"https://github.com/usrivastava92/gtv-desktop-remote","last_synced_at":"2026-05-14T08:01:42.183Z","repository":{"id":351759685,"uuid":"1212366829","full_name":"usrivastava92/gtv-desktop-remote","owner":"usrivastava92","description":"macOS menu bar remote for Google TV and Android TV devices with local discovery, one-time pairing, keyboard controls, and text input.","archived":false,"fork":false,"pushed_at":"2026-05-08T22:08:28.000Z","size":2449,"stargazers_count":1,"open_issues_count":11,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-09T00:17:34.009Z","etag":null,"topics":["android-tv","android-tv-remote","desktop-app","electron","google-tv","google-tv-remote","keyboard-shortcuts","local-network","macos","macos-app","menu-bar-app","pairing","react","remote-control","tv-remote","typescript","vite"],"latest_commit_sha":null,"homepage":"https://github.com/usrivastava92/gtv-desktop-remote/releases/latest","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/usrivastava92.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-16T10:00:43.000Z","updated_at":"2026-05-06T20:49:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/usrivastava92/gtv-desktop-remote","commit_stats":null,"previous_names":["usrivastava92/gtv-desktop-remote"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/usrivastava92/gtv-desktop-remote","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usrivastava92%2Fgtv-desktop-remote","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usrivastava92%2Fgtv-desktop-remote/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usrivastava92%2Fgtv-desktop-remote/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usrivastava92%2Fgtv-desktop-remote/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/usrivastava92","download_url":"https://codeload.github.com/usrivastava92/gtv-desktop-remote/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usrivastava92%2Fgtv-desktop-remote/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33015817,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"online","status_checked_at":"2026-05-14T02:00:06.663Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android-tv","android-tv-remote","desktop-app","electron","google-tv","google-tv-remote","keyboard-shortcuts","local-network","macos","macos-app","menu-bar-app","pairing","react","remote-control","tv-remote","typescript","vite"],"created_at":"2026-05-14T08:01:21.234Z","updated_at":"2026-05-14T08:01:42.177Z","avatar_url":"https://github.com/usrivastava92.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/icons/taskbar-icon.png\" alt=\"GTV Desktop Remote\" width=\"120\" /\u003e\n\n  \u003ch1\u003eGTV Desktop Remote\u003c/h1\u003e\n\n  \u003cp\u003e\u003cstrong\u003eA macOS desktop remote for Google TV and Android TV devices.\u003c/strong\u003e\u003cbr/\u003e\n  Discover, pair once, and control your TV from your Mac — with keyboard support.\u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://github.com/usrivastava92/gtv-desktop-remote/actions/workflows/ci.yml\"\u003e\n      \u003cimg src=\"https://github.com/usrivastava92/gtv-desktop-remote/actions/workflows/ci.yml/badge.svg\" alt=\"CI\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/usrivastava92/gtv-desktop-remote/releases/latest\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/v/release/usrivastava92/gtv-desktop-remote?label=release\" alt=\"Latest Release\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/usrivastava92/gtv-desktop-remote/releases/latest\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/downloads/usrivastava92/gtv-desktop-remote/total?label=downloads\" alt=\"Total Downloads\" /\u003e\n    \u003c/a\u003e\n    \u003cimg src=\"https://img.shields.io/badge/platform-macOS-lightgrey?logo=apple\" alt=\"macOS\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/built%20with-Electron-47848F?logo=electron\" alt=\"Electron\" /\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n---\n\n## Overview\n\nGTV Desktop Remote lets you control any Google TV or Android TV device from your Mac. It runs as a menubar app — always one keystroke away — and uses the same encrypted pairing protocol as the official Android TV Remote app.\n\n- **Network scan** — discovers compatible devices on your local network automatically\n- **One-time pairing** — enter a 6-digit code once; credentials are saved securely\n- **Full remote control** — navigation, select, home, back, play/pause, volume, power\n- **Keyboard control** — drive your TV from the keyboard without touching the mouse\n- **Text input** — send text directly to apps that support Android TV text entry\n- **IP-change resilient** — device identity is tracked by MAC address, not IP, so re-pairing is never needed when your TV's IP changes\n- **Global shortcut** — `CmdOrCtrl+Shift+G` shows or hides the remote from anywhere\n\n---\n\n## Screenshots\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\" width=\"50%\"\u003e\n        \u003cimg src=\"assets/screenshots/remote.png\" alt=\"Connected remote controls screen\" width=\"320\" /\u003e\n        \u003cbr /\u003e\n        \u003csub\u003e\u003cstrong\u003eRemote controls\u003c/strong\u003e\u003c/sub\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"50%\"\u003e\n        \u003cimg src=\"assets/screenshots/device-discovery.png\" alt=\"Connected device management screen\" width=\"320\" /\u003e\n        \u003cbr /\u003e\n        \u003csub\u003e\u003cstrong\u003eDevice management\u003c/strong\u003e\u003c/sub\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n---\n\n## Installation\n\nDownload the latest `.dmg` from the [Releases](https://github.com/usrivastava92/gtv-desktop-remote/releases/latest) page, open it, and drag the app to your Applications folder.\n\nOr install with Homebrew:\n\n```bash\nbrew install --cask usrivastava92/tap/gtv-desktop-remote\n```\n\n\u003e **Requirement:** macOS. Your TV must have Android TV Remote Service enabled and be on the same local network as your Mac.\n\n---\n\n## Getting Started\n\n1. Launch the app — it appears in your menu bar.\n2. The app scans your network for compatible devices.\n3. Select your TV from the device list.\n4. If not yet paired, click **Start Pairing** and enter the 6-character code shown on your TV.\n5. Once paired, click **Connect** — you're ready to use the remote.\n\nThe app remembers paired devices, so future connections are instant.\n\n---\n\n## Keyboard Shortcuts\n\nWhen the remote is focused and connected, your keyboard controls the TV directly:\n\n| Key                    | Action       |\n| ---------------------- | ------------ |\n| `↑` `↓` `←` `→`        | Navigate     |\n| `Enter`                | Select / OK  |\n| `Escape` / `Backspace` | Back         |\n| `H`                    | Home         |\n| `Space` / `K`          | Play / Pause |\n| `+` / `=`              | Volume Up    |\n| `-` / `_`              | Volume Down  |\n| `P`                    | Power        |\n\n\u003e `Cmd`, `Ctrl`, and `Option` combinations are ignored so they don't interfere with normal macOS shortcuts.\n\n**Global shortcut:** `CmdOrCtrl+Shift+G` — show or hide the remote from any app.\n\n---\n\n## Troubleshooting\n\n**TV not appearing in the scan?**\n\n- Confirm the TV and Mac are on the same Wi-Fi network.\n- Confirm Android TV Remote Service is enabled on the TV.\n- Try re-running the network scan.\n\n**Pairing not completing?**\n\n- Start a fresh pairing session and enter the latest code shown on the TV screen.\n- If the device was previously saved, remove it and pair again.\n\n---\n\n## For Developers\n\nDevelopment setup, packaging, debug telemetry, and local build workflows are documented in [DEVELOPMENT.md](DEVELOPMENT.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fusrivastava92%2Fgtv-desktop-remote","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fusrivastava92%2Fgtv-desktop-remote","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fusrivastava92%2Fgtv-desktop-remote/lists"}