Rigdio (with RigDJ & Riglevel)

Rigdio is an automated goalhorn/anthem player designed to ease the burden on streamers during cup events, and increase the options available to managers/caretakers for the team's music exports.
RigDJ is the GUI editor for .4ccm files, released along with Rigdio. It allows for graphical editing of anthem and player songs as well as the various conditions you can set for them. If you intend to use more complex instructions for your music, it is recommended you use RigDJ to avoid needing to know the .4ccm formatting for every condition type.
Riglevel is a new tool to normalize the audio levels of music exports. It can scan folders of music exports (or just a single music file if you wish to) and normalize them to a specified dBFS level.

If you're just looking for the program, you can find it here. Information on how to use Rigdio/RigDJ themselves can also be found here.

Build Guide

If you're interested in building Rigdio/RigDJ/Riglevel yourself, here's some info that'll help.

Requirements

• Python 3.8.10 (but any 3.8 version will do) - Programming language required to run and build the code. Do not use the later Python versions (3.9 or later) as they don't natively support Windows 7, which some streamers still use.
• VLC (64-bit) - Contains the media libraries required to play the songs on Rigdio. It is important that you install the 64-bit version of VLC and not 32-bit which is the default download. Click on the arrow next to the Download VLC button and select Installer for 64bit version to download the correct version.
• python-vlc - Python module used for utilising the VLC media library functions to play songs on Rigdio.
• PyYAML - Python module used for parsing the default settings used in Rigdio.
• pyinstaller - Python module used for building the executable files.
• ffmpeg & ffprobe - (Riglevel Only) Multimedia framework required for Riglevel to read audio files. If you don't already have ffmpeg on your computer, you can just grab the executables from the most recent Rigdio release and drop them into this project folder.
• pydub - (Riglevel Only) Python module used by Riglevel to normalize audio of song files in a music export to a uniform level.
• Nuitka - (Riglevel Only) Python module used to build the executable file for Riglevel. This is required due to certain behaviours in pydub being incompatible to build with pyinstaller.

Running the Python file

If you've made any changes to the code and wish to test them out without having to build the whole program, you can run it directly through Command Prompt. Open up Command Prompt in your project folder and enter python (name of code file). This also allows you to see whatever messages/errors Rigdio/RigDJ/Riglevel spits out while it's running, making it easier to debug.

For example, the command line to run Rigdio is

python rigdio.py

Similarly, the command line to run RigDJ is

python rigdj.py

Building Rigdio/RigDJ

Once you've fully made and tested out your code changes, you can start building the executables. Simply run the batch file for whichever executable you wish to build (compile-rigdio.bat for Rigdio, compile-rigdj.bat for RigDJ) and wait for the process to finish. Assuming the build process went smoothly and without error, you will see a couple new files and folders. The built executable will be stored in the dist folder for you to test out yourself.
TIP: Replace the executable in the Rigdio release folder with your own built executable before testing it out to have a more accurate runtime environment (Rigdio/RigDJ will use the plugins inside the release folder instead of the ones installed in your system).

If you're on Mac/Linux then you will need to run the command line manually; Fortunately it's short and only a single line.
The command line to build the Rigdio executable is

pyinstaller -F --noconsole --icon=rigdio.ico rigdio.py

And the command line to build the RigDJ executable is

pyinstaller -F --noconsole rigdj.py

Building Riglevel

For now, I recommend not trying to compile Riglevel yourself unless you find that you need to. In addition to needing to use a different Python compiler to build Riglevel, there are some changes that need to be made backend in the pydub module itself to prevent some undesired behaviour on Riglevel's part. I plan to write up a proper solution to this in the future so that it isn't such a pain to compile Riglevel.

If you do want to compile it still, you can run this command line to do so:

python -m nuitka --mode=onefile --windows-console-mode=disable --enable-plugin=tk-inter riglevel.py

If you're having troubles with compilation, disable Windows Defender before trying again.