Livekit RNNoise Processor

A Livekit processor using RNNoise to suppress noise in input microphone streams.

This processor will resample incoming audio to 48000hz, process the audio with RNNoise, then resample the audio back to the input sample rate. If the incoming audio is already 48000hz, no resampling will occur. If the audio must be resampled, RNNoise will not perform as well, but most noise will still be suppressed. This processor only operates on a single channel, so any microphone data processed will be output as mono.

Memory leak

This processor is affected by the chromium memory leak documented here. Chromium based browsers will leak about 400kb of memory per processor created.

Building WASM Module and Worklet

To build the WASM RNNoise module and Worklet, run

pnpm i

pnpm build:worklet

This will build the worklet and wasm file into the dist directory which should then be hosted by a CDN.

Usage

import { DenoiseTrackProcessor } from "livekit-rnnoise-processor";

track.setProcessor(new DenoiseTrackProcessor());

By default, this library uses the worklet hosted by this repo using jsdeliver. For security reasons, you can update the CDN location of the worklet the processor uses by passing an options struct with workletCDNURL referencing a url. The URL must end in a slash, and the cdn must contain both DenoiserWorklet.js and rnnoise.wasm.

import { DenoiseTrackProcessor } from "livekit-rnnoise-processor";

track.setProcessor(new DenoiseTrackProcessor({ workletCDNURL: "https://example.com/file/serve/location/" }));