About

androidtv_wifi is a Python package that provides state information and control of Android TV and Fire TV devices via ADB, including modern ADB Wi-Fi pairing. It depends on adb-shell-wifi (a corresponding fork of adb-shell).

Installation

pip install androidtv-wifi

To utilize the async version of this code, you must install into a Python 3.7+ environment via:

pip install androidtv-wifi[async]

ADB Wi-Fi (TLS) support

Modern Android (11+) deprecates the legacy adb tcpip flow in favor of ADB Wi-Fi, which uses a one-shot pairing handshake plus a TLS 1.3 data channel on a randomized port advertised over mDNS.

Install with the wifi extra:

pip install androidtv-wifi[wifi]

Then either pass connection_type="tls" to setup() / BaseTVAsync / etc., or construct the device classes directly:

from androidtv_wifi import setup
from androidtv_wifi.wifi import pair, discover_connect_services

# One-time pairing — user opens "Pair device with pairing code"
# in Wireless debugging settings on the TV and reads off the code.
pair(host=PAIR_IP, port=PAIR_PORT, pairing_code="123456",
     adbkey="/path/to/adbkey")

# Subsequent connects.  Discover the (random) TLS port via mDNS.
services = discover_connect_services(timeout_s=4.0)
tv = setup(host=services[0].host, port=services[0].port,
           adbkey="/path/to/adbkey", connection_type="tls")

The legacy connection_type="tcp" path (default) is unchanged — existing users on older Android versions or pre-paired devices using adb tcpip need to do nothing.

ADB Intents and Commands

A collection of useful intents and commands can be found here (credit: mcfrojd).

Acknowledgments

This fork is based on python-androidtv by Jeff Irion, which itself is based on python-firetv by happyleavesaoc and the androidtv component for Home Assistant by a1ex4. This fork depends on adb-shell-wifi (a fork of adb-shell, which is based on python-adb) and pure-python-adb.