google-tv

# Google TV Control Use this skill when I ask to control the TV, play shows, or check if the TV is online. ## Setup This skill uses a local Python virtual environment to communicate with the TV via ADB. - Always use the skill-specific venv at `./.venv/bin/python3` (not the workspace `venv` folder). Activate or call that python explicitly when running the script. - The skill requires a few Python packages at runtime; ensure the venv has at minimum: `requests` and `beautifulsoup4` (bs4). To install into the skill venv run: ``` ./.venv/bin/python3 -m pip install -r requirements.txt ``` (See requirements.txt in the skill folder.) ## Capabilities This skill provides a small CLI wrapper around ADB to control a Google TV device. It exposes the following subcommands: - status: show adb devices output - play <query_or_id_or_url>: play content. Prefer providing a YouTube video ID or a provider URL/ID. - pause: send media pause - resume: send media play ### Usage examples `./.venv/bin/python3 google_tv_skill.py status --device 192.168.4.64 --port 5555` `./.venv/bin/python3 google_tv_skill.py play "7m714Ls29ZA" --device 192.168.4.64 --port 5555` `./.venv/bin/python3 google_tv_skill.py pause --device 192.168.4.64 --port 5555` ### Device selection and env overrides - You can pass --device (IP) and --port on the CLI. - Alternatively, set CHROMECAST_HOST and CHROMECAST_PORT environment variables to override defaults. - If you provide only --device or only --port, the script will use the cached counterpart when available; otherwise it will error. - The script caches the last successful IP:PORT to `.last_device.json` in the skill folder and will use that cache if no explicit device is provided. - IMPORTANT: This skill does NOT perform any port probing or scanning. It will only attempt an adb connect to the explicit port provided or the cached port. ### YouTube handling — direct intent only (preferred) - If you provide a YouTube video ID or URL, the skill will launch the YouTube TV app directly via an ADB intent restricted to the YouTube TV package (no Assistant/UI fallback). - The skill attempts to resolve titles/queries to a YouTube video ID using the `yt-api` CLI (on PATH) and falls back to `/Users/anthony/go/bin/yt-api` if needed. If ID resolution fails, the skill will report failure rather than attempting UI search. - You can override the package name with `YOUTUBE_TV_PACKAGE` (default `com.google.android.youtube.tv`). ### Tubi handling - If you provide a numeric Tubi ID the skill will attempt the tubitv:// intent and then a VIEW https intent for a Tubi URL, both restricted to the Tubi package. - If you provide a Tubi https URL, the skill will send a VIEW intent with that URL (restricted to the Tubi package). - If the canonical Tubi https URL is needed, the assistant can look it up via web_search and supply it to this skill. - You can override the package name with `TUBI_PACKAGE` (default `com.tubitv`). ### Pause / Resume `./.venv/bin/python3 google_tv_skill.py pause` `./.venv/bin/python3 google_tv_skill.py resume` ### Behavior and logging - Default logging level is INFO. Use --verbose to enable DEBUG logging. - Exit codes: 0 success, 2 adb/connect error, 3 resolution error (e.g., could not resolve YouTube ID), 4 adb command failure. ### Dependencies & venv - requirements.txt includes required Python packages. Install them into the skill venv at `./.venv`. - The script expects `adb` to be on PATH and `yt-api` to be available on PATH or at `/Users/anthony/go/bin/yt-api`. ### Caching and non-destructive defaults - The script stores the last successful device (ip and port) in `.last_device.json` in the skill folder. - It will not attempt port scanning; this keeps behavior predictable and avoids conflicts with Google's ADB port rotation. ### Troubleshooting - If adb connect fails, run `adb connect IP:PORT` manually from your host to verify the current port. - If adb connect is refused and you're running interactively, the script will prompt you for a new port and update `.last_device.json` on success. - If yt-api resolution fails, ensure `yt-api` is installed or accessible at `/Users/anthony/go/bin/yt-api`. ## Implementation notes - The skill CLI code lives in `google_tv_skill.py` in this folder. It uses subprocess calls to `adb` and to `yt-api` when needed. - For Tubi URL discovery, the assistant can use web_search to find canonical Tubi pages and pass the https URL to the skill.