androidtvremote2
A Python library for interacting with Android TV using the Android TV Remote protocol v2. This is the same protocol the Google TV mobile app is using. It doesn't require ADB or enabling developer tools on the Android TV device. It only requires the Android TV Remote Service that comes pre-installed on most Android TV devices.
For a list of the most common commands you can send to the Android TV see: TvKeys. For a full list see remotemessage.proto. In addition to commands you can send URLs to open apps registered to handle them. See this guide for how to find deep links for apps.
Voice commands can also be sent as PCM 16-bit mono 8 kHz audio data.
Credits
- Official implementation of the pairing protocol in Java
- Implementation in Python but for the old v1 protocol
- Implementation in Node JS for the v2 protocol
- Description of the v2 protocol
Example
See demo.py
Development environment
python3 -m venv .venv
source .venv/bin/activate
# for Windows CMD:
# .venv\Scripts\activate.bat
# for Windows PowerShell:
# .venv\Scripts\Activate.ps1
# Install dependencies
python -m pip install --upgrade pip
python -m pip install -e .
# Generate *_pb2.py from *.proto
python -m pip install grpcio-tools mypy-protobuf
python -m grpc_tools.protoc src/androidtvremote2/*.proto --python_out=src/androidtvremote2 --mypy_out=src/androidtvremote2 -Isrc/androidtvremote2
# Run pre-commit
python -m pip install pre-commit
pre-commit install
pre-commit run --all-files
# Run tests
python -m pip install -e ".[test]"
pytest
# Run demo
python -m pip install -e ".[demo]"
python src/demo.py
# Build package
python -m pip install build
python -m build
The voice demo requires the PyAudio library. Depending on the target platform, PortAudio might have to be installed manually, see PyAudio installation for more information.
1 maintainer
Metadata
1 maintainer
Release files for androidtvremote2 0.3.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| androidtvremote2-0.3.2.tar.gz | 58.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| androidtvremote2-0.3.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 106.4 kB
Release files / androidtvremote2-0.3.2.tar.gz
| Download URL | androidtvremote2-0.3.2.tar.gz |
|---|---|
| Size | 58.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
68fa96ca25ac8ddcb20a64c4c61481a37539b301b899f733f3fb1fc134ea8763
|
|
BLAKE2b-256 checksum How to use checksums |
88ba25b1cd1071bb57fb18c86856a578d100e748cd6344a4d7224994dfe45df0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 1, 2026.
Transparency logRelease files / androidtvremote2-0.3.2-py3-none-any.whl
| Download URL | androidtvremote2-0.3.2-py3-none-any.whl |
|---|---|
| Size | 48.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b3818c316d8416912f46aac489dbd2bc277814a72b6fb1c4c45c71b6424fc13c
|
|
BLAKE2b-256 checksum How to use checksums |
423f3abd350acc7a442157e45881243f8c175dbd277f0d26b25516bce476d770
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 1, 2026.
Transparency log
