kodi-adsp/adsp.freesurround

FreeSurround ADSP-Addon for Kodi

CI Testing

• Tarvis-CI for OS X, iOS, Linux
• AppVeyor for Windows
• Code analyses for Linux

FreeSurround AudioDSP add-on for [Kodi] (http://kodi.tv)

FreeSurround is based on foo_dsp_fsurround from pro_optimizer for foobar2000 0.9.x.

This add-on is the equivalent of your hi-fi receiver's Dolby ProLogic II button (except that it uses a different algorithm) for Kodi.

It's purpose is to decode surround information from your stereo music (including mp3) to produce multichannel output.

It works with any stereo music containing surround information like the following compatible coding schemes:

• Dolby Surround
• Dolby ProLogic
• Dolby ProLogic II
• SRS CircleSurround
• SRS CircleSurround II
• DTS Neo:6
• Lexicon Logic7
• Stereo Quadrophonic (SQ)
• Quadrophonic Stereo (QS)

Change LFE output settings

Currently you have to edit the generated "ADSPFreeSurrAddonSettings.xml" changed by hand to edit the cut off frequencies of the LFE channel. Set bassredirection to true and change the settings. E.g.

        <bassredirection>true</bassredirection>
        <lowcutoff>40.000000</lowcutoff>
        <highcutoff>90.000000</highcutoff>

Normally it's a part of the AudioDSP post processing system that's why it is not directly editable from a Kodi window!

Build instructions for Kodi's binary add-ons

When building the addon you have to use the correct branch depending on which version of Kodi you're building against. For example, if you're building the Jarvis branch of Kodi you should checkout the Jarvis branch of this repository. Addon releases are also tagged regularly.

For further instructions replace {addon-id} and {org} with the repository- and the Github organisation-name. E.g. https://github.com/kodi-adsp/adsp.basic.git results in {addon-id}=adsp.basic and {org}=kodi-adsp

With the following instructions the add-on files will be placed in ../../xbmc/addons. Consequently this adds a system add-on, which can be used direclty if you build Kodi from source.

Linux

1. git clone https://github.com/xbmc/xbmc.git
2. git clone https://github.com/{org}/{addon-id}.git
3. cd {addon-id} && mkdir build && cd build
4. cmake -DADDONS_TO_BUILD={addon-id} -DADDON_SRC_PREFIX=../.. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=../../xbmc/addons -DPACKAGE_ZIP=1 ../../xbmc/project/cmake/addons
5. make

Windows

Use the visual studio command line or run call "%VS120COMNTOOLS%..\..\VC\bin\vcvars32.bat"

1. git clone https://github.com/xbmc/xbmc.git
2. git clone https://github.com/{org}/{addon-id}.git
3. cd {addon-id} && mkdir build && cd build
4. cmake -G "NMake Makefiles" -DADDONS_TO_BUILD={addon-id} -DADDON_SRC_PREFIX=../.. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=../../xbmc/addons -DPACKAGE_ZIP=1 ../../xbmc/project/cmake/addons
5. cmake --build "%cd%" --target "{addon-id}"

Useful links

• [Kodi's PVR user support] (http://forum.kodi.tv/forumdisplay.php?fid=167)
• [General binary add-on development] (http://forum.kodi.tv/forumdisplay.php?fid=26)
• [Kodi Core development support] (http://forum.kodi.tv/forumdisplay.php?fid=93)
• [Kodi AudioDSP development support] (http://forum.kodi.tv/forumdisplay.php?fid=235)
• [Kodi Screensavers and Visualisations development support] (http://forum.kodi.tv/forumdisplay.php?fid=38)
• [Kodi PVR development support] (http://forum.kodi.tv/forumdisplay.php?fid=136)

---

License

GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007

adsp.freesurround's Issues

No redirection of bass to LFE (.1) channel

Hi,

I've set my speaker output layout to 5.1 in Kodi, but bass is not redirected to my subwoofer.
In the configuration dialog of the original foobar2000 dsp component this is covered via a seperate option, which is not available in Kodi.

Make LFE options available in GUI

Please make all LFE options available in Addon-options GUI:

• Redirect bass to LFE (.1) channel
• Bass transition lower (Hz)
• Bass transition upper (Hz)

Thanks :-)

The comment in the link makes no sense, I don't know how to use the code

adsp.freesurround/src/FreeSurroundDecoder.h

Line 82 in 03ec089

* @param blocksize Granularity at which data is processed by the decode() function.

    * @param blocksize Granularity at which data is processed by the decode() function.
   *           Must be a power of two and should correspond to ca. 10ms worth of single-channel
   *           samples (default is 4096 for 44.1Khz data). Do not make it shorter or longer
   *           than 5ms to 20ms since the granularity at which locations are decoded
   *           changes with this.

10ms at 44100 is 441, 4096 is 100ms, so what block size should I use? Does it really need to be a power of 2? It doesn't seem like it needs, as long as it's a multiple of 2 the code looks and works fine (not tested deeply).

create "releases" for each version.

Please tag versions at the correct commits so we can reference them for building.
This should be done before the platform rename merge

Bass redirection is wrong?

Should this be: m_LowCutoff = v/(m_Samplerate/2.0)*m_BufferSizeHalf ?

adsp.freesurround/src/FreeSurroundDecoder.cpp

Line 363 in 03ec089

m_LowCutoff = v/m_Samplerate/2.0*m_BufferSizeHalf;