Audio Processing and Effect Blocks for .NET¶

Media Blocks SDK .Net

VisioForge Media Blocks SDK provides a pipeline-based approach to audio processing in C# and .NET. Connect audio blocks — converters, resamplers, mixers, equalizers, effects, and analyzers — to build real-time audio processing chains for your applications. Each block has typed input/output pins that you wire together using pipeline.Connect().

For detailed audio effect parameters and properties, see the Audio Effects Reference.

All blocks are cross-platform and work on Windows, macOS, Linux, iOS, and Android.

Basic Audio Processing¶

Audio Converter¶

The audio converter block converts audio from one format to another.

Block info¶

Name: AudioConverterBlock.

Settings¶

No configurable parameters. Automatically negotiates and converts audio formats between connected elements.

GStreamer Element: audioconvert

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->AudioConverterBlock;
    AudioConverterBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var audioConverter = new AudioConverterBlock();
pipeline.Connect(fileSource.AudioOutput, audioConverter.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(audioConverter.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Audio Resampler¶

The audio resampler block changes the sample rate of an audio stream.

Block info¶

Name: AudioResamplerBlock.

Settings¶

Configure via AudioResamplerSettings:

GStreamer Element: audioresample

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->AudioResamplerBlock;
    AudioResamplerBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

// Resample to 48000 Hz, stereo
var settings = new AudioResamplerSettings(AudioFormatX.S16LE, 48000, 2);
var audioResampler = new AudioResamplerBlock(settings);
pipeline.Connect(fileSource.AudioOutput, audioResampler.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(audioResampler.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Audio Timestamp Corrector¶

The audio timestamp corrector block can add or remove frames to correct input stream from unstable sources.

Block info¶

Name: AudioTimestampCorrectorBlock.

Settings¶

Configure via AudioTimestampCorrectorSettings:

GStreamer Element: audiorate

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->AudioTimestampCorrectorBlock;
    AudioTimestampCorrectorBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var settings = new AudioTimestampCorrectorSettings();
var corrector = new AudioTimestampCorrectorBlock(settings);
pipeline.Connect(fileSource.AudioOutput, corrector.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(corrector.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Volume¶

The volume block allows you to control the volume of the audio stream.

Block info¶

Name: VolumeBlock.

Settings¶

GStreamer Element: volume

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->VolumeBlock;
    VolumeBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

// Volume: 0.0 (silence) to 1.0 (normal) or higher (amplification)
var volume = new VolumeBlock(0.8);
pipeline.Connect(fileSource.AudioOutput, volume.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(volume.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Audio mixer¶

The audio mixer block mixes multiple audio streams into one. Block mixes the streams regardless of their format, converting if necessary.

All input streams will be synchronized. The mixer block handles the conversion of different input audio formats to a common format for mixing. By default, it will try to match the format of the first connected input, but this can be explicitly configured.

Use the AudioMixerSettings class to set the custom output format. This is useful if you need a specific sample rate, channel layout, or audio format (like S16LE, Float32LE, etc.) for the mixed output.

Block info¶

Name: AudioMixerBlock.

Settings¶

Configure via AudioMixerSettings:

Runtime methods:

GStreamer Element: audiomixer

The sample pipeline¶

graph LR;
    VirtualAudioSourceBlock#1-->AudioMixerBlock;
    VirtualAudioSourceBlock#2-->AudioMixerBlock;
    AudioMixerBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var audioSource1Block = new VirtualAudioSourceBlock(new VirtualAudioSourceSettings());
var audioSource2Block = new VirtualAudioSourceBlock(new VirtualAudioSourceSettings());

// Configure the mixer with specific output settings if needed
// For example, to output 48kHz, 2-channel, S16LE audio:
// var mixerSettings = new AudioMixerSettings() { Format = new AudioInfoX(AudioFormatX.S16LE, 48000, 2) };
// var audioMixerBlock = new AudioMixerBlock(mixerSettings);
var audioMixerBlock = new AudioMixerBlock(new AudioMixerSettings());

// Each call to CreateNewInput() adds a new input to the mixer
var inputPad1 = audioMixerBlock.CreateNewInput();
pipeline.Connect(audioSource1Block.Output, inputPad1);

var inputPad2 = audioMixerBlock.CreateNewInput();
pipeline.Connect(audioSource2Block.Output, inputPad2);

// Output the mixed audio to the default audio renderer
var audioRenderer = new AudioRendererBlock();
pipeline.Connect(audioMixerBlock.Output, audioRenderer.Input);

await pipeline.StartAsync();

Controlling Individual Input Streams¶

You can control the volume and mute state of individual input streams connected to the AudioMixerBlock. The streamIndex for these methods corresponds to the order in which the inputs were added via CreateNewInput() or CreateNewInputLive() (starting from 0).

• Set Volume: Use the SetVolume(int streamIndex, double value) method. The value ranges from 0.0 (silence) to 1.0 (normal volume), and can be higher for amplification (e.g., up to 10.0, though specifics might depend on the underlying implementation limits).
• Set Mute: Use the SetMute(int streamIndex, bool value) method. Set value to true to mute the stream and false to unmute it.

// Assuming audioMixerBlock is already created and inputs are connected

// Set volume of the first input stream (index 0) to 50%
audioMixerBlock.SetVolume(0, 0.5);

// Mute the second input stream (index 1)
audioMixerBlock.SetMute(1, true);

Dynamic Input Management (Live Pipeline)¶

The AudioMixerBlock supports adding and removing inputs dynamically while the pipeline is running:

• Adding Inputs: Use the CreateNewInputLive() method to get a new input pad that can be connected to a source. The underlying GStreamer elements will be set up to handle the new input.
• Removing Inputs: Use the RemoveInputLive(MediaBlockPad blockPad) method. This will disconnect the specified input pad and clean up associated resources.

This is particularly useful for applications where the number of audio sources can change during operation, such as a live mixing console or a conferencing application.

Platforms¶

Windows, macOS, Linux, iOS, Android.

Audio sample grabber¶

The audio sample grabber block allows you to access the raw audio samples from the audio stream.

Block info¶

Name: AudioSampleGrabberBlock.

Settings¶

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->AudioSampleGrabberBlock;
    AudioSampleGrabberBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var audioSampleGrabber = new AudioSampleGrabberBlock();
audioSampleGrabber.SampleGrabbed += (sender, args) =>
{
    // Process audio samples
    // args.AudioData - audio samples
    // args.AudioFormat - audio format
};
pipeline.Connect(fileSource.AudioOutput, audioSampleGrabber.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(audioSampleGrabber.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Audio Effects¶

Amplify¶

Block amplifies an audio stream by an amplification factor. Several clipping modes are available.

Use method and level values to configure.

Block info¶

Name: AmplifyBlock.

Settings¶

AmplifyClippingMethod values:

GStreamer Element: audioamplify

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->AmplifyBlock;
    AmplifyBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var amplify = new AmplifyBlock(AmplifyClippingMethod.Normal, 2.0);
pipeline.Connect(fileSource.AudioOutput, amplify.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(amplify.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Echo¶

The echo block adds echo effect to the audio stream.

Block info¶

Name: EchoBlock.

Settings¶

GStreamer Element: audioecho

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->EchoBlock;
    EchoBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

// Delay in ms, strength 0.0 - 1.0
var echo = new EchoBlock(500, 0.5);
pipeline.Connect(fileSource.AudioOutput, echo.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(echo.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Karaoke¶

The karaoke block applies a karaoke effect to the audio stream, removing center-panned vocals.

Block info¶

Name: KaraokeBlock.

Settings¶

Configure via KaraokeAudioEffect:

GStreamer Element: audiokaraoke

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->KaraokeBlock;
    KaraokeBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var settings = new KaraokeAudioEffect();
var karaoke = new KaraokeBlock(settings);
pipeline.Connect(fileSource.AudioOutput, karaoke.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(karaoke.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Reverberation¶

The reverberation block adds reverb effects to the audio stream.

Block info¶

Name: ReverberationBlock.

Settings¶

Configure via ReverberationAudioEffect:

GStreamer Element: freeverb

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->ReverberationBlock;
    ReverberationBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var settings = new ReverberationAudioEffect();
var reverb = new ReverberationBlock(settings);
pipeline.Connect(fileSource.AudioOutput, reverb.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(reverb.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Wide Stereo¶

The wide stereo block enhances the stereo image of the audio.

Block info¶

Name: WideStereoBlock.

Settings¶

Configure via WideStereoAudioEffect:

GStreamer Element: stereo

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->WideStereoBlock;
    WideStereoBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var settings = new WideStereoAudioEffect();
var wideStereo = new WideStereoBlock(settings);
pipeline.Connect(fileSource.AudioOutput, wideStereo.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(wideStereo.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Equalization and Filtering¶

Balance¶

Block allows you to control the balance between left and right channels.

Block info¶

Name: AudioBalanceBlock.

Settings¶

GStreamer Element: audiopanorama

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->AudioBalanceBlock;
    AudioBalanceBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

// Balance: -1.0 (full left) to 1.0 (full right), 0.0 - center
var balance = new AudioBalanceBlock(0.5);
pipeline.Connect(fileSource.AudioOutput, balance.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(balance.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Equalizer (10 bands)¶

The 10-band equalizer block provides a 10-band equalizer for audio processing.

Block info¶

Name: Equalizer10Block.

Settings¶

The equalizer provides 10 fixed-frequency bands. Use SetBand(int index, double gain) to adjust individual bands. Gain range: -24 dB to +12 dB.

Constructor accepts 10 double values for initial band gains (in dB), or use SetBand(int index, double gain) at runtime.

GStreamer Element: equalizer-10bands

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->Equalizer10Block;
    Equalizer10Block-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

// Create 10-band equalizer with all bands set to 0 dB
var equalizer = new Equalizer10Block(0, 0, 0, 0, 0, 0, 0, 0, 0, 0);

// Or set bands individually
equalizer.SetBand(0, 3); // Band 0 (31 Hz) to +3 dB
equalizer.SetBand(1, 2); // Band 1 (62 Hz) to +2 dB
equalizer.SetBand(9, -3); // Band 9 (16 kHz) to -3 dB

pipeline.Connect(fileSource.AudioOutput, equalizer.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(equalizer.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Equalizer (Parametric)¶

The parametric equalizer block provides a parametric equalizer for audio processing.

Block info¶

Name: EqualizerParametricBlock.

Settings¶

Use SetNumBands(int count) to set the number of bands (1–64, default 3), then configure each band with SetState(int index, ParametricEqualizerBand band).

ParametricEqualizerBand properties:

Default bands (when 3 bands configured):

GStreamer Element: equalizer-nbands

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->EqualizerParametricBlock;
    EqualizerParametricBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

// Create parametric equalizer
var equalizer = new EqualizerParametricBlock();

// Set up to 4 bands
equalizer.SetBand(0, 100, 1.0, 3); // Band 0: 100 Hz frequency, 1.0 Q, +3 dB gain
equalizer.SetBand(1, 1000, 1.5, -2); // Band 1: 1000 Hz frequency, 1.5 Q, -2 dB gain

pipeline.Connect(fileSource.AudioOutput, equalizer.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(equalizer.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Chebyshev Band Pass/Reject¶

The Chebyshev band pass/reject block applies a band pass or band reject filter to the audio stream using Chebyshev filters.

Block info¶

Name: ChebyshevBandPassRejectBlock.

Settings¶

Configure via ChebyshevBandPassRejectAudioEffect:

GStreamer Element: audiochebband

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->ChebyshevBandPassRejectBlock;
    ChebyshevBandPassRejectBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var settings = new ChebyshevBandPassRejectAudioEffect();
var filter = new ChebyshevBandPassRejectBlock(settings);
pipeline.Connect(fileSource.AudioOutput, filter.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(filter.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Chebyshev Limit¶

The Chebyshev limit block applies low-pass or high-pass filtering to the audio using Chebyshev filters.

Block info¶

Name: ChebyshevLimitBlock.

Settings¶

Configure via ChebyshevLimitAudioEffect:

GStreamer Element: audiocheblimit

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->ChebyshevLimitBlock;
    ChebyshevLimitBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var settings = new ChebyshevLimitAudioEffect();
var filter = new ChebyshevLimitBlock(settings);
pipeline.Connect(fileSource.AudioOutput, filter.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(filter.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Dynamic Processing¶

Compressor/Expander¶

The compressor/expander block provides dynamic range compression or expansion.

Block info¶

Name: CompressorExpanderBlock.

Settings¶

Configure via CompressorExpanderAudioEffect:

Constructor accepts 4 parameters: CompressorExpanderBlock(ratio, threshold, mode, characteristics).

GStreamer Element: audiodynamic

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->CompressorExpanderBlock;
    CompressorExpanderBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var compressor = new CompressorExpanderBlock(0.5, 0.9, 0.1, 0.5);
pipeline.Connect(fileSource.AudioOutput, compressor.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(compressor.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Scale/Tempo¶

The scale/tempo block allows you to change the tempo and pitch of the audio stream.

Block info¶

Name: ScaleTempoBlock.

Settings¶

Constructor accepts a double rate parameter for initial playback rate. Use SetRate(double rate) to change at runtime.

GStreamer Element: scaletempo

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->ScaleTempoBlock;
    ScaleTempoBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

// Scale tempo by factor (1.0 is normal, 0.5 is half-speed, 2.0 is double-speed)
var scaleTempo = new ScaleTempoBlock(1.5);
pipeline.Connect(fileSource.AudioOutput, scaleTempo.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(scaleTempo.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Analysis and Metering¶

VU Meter¶

The VU meter block allows you to measure the volume level of the audio stream.

Block info¶

Name: VUMeterBlock.

Settings¶

Event-based block. Subscribe to the VolumeUpdated event to receive level data.

VUMeterXData event properties:

GStreamer Element: level

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->VUMeterBlock;
    VUMeterBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var vuMeter = new VUMeterBlock();
vuMeter.VolumeUpdated += (sender, args) =>
{
    // Left channel volume in dB
    var leftVolume = args.LeftVolume;

    // Right channel volume in dB
    var rightVolume = args.RightVolume;

    Console.WriteLine($"Left: {leftVolume:F2} dB, Right: {rightVolume:F2} dB");
};
pipeline.Connect(fileSource.AudioOutput, vuMeter.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(vuMeter.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Audio Effects¶

Audio Effects¶

The AudioEffects block provides a comprehensive collection of audio processing effects that can be applied to audio streams. For detailed effect parameters and properties, see the Audio Effects Reference.

Block info¶

Name: AudioEffectsBlock.

Settings¶

Collection-based effect management. Use the following methods:

Supported effect types include all effects from VisioForge.Core.Types.X.AudioEffects namespace. See Audio Effects Reference for detailed parameters.

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->AudioEffectsBlock;
    AudioEffectsBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var audioEffects = new AudioEffectsBlock();
pipeline.Connect(fileSource.AudioOutput, audioEffects.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(audioEffects.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Audio Loudness Normalization¶

The AudioLoudNorm block normalizes audio loudness according to EBU R128 standards, ensuring consistent perceived loudness across different audio content.

Block info¶

Name: AudioLoudNormBlock.

Settings¶

Configure via AudioLoudNormAudioEffect:

GStreamer Element: audioloudnorm

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->AudioLoudNormBlock;
    AudioLoudNormBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var loudNorm = new AudioLoudNormBlock();
pipeline.Connect(fileSource.AudioOutput, loudNorm.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(loudNorm.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

RNN Noise Reduction¶

The AudioRNNoise block uses recurrent neural network (RNN) based noise reduction to remove background noise from audio streams while preserving speech quality.

Block info¶

Name: AudioRNNoiseBlock.

Settings¶

GStreamer Element: audiornnoise

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->AudioRNNoiseBlock;
    AudioRNNoiseBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "noisy_audio.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var rnnoise = new AudioRNNoiseBlock();
pipeline.Connect(fileSource.AudioOutput, rnnoise.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(rnnoise.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Remove Silence¶

The RemoveSilence block automatically detects and removes silent portions from audio streams, useful for podcasts, voice recordings, and audio editing.

Block info¶

Name: RemoveSilenceBlock.

Settings¶

Configure via RemoveSilenceAudioEffect:

GStreamer Element: removesilence

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->RemoveSilenceBlock;
    RemoveSilenceBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "podcast.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var removeSilence = new RemoveSilenceBlock();
pipeline.Connect(fileSource.AudioOutput, removeSilence.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(removeSilence.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Csound Filter¶

The CsoundFilter block provides advanced audio synthesis and processing using the Csound audio programming language.

Block info¶

Name: CsoundFilterBlock.

Settings¶

Configure via CsoundAudioEffect:

GStreamer Element: csoundfilter

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->CsoundFilterBlock;
    CsoundFilterBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var csoundSettings = new CsoundFilterSettings
{
    CsdPath = "filter.csd" // Csound script file
};
var csound = new CsoundFilterBlock(csoundSettings);
pipeline.Connect(fileSource.AudioOutput, csound.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(csound.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux (requires Csound).

EBU R128 Level¶

The EbuR128Level block measures audio loudness according to the EBU R128 standard, providing accurate loudness measurements for broadcast compliance.

Block info¶

Name: EbuR128LevelBlock.

Settings¶

Subscribe to the LoudnessUpdated event to receive measurement data.

GStreamer Element: ebur128level

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->EbuR128LevelBlock;
    EbuR128LevelBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var ebuR128 = new EbuR128LevelBlock();
ebuR128.LoudnessUpdated += (sender, args) =>
{
    Console.WriteLine($"Momentary: {args.MomentaryLoudness:F2} LUFS");
    Console.WriteLine($"Short-term: {args.ShortTermLoudness:F2} LUFS");
};
pipeline.Connect(fileSource.AudioOutput, ebuR128.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(ebuR128.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

HRTF Render¶

The HRTFRender block applies Head-Related Transfer Function (HRTF) processing to create 3D spatial audio effects from stereo or multi-channel audio.

Block info¶

Name: HRTFRenderBlock.

Settings¶

All properties support real-time updates during playback.

GStreamer Element: hrtfrender

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->HRTFRenderBlock;
    HRTFRenderBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var hrtfSettings = new HRTFRenderSettings
{
    Azimuth = 45.0,  // Direction in degrees
    Elevation = 0.0
};
var hrtf = new HRTFRenderBlock(hrtfSettings);
pipeline.Connect(fileSource.AudioOutput, hrtf.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(hrtf.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

RS Audio Echo¶

The RSAudioEcho block provides high-quality echo effects using the rsaudiofx GStreamer plugin.

Block info¶

Name: RSAudioEchoBlock.

Settings¶

All properties support real-time updates during playback.

GStreamer Element: rsaudioecho

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->RSAudioEchoBlock;
    RSAudioEchoBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var echoSettings = new RSAudioEchoSettings
{
    Delay = 500,      // Delay in milliseconds
    Intensity = 0.5,  // Echo intensity (0-1)
    Feedback = 0.3    // Feedback amount (0-1)
};
var rsEcho = new RSAudioEchoBlock(echoSettings);
pipeline.Connect(fileSource.AudioOutput, rsEcho.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(rsEcho.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux (requires rsaudiofx plugin).

Pitch Shifter¶

The PitchBlock shifts the pitch of an audio stream without affecting playback speed. It uses the SoundTouch library via the GStreamer pitch element, supporting shifts from −12 to +12 semitones (one octave down to one octave up).

Block info¶

Name: PitchBlock.

Settings¶

Availability¶

PitchBlock.IsAvailable() returns true if the GStreamer pitch element (SoundTouch plugin) is present.

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->PitchBlock;
    PitchBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var pitchBlock = new PitchBlock(semitones: 5);
pipeline.Connect(fileSource.AudioOutput, pitchBlock.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(pitchBlock.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux.

Silence Detector¶

The SilenceDetectorBlock analyzes audio levels in real time to detect silence periods based on a configurable dBFS threshold. It is a pass-through block — audio is forwarded unchanged while OnSilenceStarted and OnSilenceEnded events fire at state transitions. Detected periods can be retrieved as a list or exported as JSON.

Block info¶

Name: SilenceDetectorBlock.

Settings¶

Key methods:

• GetSilencePeriods() — returns all detected SilencePeriod objects.
• FinalizeSilencePeriods(TimeSpan endTime) — closes any in-progress period and returns the full list.
• ExportSilencePeriodsJson() — returns a JSON string with start/end timestamps for every detected period.

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->SilenceDetectorBlock;
    SilenceDetectorBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "test.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

var silenceDetector = new SilenceDetectorBlock(thresholdDb: -35.0);
silenceDetector.OnSilenceStarted += (s, e) => Console.WriteLine($"Silence started at {e.Timestamp}");
silenceDetector.OnSilenceEnded += (s, e) => Console.WriteLine($"Silence ended at {e.Timestamp}");
pipeline.Connect(fileSource.AudioOutput, silenceDetector.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(silenceDetector.Output, audioRenderer.Input);

await pipeline.StartAsync();

// After pipeline stops, export detected silence periods
var json = silenceDetector.ExportSilencePeriodsJson();
Console.WriteLine(json);

Platforms¶

Windows, macOS, Linux, iOS, Android.

Weighted Channel Mix¶

The WeightedChannelMixBlock mixes the left and right stereo channels with independently adjustable weights, producing a mono or stereo output. It is primarily used for dual-mono sources such as karaoke audio where one channel carries an instrumental track and the other a full mix.

Weights can be changed at runtime without rebuilding the pipeline. Values above 1.0 boost the channel but may cause clipping.

Block info¶

Name: WeightedChannelMixBlock.

Settings¶

The sample pipeline¶

graph LR;
    UniversalSourceBlock-->WeightedChannelMixBlock;
    WeightedChannelMixBlock-->AudioRendererBlock;

Sample code¶

var pipeline = new MediaBlocksPipeline();

var filename = "karaoke.mp3";
var fileSource = new UniversalSourceBlock(await UniversalSourceSettings.CreateAsync(new Uri(filename)));

// Use only the instrumental (left) channel
var mixer = new WeightedChannelMixBlock(leftWeight: 1.0f, rightWeight: 0.0f);
pipeline.Connect(fileSource.AudioOutput, mixer.Input);

var audioRenderer = new AudioRendererBlock();
pipeline.Connect(mixer.Output, audioRenderer.Input);

await pipeline.StartAsync();

Platforms¶

Windows, macOS, Linux, iOS, Android.

Frequently Asked Questions¶

See Also¶

• Audio Effects Overview
• Audio Effects Reference
• Audio Encoders
• Media Blocks SDK Overview