Name: SoundFlow
Author: SoundFlow

SoundFlow v1.2.1 — nugetz

Cross-Platform Compatibility: Runs seamlessly on Windows, macOS, Linux, Android, iOS, and FreeBSD, ensuring broad deployment options.
Multi-Device Management: Initialize and manage multiple independent audio playback and capture devices simultaneously, each with its own audio graph.
Advanced Device Control: Fine-tune latency, sharing modes, and platform-specific settings (WASAPI, CoreAudio, ALSA, etc.) for professional-grade control.
On-the-fly Device Switching: Seamlessly switch between audio devices during runtime without interrupting the audio graph.
Modular Component Architecture: Build custom audio pipelines by connecting sources, modifiers, mixers, and analyzers.
Plug & Play Integrations: Extend SoundFlow's capabilities with official integration packages, such as the WebRTC Audio Processing Module for advanced noise suppression, echo cancellation, and automatic gain control.
Extensibility: Easily add custom audio components, effects, and visualizers to tailor the engine to your specific needs.
High Performance: Optimized for real-time audio processing with SIMD support and efficient memory management.
Playback: Play audio from various sources, including files, streams, and in-memory assets.
Recording: Capture audio input and save it to different encoding formats.
Mixing: Combine multiple audio streams with precise control over volume and panning.
Effects: Apply a wide range of audio effects, including reverb, chorus, delay, equalization, and more.
Analysis: Extract valuable information from audio data, such as RMS level, peak level, frequency spectrum, and voice activity.
Visualization: Create engaging visual representations of audio waveforms, spectrums, and level meters.
Surround Sound: Supports advanced surround sound configurations with customizable speaker positions, delays, and panning methods.
HLS Streaming Support: Integrate internet radio and online audio via HTTP Live Streaming.
Backend Agnostic: Supports the MiniAudio backend out of the box, with the ability to add others.
Non-Destructive Audio Editing & Persistence:
- Compositions & Tracks: Organize audio projects into multi-track compositions, allowing flexible arrangement and mixing.
- Audio Segments: Place and manipulate audio clips on a timeline with granular control over their playback, including volume, pan, fades (Linear, Logarithmic, S-Curve), reversal, and advanced looping (repetitions or target duration).
- Pitch-Preserved Time Stretching: Modify the duration of audio segments without altering their pitch, ideal for adapting content to specific timeframes.
- Project Save/Load: Persist entire audio compositions to disk, including media consolidation and embedding options, with support for relinking missing audio sources.
- Timeline Manipulation: Programmatically insert, remove, replace, or silence audio sections on a track, with automatic shifting of subsequent content.

Install-Package SoundFlow

dotnet add package SoundFlow

using SoundFlow.Abstracts;
using SoundFlow.Backends.MiniAudio;
using SoundFlow.Components;
using SoundFlow.Providers;
using SoundFlow.Structs;

// 1. Initialize the Audio Engine context.
// This acts as a manager for all audio devices.
using var engine = new MiniAudioEngine();

// 2. Define the desired audio format.
var format = AudioFormat.Dvd; // 48kHz, 16-bit Stereo

// 3. Initialize a specific playback device. Passing `null` will use the system default too.
var defaultDevice = engine.PlaybackDevices.FirstOrDefault(x => x.IsDefault);
using var playbackDevice = engine.InitializePlaybackDevice(defaultDevice, format);

// 4. Create a SoundPlayer to play an audio file.
var player = new SoundPlayer(engine, device.Format,
    new StreamDataProvider(engine, format, File.OpenRead("path/to/your/audiofile.wav")));

// 5. Add the player to the device's MasterMixer.
// Each device has its own independent mixer.
device.MasterMixer.AddComponent(player);

// 6. Start the device to begin audio processing.
device.Start();
player.Play();

// Keep the console application running.
Console.WriteLine("Playing audio... Press any key to stop.");
Console.ReadKey();

// Stop and clean up.
player.Stop();
device.Stop();

Audio Engine (AudioEngine): The central context that manages the audio backend and acts as a factory for audio devices. It does not control audio directly but provides the foundation for creating and managing devices.
Audio Devices (AudioPlaybackDevice, AudioCaptureDevice): The core of the runtime. These objects represent an initialized piece of hardware (like a sound card or microphone). Each playback device has its own independent MasterMixer and audio graph, allowing for multiple, separate audio streams.
Full Duplex Device (FullDuplexDevice): A high-level helper that pairs a playback and capture device, simplifying tasks that require simultaneous input and output, such as live effects monitoring.
Sound Components (SoundComponent): Modular units that process or generate audio, forming a directed graph through input and output connections.
Mixer (Mixer): Combines multiple audio streams into a single output. Each AudioPlaybackDevice has its own MasterMixer which serves as the root of its audio graph.
Sound Modifiers (SoundModifier): Apply audio effects like reverb, chorus, delay, and equalization.
Audio Playback & Recording: Components for playing and capturing audio, including surround sound support.
Audio Providers: Standardized way to read audio data from various sources (files, streams, memory).
Audio Analysis & Visualization: Tools for extracting information from audio and creating visual representations.
Composition (Composition): The top-level project file that defines a multi-track audio timeline, applies master effects, and manages persistence.
Tracks (Track): Containers within a Composition that hold AudioSegments. Tracks have their own settings for volume, pan, mute, solo, and can host effects/analyzers.
Audio Segments (AudioSegment): Individual audio clips placed on a Track's timeline. Segments reference a portion of an ISoundDataProvider and can apply segment-specific settings like fades, looping, reversal, speed, and pitch-preserved time stretching.
Time Stretchers (WsolaTimeStretcher): An advanced internal component used by AudioSegment and SoundPlayerBase to perform high-quality, pitch-preserved time manipulation.

LSXPrime/SoundFlowv1.2.1

Get Started

Readme

SoundFlow

Introduction

Getting Started

Installation

Basic Usage Example

Core Concepts

Extensions

SoundFlow.Extensions.WebRtc.Apm

API Reference

Tutorials and Examples

Contributing

Acknowledgments

Support This Project

License

An Ethical Stance