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

A python wrapper for the API of the open-source GoXLR software alternative, GoXLR Utility, that uses asyncio.

Features

  • Asynchronous connection to the GoXLR utility daemon
  • Almost 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 ChannelName

async def main():
    async with GoXLR() as xlr:
        print(await xlr.ping())

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()
    xlr.connect()
    print(await xlr.ping())
    xlr.close()

Documentation

Coming soon. For now, please refer to goxlr.py to see all of the daemon and GoXLR commands, and refer to types.py to see all of the enums. You may find it very useful to have an IntelliSense-style plugin in your IDE.

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.

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.0.3.tar.gz (12.0 kB view hashes)

Uploaded Source

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