Sonora is a .NET audio framework which provides a structured workflow for handling audio/MIDI clips, tracks, and real-time processing, making it ideal for digital audio applications.

Documentation 📙

• Audio and Midi clips: create Audio and Midi clips, tweak their options, place them in tracks and play them.

• Audio and Midi tracks: support for Audio and Midi tracks allows to group clips, apply effects to all and build audio pipelines.

• Virtual Studio Technology (VST): plug and play VST2 Plugins support. Process the audio signal or generate it from external and built in plugins.

• Automations: automate clips parameters like volume and pan during playback.

Too see a more comprehensive list see the FEATURES.md document.

• Built on Robust Libraries: the framework makes use of popular open source libraries like NAudio, DryWetMidi, SoundTouch.Net and VST.NET.

• Wide Use Cases: build whatever you think of, be it a simple audio player, a sound editor or a DAW like application.

• Open Source: everyone can contribute to it extending the framework capabilities or help in bug fixing and improving current features.

Sonora is available on Windows devices only. There is no cross platform support as most of the used libraries have partial cross platform capabilities or not at all.

• .NET 6.0 SDK: the framework is built on the .NET 6 version for better compatibility with some of the used libraries, but should also works on later versions, although it has not been tested.

The easiest way to get started is to install the NuGet package with the NuGet Package Manager you can find on Visual Studio in Tools > NuGet Package Manager > Package Manager Console, running the command below. For others IDE use the relative package manager.

Install-Package Sonora

If you are gonna use VST plugins in your app, you will also have to install the VST.NET2-Host package.

Install-Package VST.NET2-Host

After installing the needed packages, make your project target the x64 platform.

Target platform x64 is required because the framework was built on that target to support VST plugins. For reference, read the first lines here.

Here is a basic example that shows how to play an audio file by creating an audio clip from it and adding it to an audio track.

private static void Main()
{
    SonoraMain.Init(); // Initialize the framework

    // Create an audio device using the WaveOut API
    SonoraMain.CreateAudioDevice(AudioAPI.WaveOut);

    // Create an audio clip from an audio file
    var audioClip = new AudioClip("path/to/sound.wav");

    // Create an audio track with a name
    var audioTrack = new AudioTrack("MyTrackName");

    // Add the created audio clip to the audio track
    audioTrack.AddClip(audioClip);

    // Start the clip playback
    audioClip.Play();

    // Wait for a keypress before exiting the program
    Console.ReadKey();
}

If you want to contribute to the project, read the CONTRIBUTING.md document.

This project is MIT-licensed, but uses the following LGPL-2.1 libraries:

• VST.NET
• SoundTouch.Net

Users must comply with the LGPL-2.1 terms when using these dependencies.

This project makes use of the following libraries. A special thank to those:

• NAudio, for the audio integration.
• DryWetMidi, for the midi integration.
• VST.NET, for the VST plugins integration.
• SoundTouch.Net, for the pitch and tempo sound effects.
• Veldrid, for the creation and management of VST plugin windows.