Skip to main content

A client library for Apple TV and AirPlay devices

Project description

A client library for Apple TV and AirPlay devices

Tests pyatv Actions codecov Code style: black PyPi Package Language grade: Python Gitpod Ready-to-Code Downloads PyPI pyversions License: MIT

This is an asyncio python library for interacting with Apple TV and AirPlay devices. It mainly targets Apple TVs (all generations, including tvOS 15), but also support audio streaming via AirPlay to receivers like the HomePod, AirPort Express and third-party speakers. It can act as remote control to the Music app/iTunes in macOS.

All the documentation you need is available at

What can it do?

Some examples include:

  • Remote control commands
  • Metadata retrieval with push updates
  • Stream files via AirPlay
  • List and launch installed apps

...and lots more! A complete list is available here.

Great, but how do I use it?

All documentation (especially for developers) are available at It is however possible to install with pip and try things out with atvremote:

$ pip install pyatv
$ atvremote scan
       Name: Office
   Model/SW: HomePodMini tvOS 14.7
        MAC: AA:BB:CC:DD:EE:FF
 Deep Sleep: False
 - Protocol: AirPlay, Port: 7000, Credentials: None
 - Protocol: Companion, Port: 49152, Credentials: None
 - Protocol: RAOP, Port: 7000, Credentials: None, Password: None

Or run in a container (x86_64, aarch64, armv7):

docker run -it --rm --network=host atvremote scan

The master tag points to latest commit on the master branch and can be changed to a specific version, e.g. v0.9.0.

I need to change something?

Want to help out with pyatv? Press the button below to get a fully prepared development environment and get started right away!

Open in Gitpod

Shortcuts to the good stuff

To save you some time, here are some shortcuts:

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyatv, version 0.9.7
Filename, size File type Python version Upload date Hashes
Filename, size pyatv-0.9.7.tar.gz (1.6 MB) File type Source Python version None Upload date Hashes View
Filename, size pyatv-0.9.7-py3-none-any.whl (781.7 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page