This is a python module aiming to interact with the Emby Media Server (https://emby.media) api.

Code is licensed under the MIT license.

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.

Python 3.6 or greater

Mostly standard libraries are used:

• json
• uuid
• asyncio
• aiohttp >= 3.0
• async_timeout

pip install pyemby

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.

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()