OwnAudioSharp.Basic 2.6.1

OwnAudioSharp.Basic

Lightweight cross-platform audio library for .NET desktop and mobile applications

OwnAudioSharp.Basic is a professional-grade audio engine providing high-performance audio playback, recording, and processing for Windows, Linux, macOS, Android, and iOS — without AI/ML dependencies, making it significantly smaller and faster to install than the full OwnAudioSharp package.

Why Basic?

Use OwnAudioSharp.Basic when you need a lean audio engine without the overhead of large ONNX model files and AI inference dependencies.

Key Features

• Native Audio Engines: Built on PortAudio and MiniAudio (all platforms) for professional-grade audio processing
• Managed Wrappers: Platform-specific managed engines with WASAPI (Windows), PulseAudio (Linux), and Core Audio (macOS) integration
• Multi-format Support: Built-in decoders for MP3, WAV, and FLAC
• Real-time Processing: Zero-allocation design with lock-free buffers for professional-grade performance
• Advanced Audio Features:
  • Network Synchronization: Multi-device audio sync across local network (< 5ms accuracy on LAN)
  • Master Clock: Sample-accurate timeline synchronization for multi-track playback
  • SmartMaster Effect: Intelligent audio mastering with auto-calibration
  • VST3 Plugin Support: Load and host VST3 audio effect plugins
  • Built-in effects and DSP routines (EQ, compressor, reverb, etc.)
  • Pitch shifting and time stretching via SoundTouch

Quick Start

using OwnaudioNET;

// Initialize the audio engine
OwnaudioNet.Initialize();
OwnaudioNet.Start();

// Create the audio mixer using the underlying engine
var mixer = new AudioMixer(OwnaudioNet.Engine.UnderlyingEngine);
mixer.Start();

// Play an audio file
var music = new FileSource("music.mp3");
mixer.AddSource(music);

// Synchronized Multi-track Playback (Master Clock)
var vocals = new FileSource("vocals.wav");
var backing = new FileSource("backing.mp3");

mixer.AddSource(vocals);
mixer.AddSource(backing);

// Attach sources to the Master Clock for sample-accurate sync
vocals.AttachToClock(mixer.MasterClock);
backing.AttachToClock(mixer.MasterClock);

// Start sources individually
vocals.Play();
backing.Play();

// Network Synchronization - Multi-Device Audio
// Server mode (control device)
await OwnaudioNet.StartNetworkSyncServerAsync(port: 9876);

// Client mode (follower devices)
await OwnaudioNet.StartNetworkSyncClientAsync(
    serverAddress: "192.168.1.100",  // Or null for auto-discovery
    allowOfflinePlayback: true);

// All clients automatically follow server commands
// Perfect for multi-room audio, DJ setups, installations

// Apply effects
var source = new FileSource("music.mp3");
source.Effects.Add(new ReverbEffect { RoomSize = 0.5f });
source.Effects.Add(new EqualizerEffect());
mixer.AddSource(source);

// Pitch shifting / time stretching
var pitchedSource = new SoundTouchSource("music.mp3");
pitchedSource.SetPitchSemitones(2);   // Shift up 2 semitones
pitchedSource.SetTempo(1.1f);         // 10% faster
mixer.AddSource(pitchedSource);

Platform Support

Desktop

• Windows: Windows 10/11 (x64, x86, ARM64)
• Linux: Ubuntu, Debian, Fedora, etc. (x64, ARM, ARM64)
• macOS: macOS 10.13+ (x64, ARM64)

Mobile

• Android: Android 7.0 (API 24)+ (ARM, ARM64, x64)
• iOS: iOS 12.2+ (ARM64)

What Is NOT Included

The following features from the full OwnAudioSharp package are not available in the Basic edition:

• VocalRemover — AI-powered source separation using ONNX neural networks (nmp.onnx, best.onnx, default.onnx, karaoke.onnx, htdemucs.onnx)
• ChordDetector — Real-time and offline chord recognition
• Matchering — Reference-based audio mastering
• WaveDisplayControl — Avalonia-based waveform visualization UI control

If you need any of these features, use the full OwnAudioSharp package instead.

Architecture

OwnAudioSharp.Basic uses a two-layer architecture:

1. Engine Layer: Low-level platform-specific audio processing with real-time thread management
2. API Layer: High-level thread-safe wrappers with lock-free ring buffers to prevent UI blocking

UI/Main Thread
  └─> OwnaudioNet.Send() [lock-free, <0.1ms]
       └─> AudioEngineWrapper [ring buffer write]
            └─> Pump Thread [dedicated]
                 └─> Audio RT Thread [platform-specific]

Documentation

• GitHub: https://github.com/ModernMube/OwnAudioSharp
• Documentation: https://modernmube.github.io/OwnAudioSharp/

License

MIT License - Copyright (c) 2025 ModernMube