NAudio.MacOS 3.1.1-preview.1

Prefix Reserved
.NET 9.0 This package targets .NET 9.0. The package is compatible with this framework or higher.
This is a prerelease version of NAudio.MacOS. 
dotnet add package NAudio.MacOS --version 3.1.1-preview.1
                    


                    

                
NuGet\Install-Package NAudio.MacOS -Version 3.1.1-preview.1
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="NAudio.MacOS" Version="3.1.1-preview.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="NAudio.MacOS" Version="3.1.1-preview.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="NAudio.MacOS" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add NAudio.MacOS --version 3.1.1-preview.1
                    


                    

                
#r "nuget: NAudio.MacOS, 3.1.1-preview.1"
#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. 
#:package NAudio.MacOS@3.1.1-preview.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=NAudio.MacOS&version=3.1.1-preview.1&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=NAudio.MacOS&version=3.1.1-preview.1&prerelease
                    


                            Install as a Cake Tool

NAudio.MacOS

Provides support for macOS playback, recording and file reading/writing through macOS native API's.

NOTE: This package is still in pre-release phase and breaking code changes may be performed as this support is evolved.

Use it at your own risk.

What's included

  • Core Audio Framework: The audio HAL API. Through this API, playback and recording from an installed hardware device is possible. It provides a managed wrapper, as well as the CoreAudioPlayer and CoreAudioRecorder classes (at NAudio.Wave) for typical playback and recording scenarios, and are the default implementations that NAudio users are expected to use.

  • Audio Toolbox: Audio Converter Services: API providing the macOS resampler.

  • Audio Toolbox: Extended Audio File Services: API's similar to Media Foundation Source Reader and Sink Writer on Windows. They allow to read and write audio files. They support MP3 (read-only), MP4/AAC, OGG Vorbis (read-only) and FLAC.

When to use it

Use this package whenever you want to do playback or recording on macOS, and/or you want to use the macOS native audio file reader/writer.

See the NAudio documentation site for tutorials and the full API reference, or the GitHub repository for full documentation and tutorials.

Acknowledgements

The interop definitions and API documentation comments in this package are derived from Apple's public framework headers (Core Audio, Audio Toolbox and Core Foundation) and from Apple's developer documentation, available at https://developer.apple.com/documentation . Individual interoperation source files explicitly note the header(s) they correspond to.

License

MIT.

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.1.1-preview.1 55 9/8/2026

* **macOS support (preview)** - A new wrappers library is added wrapping macOS native API's for playback/recording, reading/writing files and resampling audio. The `NAudio.MacOS` package ships pre-release only (`X.Y.Z-preview.N`) while its API settles, so it stays pre-release alongside stable releases of the other packages. Special thanks to @mdcdi1315 (#1325) for the work and the tests. For more information, see the [design](Docs/Architecture/MacOSWrappersDesign.md) doc that describes the decisions that helped shape the wrappers. (#1398)