A Python wrapper for the GoXLR Utility API.
Project description
GoXLR Utility API Python Wrapper
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 49190aeb89dcfebe3f1459992f7902c786f257fbb6e776c89be1806bee1b41cd |
|
MD5 | 4f64b68ee18eb7c0aa6801e592a0c155 |
|
BLAKE2b-256 | e104e32dc4a0f12c323b2757e2c100fd18faa6a8b200ad34984fa8c72657e5cb |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 892bf910ce8c9f170e2c215dfc8bf11d786e78dcd4db54f5f09c1214414c04b4 |
|
MD5 | 83d1855dd4a084e600eeed32557d64b6 |
|
BLAKE2b-256 | b5f0680290175816b03a9294c8fcb9e6bea74bd6732e28fc304bc1e75c3233eb |