Skip to main content

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

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.

Metadata

Release files for androidtvremote2 0.3.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for androidtvremote2 0.3.3
File Size Uploaded Provenance Actions
androidtvremote2-0.3.3.tar.gz 60.2 kB With provenance Details for androidtvremote2-0.3.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for androidtvremote2 0.3.3
File Interpreter ABI Platform Actions
androidtvremote2-0.3.3-py3-none-any.whl Python 3 none any Details for androidtvremote2-0.3.3-py3-none-any.whl

Total release size: 108.5 kB

Release files / androidtvremote2-0.3.3.tar.gz

Download URL androidtvremote2-0.3.3.tar.gz
Size 60.2 kB
Tags Source
SHA-256 checksum
How to use checksums
f7622dd7a990ffcf6a2ded488cd4446975c70cb1b6ccc62f8f4d921929b01c65
BLAKE2b-256 checksum
How to use checksums
7d2648b1fb7657dffceb344bd02c3b8a72ed466e8a090f02dedd0b84a938fcc6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 8, 2026.

Transparency log

Release files / androidtvremote2-0.3.3-py3-none-any.whl

Download URL androidtvremote2-0.3.3-py3-none-any.whl
Size 48.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0c953122b4f56ff84646d619fd2ab0ce488d5452497a5e8d072dca906ff4327d
BLAKE2b-256 checksum
How to use checksums
c421cae0b37ddb541ba7c5013da5a93a93be2b37a532761a99550cb41f83bf1a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 8, 2026.

Transparency log

Security for androidtvremote2 0.3.3

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for androidtvremote2-0.3.3.tar.gz

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 Nov 8, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page