NextAudio 1.0.0

dotnet add package NextAudio --version 1.0.0
NuGet\Install-Package NextAudio -Version 1.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="NextAudio" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NextAudio --version 1.0.0
#r "nuget: NextAudio, 1.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install NextAudio as a Cake Addin
#addin nuget:?package=NextAudio&version=1.0.0

// Install NextAudio as a Cake Tool
#tool nuget:?package=NextAudio&version=1.0.0

<p align="center"> <img src="banner.png" /> </br> <a href="https://github.com/NextAudio/NextAudio/actions"> <img src="https://img.shields.io/endpoint?label=BUILD%20STATUS&logo=github&logoWidth=20&labelColor=0d0d0d&style=for-the-badge&url=https://github-workflow-status-badge.vercel.app/api/NextAudio/NextAudio/build-test-lint.yml" /> </a> <a href="https://dotnet.microsoft.com/download"> <img src="https://img.shields.io/badge/dotnet-6+-blueviolet?label=.NET&logo=.net&style=for-the-badge&logoWidth=20&labelColor=0d0d0d" /> </a> <a href="https://www.myget.org/feed/Packages/next-audio/"> <img src="https://img.shields.io/myget/next-audio/vpre/NextAudio.svg?label=Dev-Version&logo=nuget&style=for-the-badge&logoWidth=20&labelColor=0d0d0d" /> </a> <a href="https://www.nuget.org/packages/NextAudio/"> <img src="https://img.shields.io/nuget/v/NextAudio.svg?label=Version&logo=nuget&style=for-the-badge&logoWidth=20&labelColor=0d0d0d" /> </a> <a href="https://www.nuget.org/packages/NextAudio/"> <img src="https://img.shields.io/nuget/dt/NextAudio.svg?label=Downloads&logo=nuget&style=for-the-badge&logoWidth=20&labelColor=0d0d0d" /> </a> <a href="https://github.com/NextAudio/NextAudio/blob/main/LICENSE"> <img src="https://img.shields.io/badge/License-MIT-yellow.svg?label=License&style=for-the-badge&logoWidth=20&labelColor=0d0d0d" /> </a> <p align="center"> Create audio apps without headache in the .NET ecosystem. </p> <p align="center"> This library allows you to create audio apps without a lot of headache existing in the "audio topic" </p> </p>

Documentation

See Documentation

Installation

You can add this lib via nuget package manager.

dotnet cli example:

dotnet add package NextAudio

OBS: This install only the core lib. The individual components may also be installed from NuGet.

Stable

The stable builds are available from NuGet.

Unstable

The development builds are availabe from Myget feed https://www.myget.org/F/next-audio/api/v3/index.json. These builds target the main branch.

Usage

The lib will always use audio frame buffers for read/write operations.

This makes the streaming data very easy.

using var output = new MemoryStream();
using var file = AudioStream.CreateFromFile("test1.mkv");
using var demuxer = new MatroskaDemuxer(file);

var bytesRead = 0;
Span<byte> buffer = new byte[1024];

while ((bytesRead = demuxer.Demux(buffer)) > 0)
{
    // Always slice the buffer to bytesRead,
    // the lib always will return an audio frame
    // when using a read operation.
    var frame = buffer.Slice(0, bytesRead);
    output.Write(frame);
}

For more usage and guides check the documentation

Features

Basic features
  • High performance, low memory allocation with Span<T>, Memory<T>, ArrayPool and lower GC pressure with ValueTask.
  • Fully Sync and Async support.
  • Per audio frame reading/writing.
  • Logging with Microsoft.Extensions.Logging.
  • Symbols debugging (.snupkg).
Containers demuxing support:
  • Matroska (.mkv/.webm)

Goals

OBS: Goals will change as new lib versions come out.

Audio stream providers support:
  • File (current supported by AudioStream.CreateFromFile)
  • Http (current supported by AudioStream.CreateFromStream but is not persistent)
  • Youtube
Containers demuxing support:
  • Ogg (.ogg/.ogv/.oga/.ogx)
  • Wav (.wav/.wave)
  • MPEG-4 Part 14 (.mp4)
  • Flac (.flac)
Decoders support:
  • Opus (.opus)
  • Vorbis (.ogg/.oga)
  • AAC (.m4a/.m4b/.m4p/.m4v/.m4r/.aac/.3gp/.mp4)
  • MPEG-1/2 Audio Layer 3 (.mp3/.mp4)
Encoders support:
  • Opus (.opus)
Containers probe support:
  • Matroska (.mkv/.webm)
  • Ogg (.ogg/.ogv/.oga/.ogx)
  • Wav (.wav/.wave)
  • MPEG-4 Part 14 (.mp4)
  • Flac (.flac)
Others audio operations
  • Seeking (by timestamp)
  • Volume
  • Resampling
  • Mono to Stereo
Others
  • Package with all lib individual components
  • Audio Pipelines (less complexity when wanna a specific output format)
  • Support for Microsoft.Extensions.DependencyInjection
  • Writing to output formats (PipelineWriter/Stream)
  • An Audio Player structure to control play/queue/pause/seek/volume operations

Contributing

To contribute to this library follow the Contributing guideline

License

This project uses the MIT License.

Code of Conduct

See Code of Conduct

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on NextAudio:

Package Downloads
NextAudio.Matroska

The Matroska Container support for NextAudio library.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.0 251 10/22/2022