Beep is a simple cross-platform low level dotnet library for playing PCM audio.
It was inspired by oto golang library that I used before. However, it is not a direct port of it. It has been created to be used by my ZX Spectrum emulator, hence the name Beep. I needed a simple way of playing audio and couldn't find anything that would suit my needs.
I don't plan to add any advanced features to this library. It is quite challenging to implement a good audio library that would work on all platforms. Each platform has its own way of handling audio and good examples are hard to find.
I've tested it on MacOS, Windows and Linux. But I can't guarantee that it will work on all systems.
- written in C# and .NET 8
- no external dependencies other than native OS frameworks
- cross-platform, currently supports MacOS, Windows and Linux
- supports 8-bit unsigned, 16-bit signed and 32-bit float PCM data formats
- simple volume control
Internally it uses 32-bit float PCM audio format (little endian).
Audio playback is implemented using AudioToolbox.framework. The framework is available on MacOS by default.
Audio playback is implemented using WASAPI. The framework is available on Windows by default.
Audio playback is implemented using ALSA. The library may need to be installed on some Linux distributions.
Additionally, you might need ALSA development library. Installation method may differ depending on the Linux distribution.
On Debian based Linux distributions run:
apt install libasound2-devOn RedHat based Linux distributions run:
dnf install alsa-lib-develPlease check the Demo project for an example how to use Beep.
using OldBit.Beep;
using var audioPlayer = new AudioPlayer(AudioFormat.Float32BitLittleEndian, 44100, 2);
audioPlayer.Volume = 50;
audioPlayer.Start();
await audioPlayer.EnqueueAsync(new byte[] { 0.5f, 0.5f, 0.5f, 0.5f });
audioPlayer.Stop();EnqueueAsync method takes an array of audio bytes. The format is one of the following:
| Format | Description | Size |
|---|---|---|
Unsigned8BitLittleEndian |
8-bit unsigned PCM | 1 byte (0..255) |
Signed16BitLittleEndian |
16-bit signed PCM | 2 bytes (-32768..32767) |
Float32BitLittleEndian |
32-bit float PCM | 4 bytes (-1.0..1.0) |