audioFX - A Python Library for Audio Effects

1. Description

This python package contains functionality to apply a variety of effects to audio data.
GitHub Repository | PyPi Repository

2. Installation

Install via pip:

pip install audioFX

3. Get started

Here is a basic example on how to load a wave file, apply some effects and save the resulting audio:

from audioFX.Fx import Fx
from librosa import load
import soundfile

infile = 'test.wav'
outfile = 'my_processed_audio_file.wav'

x, sr = load(infile)

fx = Fx(sr)

fx_chain = {"tremolo": 0.8,
              "flanger": 0.2
              }

optional_parameters = {"flanger_frequency": 0.75,
                         "flanger_depth": 9.75,
                         "flanger_delay": 0.9375
                         }

y = fx.process_audio(x, fx_chain, optional_parameters)
soundfile.write(outfile, y, sr)

First, with "from audioFX.Fx import Fx" you import the FX processor of the audioFX library.
Instantiate the FX processor with fx = Fx(sr), where sr is the samplerate of the audio you work with.

You define an effect chain through a dictionary. In the example above, the audio is first fed through a tremolo module, and then through a flanger module. The values that are assigned to the single effects correspond to the dry/wet portion of the effect. A value of 0 will result in the effect turned completely off, while 1 will result in a completely processed signal. The effects are applied in the order in which you defined them in that dictionary. See the next section for all possible effects.

You can (but don't have to) define an additional dictionary in which you pass further parameters to your effects chain. All possible parameters are listed in the next section.

Apply the effect chain by calling the process_audio function as shown above.

4. Implemented Effects

Currently, audio-fx supports the effect types listed in the table below. We are actively about to include more effects, please drop an issue if you are interested in a particular one.

As described above, you can instantiate a dictionary to define further parameters for the effect chain. Possible parameters are listed below. For parameters that are not specified, the default will be taken.

5. Acknowledgements

Parts of the code are derived from https://github.com/wybiral/python-musical and https://github.com/gened1080/guitar-effects.