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.6.tar.gz (23.4 kB view details)

Uploaded Source

Built Distribution

goxlr-1.4.6-py3-none-any.whl (25.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: goxlr-1.4.6.tar.gz
  • Upload date:
  • Size: 23.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.17

File hashes

Hashes for goxlr-1.4.6.tar.gz
Algorithm Hash digest
SHA256 49190aeb89dcfebe3f1459992f7902c786f257fbb6e776c89be1806bee1b41cd
MD5 4f64b68ee18eb7c0aa6801e592a0c155
BLAKE2b-256 e104e32dc4a0f12c323b2757e2c100fd18faa6a8b200ad34984fa8c72657e5cb

See more details on using hashes here.

File details

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

File metadata

  • Download URL: goxlr-1.4.6-py3-none-any.whl
  • Upload date:
  • Size: 25.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.17

File hashes

Hashes for goxlr-1.4.6-py3-none-any.whl
Algorithm Hash digest
SHA256 892bf910ce8c9f170e2c215dfc8bf11d786e78dcd4db54f5f09c1214414c04b4
MD5 83d1855dd4a084e600eeed32557d64b6
BLAKE2b-256 b5f0680290175816b03a9294c8fcb9e6bea74bd6732e28fc304bc1e75c3233eb

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