Shiny.Audio.Linux
3.0.0-beta-0024
Prefix Reserved
See the version list below for details.
dotnet add package Shiny.Audio.Linux --version 3.0.0-beta-0024
NuGet\Install-Package Shiny.Audio.Linux -Version 3.0.0-beta-0024
<PackageReference Include="Shiny.Audio.Linux" Version="3.0.0-beta-0024" />
<PackageVersion Include="Shiny.Audio.Linux" Version="3.0.0-beta-0024" />
<PackageReference Include="Shiny.Audio.Linux" />
paket add Shiny.Audio.Linux --version 3.0.0-beta-0024
#r "nuget: Shiny.Audio.Linux, 3.0.0-beta-0024"
#:package Shiny.Audio.Linux@3.0.0-beta-0024
#addin nuget:?package=Shiny.Audio.Linux&version=3.0.0-beta-0024&prerelease
#tool nuget:?package=Shiny.Audio.Linux&version=3.0.0-beta-0024&prerelease
Shiny.Audio
Cross-platform audio capture and playback for .NET MAUI, iOS, Mac Catalyst, macOS, Android, Windows,
Browser (WebAssembly), and Linux (via the companion Shiny.Audio.Linux package).
Shiny.Audio provides the low-level audio primitives that back Shiny.Speech,
but is usable on its own:
IAudioSource— microphone capture that streams raw PCM audio (16kHz, 16-bit, mono) via a thread-safePipeStream, with runtime permission handling (RequestAccess/AccessState) and a normalizedInputLevelChangedVU signal on every platform.IAudioPlayer— stream playback (e.g. MP3) with optional normalizedAudioLevelChangedmetering for VU-style UI.IAudioRecorder— record the microphone straight to a WAV file, optionally through a live effect chain, capturing the processed take, the raw one, or both.AudioEffectChain— real-time DSP on capture (pitch shift, echo, reverb, filters, distortion, ring modulation, chorus, gain, noise gate) that you toggle and re-tune while recording.AudioLevel— the shared dBFS mapping behind every meter (FromRms/FromPcm16/FromSamples), so input and output bars read on the same scale — including PCM you meter yourself.WavWriter/WavReader— streaming RIFF/WAVE PCM I/O, plusAudioEffectProcessorfor applying an effect chain to a file that already exists.
Getting Started
using Shiny;
builder.Services.AddAudioServices(); // registers IAudioSource, IAudioPlayer, IAudioRecorder, ...
using Shiny.Audio;
public class Recorder(IAudioSource audioSource)
{
public async Task RecordAsync(CancellationToken ct)
{
if (await audioSource.RequestAccess() != AccessState.Available)
return;
var pcmStream = await audioSource.StartCaptureAsync(cancellationToken: ct);
// consume pcmStream ...
await audioSource.StopCaptureAsync();
}
}
Effects & recording
Effects are caller-owned objects. Build a chain, hand it to a capture or recording session, and keep the reference — toggling an effect or moving a parameter applies on the next audio buffer, with no restart and no clicks.
using Shiny.Audio;
var chain = new AudioEffectChain();
var pitch = chain.Add(new PitchShiftEffect { Semitones = 0 });
var echo = chain.Add(new EchoEffect { Enabled = false });
await recorder.StartAsync(new AudioRecordingOptions
{
Mode = AudioRecordMode.Both, // writes the processed and the raw take
Effects = chain
});
pitch.Semitones = 5; // heard immediately
echo.Enabled = true;
chain.Enabled = false; // master bypass
var recording = await recorder.StopAsync();
Available effects: GainEffect, NoiseGateEffect, BiquadFilterEffect, DistortionEffect,
RingModEffect, EchoEffect, ChorusEffect, ReverbEffect, PitchShiftEffect — plus
AudioEffectPresets.Create(...) for ready-made combinations (Robot, Chipmunk, DeepVoice, Cathedral,
Telephone, Megaphone, Ensemble).
Do not put effects on audio bound for speech recognition — they destroy recognition and wake-word accuracy.
| Platform | Audio Capture | Audio Playback |
|---|---|---|
| iOS 15+ | AVAudioEngine | AVAudioPlayer |
| Android 26+ | AudioRecord | MediaPlayer |
| Windows 10 19041+ | AudioGraph | MediaPlayer |
| Browser (WASM) | Web Audio API (getUserMedia + ScriptProcessorNode) |
HTML5 Audio |
| Linux | PulseAudio / PipeWire (pa_simple), ALSA fallback |
PulseAudio / PipeWire (pa_simple), ALSA fallback |
Linux
Linux ships as a separate Shiny.Audio.Linux package (it carries a managed MP3 decoder, since
Linux has no system decoder to call). Add it and register before anything else:
builder.Services.AddLinuxAudio(); // no-op when not running on Linux
It supplies all four services — IAudioSource, IAudioPlayer, IAudioDevices and IAudioMonitor —
over PulseAudio/PipeWire, falling back to ALSA on headless systems and containers.
See https://shinylib.net/speech for full documentation.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.5)
- NLayer (>= 2.0.1)
- Shiny.Audio (>= 3.0.0-beta-0024)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Shiny.Audio.Linux:
| Package | Downloads |
|---|---|
|
Shiny.AppDeviceBridge.Audio
The device's speakers and microphone for a Shiny.AppDeviceBridge web app, backed by Shiny.Audio — play clips from a URL or a file root, read and set the system volume, record the microphone to WAV with effect presets, list audio routes, and route the microphone live to the output, with level meters as events. One call: bridge.AddAudioBridge(). |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 3.1.0-beta-0002 | 43 | 11/12/2026 |
| 3.1.0-beta-0001 | 44 | 11/12/2026 |
| 3.0.0 | 161 | 10/30/2026 |
| 3.0.0-beta-0036 | 93 | 10/25/2026 |
| 3.0.0-beta-0035 | 100 | 10/24/2026 |
| 3.0.0-beta-0034 | 87 | 10/23/2026 |
| 3.0.0-beta-0033 | 102 | 10/22/2026 |
| 3.0.0-beta-0032 | 95 | 10/21/2026 |
| 3.0.0-beta-0030 | 121 | 8/15/2026 |
| 3.0.0-beta-0029 | 115 | 8/8/2026 |
| 3.0.0-beta-0028 | 112 | 8/7/2026 |
| 3.0.0-beta-0027 | 107 | 8/5/2026 |
| 3.0.0-beta-0026 | 116 | 8/5/2026 |
| 3.0.0-beta-0024 | 113 | 8/5/2026 |
| 3.0.0-beta-0023 | 113 | 8/5/2026 |
| 3.0.0-beta-0022 | 119 | 8/2/2026 |
| 3.0.0-beta-0021 | 113 | 7/31/2026 |
| 3.0.0-beta-0020 | 117 | 7/30/2026 |
| 3.0.0-beta-0019 | 109 | 7/30/2026 |