Introduction
This is a python module aiming to interact with the Emby Media Server (http://emby.media) api.
Code is licensed under the MIT license.
Version Change
Version 1.0+ utilizes python's asyncio module to perform communication with the emby server over websockets and http. Polling is no longer required to recieve device updates and many callback options are available. Code is compatible with aiohttp 3.0 and above.
Version 0.2 and below utilized the requests library and provided a simplistic interface to the emby api.
If you do not wish to incorporate the new ayncio platform please utilize Version 0.2 via it's git tag or as found in the "original" branch on this repository.
Requirements
Python 3.6 or greater
Mostly standard libraries are used:
- json
- uuid
- asyncio
- aiohttp >= 3.0
- async_timeout
Installation
pip install pyemby
Getting Started
In Use
This library was created primarily for use with Home-Assistant. The source code for the "Emby" media_player component is a full example of library usage.
Basic Example
from pyemby import EmbyServer
emby = EmbyServer(host, api_key, port=8096, ssl=False, loop=None)
emby.add_new_devices_callback(device_update_callback)
emby.add_stale_devices_callback(device_removal_callback)
emby.start()