Skip to main content

Provides a python interface to interact with Roon

Project description

python-roon

python library to interface with the Roon API (www.roonlabs.com)

Full documentation will follow asap See the tests folder for some more code examples.

Some example code:

from roonapi import RoonApi
appinfo = {
        "extension_id": "python_roon_test",
        "display_name": "Python library for Roon",
        "display_version": "1.0.0",
        "publisher": "marcelveldt",
        "email": "mygreat@emailaddress.com"
    }

# host can be None if you want to use discovery - but this sometimes returns the local machine, not the real roon server
host = "192.168.1.x"

# Can be None if you don't yet have a token
token = open('mytokenfile').read()

roonapi = RoonApi(appinfo, token)

# get all zones (as dict)
print(roonapi.zones)

# get all outputs (as dict)
print(roonapi.outputs)

# receive state updates in your callback
roonapi.register_state_callback(my_state_callback)


# save the token for next time
with open('mytokenfile', 'w') as f:
    f.write(roonapi.token)

Project details


Download files

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

Source Distribution

roonapi-0.0.26.tar.gz (17.4 kB view details)

Uploaded Source

Built Distribution

roonapi-0.0.26-py3-none-any.whl (18.8 kB view details)

Uploaded Python 3

File details

Details for the file roonapi-0.0.26.tar.gz.

File metadata

  • Download URL: roonapi-0.0.26.tar.gz
  • Upload date:
  • Size: 17.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.4 CPython/3.7.9 Linux/5.4.0-1031-azure

File hashes

Hashes for roonapi-0.0.26.tar.gz
Algorithm Hash digest
SHA256 f86375d7bc9086af52ec5558e8e9ed110f1306b0acca07de9112267afbb115ee
MD5 507c43cf674ee02ff601d58420f9b222
BLAKE2b-256 51669c3dbc6ef79913b6319e3d593bc156e687362e37e3efd6d043a7db29e3d1

See more details on using hashes here.

File details

Details for the file roonapi-0.0.26-py3-none-any.whl.

File metadata

  • Download URL: roonapi-0.0.26-py3-none-any.whl
  • Upload date:
  • Size: 18.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.4 CPython/3.7.9 Linux/5.4.0-1031-azure

File hashes

Hashes for roonapi-0.0.26-py3-none-any.whl
Algorithm Hash digest
SHA256 da35b672603bb3e3109b14b3c5b7ea26edb954bdb70079b1339a9cd7c963a289
MD5 72c81e3e9b2f9c6b99c0ee7e1b7d0d31
BLAKE2b-256 86e47ea133cc9b20bd2bcf7886ee2e9038a24ebcdd2a054f27cb24847877fbce

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page