https://sr.ht/~arsen/alsa_rnnoise/

sourcehut

Log in -- Register

~arsen/alsa_rnnoise

  * summary
  * source
  * mailing list
  * tickets

RNNoise based noise removal plugin for ALSA

10119cb ci: add failure notifications

~arsen pushed to ~arsen/alsa_rnnoise git

3 days ago

757e162 README: expand sales pitch

~arsen pushed to ~arsen/alsa_rnnoise git

5 days ago
View project feed 

alsa_rnnoise

builds.sr.ht status

RNNoise based noise removal plugin for ALSA

alsa_rnnoise provides ALSA with a high-performance denoiser in
real-time, perfect for VoIP conferences and calls, streaming,
screencasting, and chatting with friends. To hear a demo of RNNoise
in action, on your voice or a voice sample, see this page.

Building

alsa_rnnoise depends on alsa-lib and rnnoise. You can get development
files for ALSA through a package called libasound2-dev on Debian, 
alsa-lib-devel on Fedora, or media-libs/alsa-lib on Gentoo. RNNoise
might require manual installation, since it is not packaged by many
distributions. See the RNNoise README

After installing RNNoise and ALSA, building alsa_rnnoise is a
standard meson process:

$ meson build  # generates the ``build'' directory
$ ninja -C build
$ sudo ninja -C build install

Build options

Build options are specified via -Doption=value flags to the meson
invocation.

plugin_dir
    ALSA plugin directory location, usually /usr/lib/alsa-lib.
    Depends on ALSA build time configuration
static_rnnoise
    Whether to static link RNNoise. Enabled by default since RNNoise
    lacks stable releases.

Usage

The plugin has no settings other than the slave PCM. There is
currently a known bug where if something requests to know the
accepted sample rate interval, the plugin reports an empty interval.
Please make sure to specify the sample rate as exactly 48000 as seen
in the rnnoise PCM below. I'm currently not aware of a way to fix
this with ALSAs external plugin API.

pcm.urnnoise {
    type rnnoise
    slave.pcm "sysdefault"
}

pcm.rnnoise {
    type plug
    slave {
        rate 48000
        pcm "urnnoise"
    }
}

pcm.!default {
    type asym
    playback.pcm "cards.pcm.default"
    capture.pcm "rnnoise"
}

License

alsa_rnnoise is Free software licensed under the GNU General Public
License, version 3.