Skip to main content

A Python wrapper for the GoXLR Utility API.

Project description

GoXLR Utility API Python Wrapper

License PyPI version PyPI - Downloads GitHub issues Documentation Status

A python wrapper for the API of the open-source GoXLR software alternative, GoXLR Utility, that uses asyncio. Disclaimer: This project is not affiliated with the GoXLR brand or TC-Helicon in any way, shape, or form. This is a third-party package made for fun and educational purposes.

Features

  • Asynchronous connection to the GoXLR utility daemon
  • All methods have been translated to Python
  • Handy enumerators for everything
  • Very simple and easy to get started

Installation

pip install goxlr

Getting Started

Here's some sample code to get started with this package that pings the utility's daemon.

import asyncio

from goxlr import GoXLR
from goxlr.types import Fader, Channel

async def main():
    async with GoXLR() as xlr:
        await xlr.set_fader(Fader.A, Channel.Headphones)
        await xlr.set_volume(Channel.Headphones, 127)

if __name__ == "__main__":
    asyncio.run(main())

You may have noticed that we use with to manage the connection to the GoXLR. You may also wish to use the more traditional open and close methods which is acceptable too.

async def main():
    xlr = GoXLR()
    await xlr.open()

    ping = await xlr.ping()
    print(ping)  # Ok

    await xlr.close()

Contributing

Coming soon. As there isn't a CONTRIBUTING.md yet, please try to emulate the style of the rest of the code. Using snake_case and descriptive method argument names with type hints wherever possible.

Documentation

Please visit the documentation for more information on how to use this package.

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

goxlr-1.4.8.tar.gz (23.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

goxlr-1.4.8-py3-none-any.whl (25.2 kB view details)

Uploaded Python 3

File details

Details for the file goxlr-1.4.8.tar.gz.

File metadata

  • Download URL: goxlr-1.4.8.tar.gz
  • Upload date:
  • Size: 23.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.22

File hashes

Hashes for goxlr-1.4.8.tar.gz
Algorithm Hash digest
SHA256 1a10ef1d16c5d160e870b9dd109d381cd8ced1baaabb037acdc51ea87e8e3c7d
MD5 091acce66d9f3a16a868e83f6730c81b
BLAKE2b-256 dcb3f06c297246582d48451183ba5bae9d280477db33e34f407a8879a785e22c

See more details on using hashes here.

File details

Details for the file goxlr-1.4.8-py3-none-any.whl.

File metadata

  • Download URL: goxlr-1.4.8-py3-none-any.whl
  • Upload date:
  • Size: 25.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.22

File hashes

Hashes for goxlr-1.4.8-py3-none-any.whl
Algorithm Hash digest
SHA256 d7fd9075da85224fbd029a7b9573fb8b60253914ba82c96c51f70437aba88c0b
MD5 f4efb7fdf25da15eb7ed16310fab4836
BLAKE2b-256 74899e3be9fb149a8302bb788140ae3e4bed29975b3b0fd6656f320603f4f521

See more details on using hashes here.

Supported by

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