A rhythmbox plugin for digital room correction.

As the room in which audio systems play influences the sound quite a bit the performasnce of speaker systems is usually degraded. Fortunately there are mechanisms that compensate for that: DRC (Digital Room Correction). It works in a way that a defined signal (log sweep) is played and its response is messured. From this the impulse response can be calculated to correct the influence of the room. For a more advanced explanation google e.g. for the DRC tool documentation( "DRC: Digital Room Correction docu" ).

It can handle 32bit float mono filters as e.g. produced by PORC (search PORC on github) or DRCDesigner (also on github) and allows for one measuring/filter creation as well. Once the filter (from the plugin or external tools) is produced it can be loaded with this plugin to alow for music correction during play.

There are 3 steps in the process of DRC which can be executed independently. If no other tools are used (e.g. DRCDesigner, Room EQ Wizard, Dirac, Accurate) the complete steps from measurment, filter calculation and fillter usage can be done by this plugin. In case of strating from scratch just exectute all 3 stages of the procedure. Each step produces the output of the next step.

measuring plays a configurable sine sweep and measures its room response. For that purpose calibrated measurment equipment is needed. For DRC measurements it is recomended to have the microphone directed towards the speakers with its front centered at the usual listening position (middle of the head). I use a calibrated Behringer ECM8000 and a Focusrite 2i2 USB audio interface. The recording device needs to suport recording in the 32bit float format (S32_LE). All other devices will be shown but the measure-button will stay disabled. In case you already have a recorded Impulse response just proceed with step 2 (calculating your filter). You need to select the proper input/output device and for input the correct channel where your microphone is connected. The recorded signal is monitored for quality and a dialog is shown with the evaluation results after measurement.

output: impulse response file which can be loaded to the filter correction

It is advisable to start sweep play with lower volumes to not damage the equipment or you ears! The volume can be slowly turned up until a maximum is reached that does not make the furniture in your room vibrate as this will also cause artefacts.

Generally the longer and the louder the measurmenet is done the better the results (signal to noise ratio). Usually a 20s sweep gives good results already.

Calculating the filter depends on installed tools. Supported at the moment are PORC and DRC. Any way of created impulse response audio file can be used: either created by previous measurement step or by a another external tool.

output: a 32 bit audio file containing the filter than can be loaded for the room correction

load filter and enjoy :) --> no further dependencies

for installation just copy all files to ${HOME}/.local/share/rhythmbox/plugins/DRC or copy the complete package to any folder and install as super user with "make install".

only fraction of DRC configurable capabilities is there, but files are available for edit in the plugin folder (for DRC adapt erb44100.drc)

depends on packages: sox, alsa-utils (uses aplay, arecord) for installation on Ubuntu: sudo apt-get install alsa-utils sox

DRC :  depends on packages: sox, drc : sudo apt-get install sox drc
PORC : depends on packages: sox, porc
       for porc: sudo apt-get install python-numpy, python-scipy, python-matplotlib
        PORC can be found on github. To use it just download the complet package an get it running by installing all dependencies (mostly python libs). The plugin expects porc to be installed in
        the plugin folder under a separate folder (./porc/porc.py).

for those with some courage to try some new functionality: DRC supports multi channel correction, meaning a separate measure/filter per audio channel. To support this gstreamer plugins-good need to be patched as long as this change gets not a part of the gstreamer-plugins-good (see gst-plugins-good-patch folder) - I use it this way myself on Ubuntu 14.04/15.04.

1) After measuring and filter calculation the filter can be directly applied. On some distributions this can cause audible issues and does not work. This can be worked around by just restarting rhythmbox.

2) for some reasons RB is not able to play continously once the FIR filter is set. A workaround got introduced that resets each track once started. That causes small gaps which are audible once continous tracks with gapless transition are played. Working on it :). One immediate fix is to jus use the brutefir convolution approach

python3 DRCStandalone.py

- better documentation

- 5.1 drc filter creation seems not yet to produce good result for the LFE channel, even with adapted target curve (for now just disabled correction for the LFE in the brutefir config)

- 5.1 measurement only supports digital output as AC3. TODO: also offer option for multichannel analog interfaces

- read device capabilities rather from /proc/asound than using aplay/arecord

Thanks to all the great guys doing amazing SW stuff in the web! This tool is just trying to put it together in an easy usable way.