---
id: androidtvremote2
version: "0.3.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# androidtvremote2 — A Python library for interacting with Android TV using the Android TV Remote protocol v2

License: permissive · Maintenance: active · Downloads: 102.6K/mo

## What it is and what it does

androidtvremote2 is a Python client for the Android TV Remote protocol v2, the same protocol used by the Google TV mobile app. It lets you send remote control commands (key presses, app launches, voice input) to Android TV devices over the network without needing ADB or developer mode enabled. The library handles the protocol's cryptographic pairing and messaging layer, exposing an async API for sending commands and receiving responses.

The package depends on aiofiles, cryptography, and protobuf to handle asynchronous I/O, protocol encryption, and message serialization. It supports a wide range of commands documented in TvKeys.txt, can open apps via deep links, and accepts PCM audio for voice commands. It's designed for home automation, remote control applications, and integration into systems that need programmatic Android TV control.

Use it for:

- Build a home automation system that controls multiple Android TV devices from a central Python application.
- Create a custom remote control app that sends commands to Android TV without the official mobile app.
- Automate testing of Android TV apps by sending commands and verifying responses programmatically.
- Send voice commands to Android TV as PCM audio from a voice assistant or transcription service.
- Integrate Android TV control into a media center or smart home dashboard application.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python library for controlling Android TV devices over the network using the Android TV Remote protocol v2, without requiring ADB or developer mode.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and fills a specific need for Android TV control without ADB. The Apache-2.0 license is permissive. Install if you need to control Android TV devices from Python; skip if you don't have Android TV devices to control.

## Install

pip install androidtvremote2
uv add androidtvremote2
poetry add androidtvremote2

## Installing androidtvremote2

Before you install: Low friction install with three straightforward dependencies. Actively maintained with recent commits and no known vulnerabilities.

License in practice: Apache-2.0 permissive license allows free use, modification, and distribution with minimal restrictions.

Quickstart:

pip install androidtvremote2

import asyncio
from androidtvremote2 import AndroidTVRemote

async def main():
    remote = AndroidTVRemote(host='tv-device')
    await remote.connect()
    await remote.send_key_command('KEYCODE_HOME')
    await remote.disconnect()

asyncio.run(main())

Requires Python 3.10 or later. Target Android TV device must have Android TV Remote Service pre-installed.

Verify before relying:

- Whether pairing or authentication setup is required before sending commands.
- Latency and reliability characteristics for real-time remote control use.
- Whether voice command support requires additional system dependencies beyond pip installation.
- Network connectivity requirements and supported Android TV device versions.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 102.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

android tv remote control, google tv protocol python, android tv command library, remote control android tv, android tv automation, tv remote protocol v2, android-tv, home-automation, async-io

[View on SkillFed](https://skillfed.io/packages/androidtvremote2) · [View on PyPI](https://pypi.org/project/androidtvremote2/)