Welcome to Automix, an automated mixing/DJing program. Own electronic music? Prefer listening to a continous mix rather than individual tracks? If so, Automix could be useful to you.

Automix takes a directory containing audio files as input and outputs a MP3 file containing a continous mix of the input tracks, users can control the charachteristics of the output mix by passing in various arguements. Currently this is biased towards a mixing style popular for DnB/Jungle/Breakbeat music.

Refer to the developer documentation for a detailed description of the operation of Automix.

Currently only 64 bit Linux machines are supported. Also only mp3 and m4a format input and output files are supported. The following guide has been tested using Ubuntu 20.04.

The following software is required to build and run Automix:

• git
• make
• cmake
• g++ (At least version 8)
• libpthread
• libavutil
• libavformat
• libavcodec

These can easily be installed using a package manager, for example apt:

> sudo apt update
> sudo apt install git make cmake g++ libavformat-dev

Clone the project and it's submodules, then use make to build it:

> git clone https://github.com/walkywalker/automix --recurse-submodules
> cd automix
> make

Automix requires the environment variable AUTOMIX_HOME to be set. The simplest method is to set it as the top-level directory of the repository. However it can be set to any directory, as long as $AUTOMIX_HOME/log and $AUTOMIX_HOME/tmp exist.

The Automix binary will be in the top-level directory after building, it can be run using:

> ./automix -i <path of input directory> -o <path of output file> -m

Note the output file must have the .mp3 extension. The -m argument enables multi-threading for track analysis. Information on the other arguments can be accessed by running ./automix -h. Or, for more detailed descriptions, refer to the developer documentation.

FFMPEG outputs information to STDERR, therefore it is usually most useful to forward STDOUT to a file.

• Matthew Walker ([email protected]) - Initial work

Contributions welcome, refer to the developer documentation for a detailed description of the state of the project. Feel free to contact me via email to discuss changes.

This project is licensed under the GNU GPLv2 License - see the COPYING file for details.

Note this project contains modified source code from QM Vamp Plugins, which are also licensed under GNU GPLv2.

• qm-dsp (Queen Mary University DSP)
• fidlib (IIR/FIR filters)
• Secret Rabbit Code (Sample rate conversion)
• pugixml (XML processing)
• Vamp Plugins (Audio plugin API)

• QM Vamp Plugins (Audio feature extraction plugins)
• Mixxx (DJ software with MIDI support)