/Traccy

Traccy is a python application which captures a twitch stream's audio, and sends the data to ACRCloud, in an attempt to ID songs playing on a stream.

Primary LanguageDockerfileOtherNOASSERTION

Traccy

License: CC BY-NC 4.0 Build Status GitHub issues GitHub forks GitHub stars GitHub contributors Docker Pulls

Description

Traccy (pronounced Trackie) is a python script that allows a user to capture a live stream, and automatically parse the audio data from the stream, submitting it to ACRCloud for recognition.

The idea is for this project to create a "Now Playing" type of integration that can be used elsewhere.

License notes

The CC-BY-NC license prohibits commercial use. This script may be used by streamers in the community or affiliates of the streaming community to produce effective works that help streamers increase the quality of their work. It is NOT intended to be used to aide in the creation of DMCA notices, lawsuits, or otherwise negatively affect a streamer's production.

What does it use?

Development

Getting started

After cloning and cd'ing to the repo, create a python virtualenv

virtualenv env

And activate it (or re-activate if you're returning)

source ./env/bin/activate

Install the requirements...

pip3 install -r requirements.txt

And you're ready to write!

If you update the python packages in your venv, you probably should freeze the venv to the requirements file, like this: pip3 freeze > requirements.txt

Docker

Need to rebuild the conatiner? Easy: docker build -t alex4108/traccy .

Want to run the app in-container? docker run -t alex4108/traccy

Useful links

Grabbing the twitch stream

ACRCloud readme

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request