Schlaubischlump / shairport-metadatareader-python

A shairport-metadata-reader package written in Python, which supports reading the metadata from the pipe file, the UDP-server and the MQTT server if configured.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Shairport-Metadatareader-Python

What is this?

This python (>= 2.7 or >= 3.4) library includes a package shairportmetadatareader which parses the airplay metadata from the shairport-sync pipe, the specified shairport-sync udp server or the shairport-sync mqtt server. In addition, it includes a remote sub-package to remotely control the Airplay client.

Requirements

  • enum34 pip install enum34 (Python 2 only)
  • requests pip install requests
  • zeroconf pip install zeroconf (use version 0.19.1 or lower for python 2)
  • kivy pip install kivy or eventdispatcher pip install eventdispatcher

optional:

Installation

pip install git+https://github.com/Schlaubischlump/shairport-metadatareader-python

Bugs

  • I don't know. Let me know!
    ...

Example (Read Metadata)

from time import sleep
from shairportmetadatareader import AirplayUDPListener #, AirplayPipeListener

def on_track_info(lis, info):
    """
    Print the current track information.
    :param lis: listener instance
    :param info: track information
    """
    print(info)

listener = AirplayUDPListener() # You can use AirplayPipeListener or AirplayMQTTListener
listener.bind(track_info=on_track_info) # receive callbacks for metadata changes
listener.start_listening() # read the data asynchronously from the udp server
sleep(60) # receive data for 60 seconds
listener.stop_listening()

Events

Beside the current track information you can listen for the following events in the same manner as in the above example:

  • connected: True if a device is connected, otherwise false.
  • dacp_id: Current DACP-ID of connected device.
  • active_remote: Active remote token used to remote control the airplay device.
  • has_remote_data: True if the dacp_id and active_remote token are available
  • client_name: Name of the airplay client e.g John's iPhone.
  • playback_state: The current playback state as string (play, pause, stop).
  • track_info: Information about the currently playing track.
  • playback_progress: List consisting of two elements: current playback position, duration
  • artwork: Path to the artwork file of the current track stored in a temporary directory.
  • user_agent: Airplay user agent. e.g. iTunes/12.2 (Macintosh; OS X 10.9.5)
  • airplay_volume: Normalized volume between 0 and 1 send by the source (-1 for mute).
  • volume: Playback volume as normalized float value between 0 and 1.
  • mute: True if the airplay device is muted, otherwise False.
  • item: Received item from shairport-sync pipe or server. Use this if you need more fine-grained control to react to a specific ssnc or core code.

For more advanced examples take a look at the examples folder.

Special thanks goes to

About

A shairport-metadata-reader package written in Python, which supports reading the metadata from the pipe file, the UDP-server and the MQTT server if configured.

License:GNU General Public License v3.0


Languages

Language:Python 100.0%