naudio Wiki & Documentation Rss Feed

Updated Wiki: Home

markheath — Thu, 23 May 2013 13:36:41 GMT

NAudio Overview

NAudio is an open source .NET audio and MIDI library, containing dozens of useful audio related classes intended to speed development of audio related utilities in .NET. It has been in development since 2002 and has grown to include a wide variety of features. While some parts of the library are relatively new and incomplete, the more mature features have undergone extensive testing and can be quickly used to add audio capabilities to an existing .NET application. NAudio can be quickly added to your .NET application using NuGet.

NAudio demo project showing an MP3 file playing:

NAudio WPF Project showing waveform visualisation and spectrum analyser:

Latest News

For the latest news and more documentation on NAudio, visit Mark Heath's blog.

26 Oct 2012 NAudio 1.6 Released. Read the release notes
9 Sep 2012 ASIO Recording Support added
19 Dec 2011 NAudio 1.5 Released. Read the release notes
20 Apr 2011 NAudio 1.4 Released. Read the release notes
15 Apr 2011 NAudio demo now shows how to select output devices (for WaveOut, DirectSound, WASAPI and ASIO), and can play 8 bit, 16 bit, 24 bit, and 32 bit float WAV files. Fixed a longstanding ASIO issue.
7 Nov 2010 Major improvements to Mp3FileReader
10 Oct 2009 Version 1.3 Released. Read the release notes
20 Sep 2009 We are getting close to feature complete for 1.3. Last chance to get in any feedback on the API
26 Aug 2009 WPF Waveform drawing demo project including FFT added
28 Feb 2009 Lots of new stuff is being added and planned, so do check out the Source Code tab to have a sneak peak at what's coming in 1.3
26 June 2008 Version 1.2 Released. Read the release notes

NAudio Features

Play back audio using a variety of APIs
- WaveOut
- DirectSound
- ASIO
- WASAPI (Windows Vista and above)
Decompress audio from different Wave Formats
- MP3 decode using ACM or DMO codec
- AIFF
- G.711 mu-law and a-law
- ADPCM
- G.722
- Speex (using NSpeex)
- SF2 files
- Decode using any ACM codec installed on your computer
Record audio using WaveIn, WASAPI or ASIO
Read and Write standard .WAV files
Mix and manipulate audio streams using a 32 bit floating mixing engine
Extensive support for reading and writing MIDI files
Full MIDI event model
Basic support for Windows Mixer APIs
A collection of useful Windows Forms Controls
Some basic audio effects, including a compressor

Projects Using NAudio

NAudio currently is used to support a number of audio related utilities, some of which may be moved to be hosted on CodePlex in the future. If you have used NAudio for a project, please get in touch so we can post it here.

Skype Voice Changer - Modify your voice with audio effects while talking on Skype
.NET Voice Recorder - Record your voice, save to MP3, and visualise the waveform using WPF. Now includes autotune
MIDI File Mapper - Utility for mapping MIDI drum files for use on other samplers
MIDI File Splitter - Split MIDI files up at their markers
SharpMod - managed port of MikMod, can play mod files in both WinForms and Silverlight
NVorbis - Fully managed Vorbis decoder, with support for NAudio
Practice# - Windows tool for practicing playing an instrument with playback music. Includes FLAC playback support and an equaliser for NAudio.
WPF Sound Visualization Library - beautiful waveform and spectrum analyzer code written for WPF, comes with NAudio sample
Teachey Teach - utility to help English language conversation teachers generate feedback for students
Sound Mill - an audio player, list organizer and automation manager
Bravura Studio - a modular, extensible application and platform for creating and experimenting with music and audio.
SIPSorcery - .NET softphone framework
Squiggle - A free open source LAN Messenger
Helix 3D toolkit
airphone-tv - A revival of axStream to implement control through the iPhone
JamNet - a Silverlight drum sample player
Jingle Jim - Jingle Software (German language)
All My Music
iSpy - Open Source Camera Security Software
RadioTuna - Online internet radio player
Fire Talk New - chat program
AVR Audio Guard - utility to fix a HDMI related issue

More Info

For more information, please visit the NAudio Documentation Wiki

Donate

NAudio is a free open source project that is developed in personal time. You can show your appreciation for NAudio and support future development by donating.

New Comment on "Convert a MP3 to WAV"

jbrill3000 — Fri, 10 May 2013 21:38:29 GMT

I forgot to say that the MP3 is from mp3skyperecorder I am using 24 bit, at 16 kHz

New Comment on "Convert a MP3 to WAV"

jbrill3000 — Fri, 10 May 2013 21:35:46 GMT

I am using this code to convert from MP3 to WAV but the original MP3 file is 55minutes and 4 secs and the wav file is 54 minutes and 5 seconds. Is there a way to make the files come out to be the same length by time? It is critical that they be the same length for my application. Any ideas?

Updated Wiki: Documentation

markheath — Thu, 14 Mar 2013 14:26:22 GMT

The NAudio Documentation Wiki

NAudio FAQ

What is NAudio?

NAudio is an open source audio API for .NET written in C# by Mark Heath, with contributions from many other developers. It is intended to provide a comprehensive set of useful utility classes from which you can construct your own audio application.

Why NAudio?

NAudio was created because the Framework Class Library that shipped with .NET 1.0 had no support for playing audio. The System.Media namespace introduced in .NET 2.0 provided a small amount of support, and the MediaElement in WPF and Silverlight took that a bit further. The vision behind NAudio is to provide a comprehensive set of audio related classes allowing easy development of utilities that play or record audio, or manipulate audio files in some way.

Can I Use NAudio in my Project?

NAudio is licensed under the Microsoft Public License (Ms-PL) which means that you can use it in whatever project you like including commercial projects. Of course we would love it if you share any bug-fixes or enhancements you made to the original NAudio project files.

Is .NET Performance Good Enough for Audio?

While .NET cannot compete with unmanaged languages for very low latency audio work, it still performs better than many people would expect. On a fairly modest PC, you can quite easily mix multiple WAV files together, including pass them through various effects and codecs, play back glitch free with a latency of around 50ms.

How can I get help?

There are three main ways to get help. If you have a specific question concerning how to use NAudio, then I recommend that you ask on StackOverflow and tag your question with naudio. This gives you the best chance of getting a quick answer. You can also ask a question on the NAudio discussion forums here on CodePlex. I attempt to answer all questions, but since this is a spare time project, occasionally I get behind. Finally, I am occasionally able to offer paid support for situations where you need quick advice, bugfixes or new features. Use the contact feature of the Codeplex website to get in touch with Mark Heath if you wish to pursue this option.

How do I submit a patch?

I welcome contributions to NAudio and have accepted many patches, but if you want your code to be included, please familiarise yourself with the following guidelines:

Your submission must be your own work, and able to be released under the MS-PL license.
You will need to make sure your code conforms to the layout and naming conventions used elsewhere in NAudio.
Remember that there are many existing users of NAudio. A patch that changes the public interface is not likely to be accepted.
Try to write "clean code" - avoid long functions and long classes. Try to add a new feature by creating a new class rather than putting loads of extra code inside an existing one.
I don't usually accept contributions I can't test, so please write unit tests (using NUnit) if at all possible. If not, give a clear explanation of how your feature can be unit tested and provide test data if appropriate. Tell me what you did to test it yourself, including what operating systems and soundcards you used.
If you are adding a new feature, please consider writing a short tutorial on how to use it.
Unless your patch is a small bugfix, I will code review it and give you feedback. You will need to be willing to make the recommended changes before it can be integrated into the main code.
The easiest way to provide a patch is to create your own fork on Mercurial and issue a pull request. See this video if you are new to Mercurial.
Please also bear in mind that when you add a feature to NAudio, that feature will generate future support requests and bug reports. Are you willing to stick around on the forums and help out people using it?

How do I...?

The best way to learn how to use NAudio is to download the source code and look at the two demo applications - NAudioDemo and NAudioWpfDemo. These demonstrate several of the key capabilities of the NAudio framework. They also have the advantage of being kept up to date, whilst some of the tutorials you will find on the internet refer to old versions of NAudio.

Getting Started with NAudio – Downloading and Compiling

Download a copy of the NAudio source code (or a pre-compiled version but the newest available code is available in source form first).
http://naudio.codeplex.com/SourceControl/list/changesets
The default project is set to the NAudio class library. Class Library’s don’t have anything to look at when you press F5. If this is your first time with NAudio, set the start-up project as NAudioDemo and then hit F5. The NAudioDemo project shows the base functionality you can utilise through your own project.
In the BIN directory for the built solution, you can find a copy of the NAudio library for using and referencing in your own project. Make sure that you grab a copy of the NAudio.XML file as well if your copying it over to your own projects directory, that way you will have the intellisense documentation for use in Visual Studio when working with the NAudio API.

http://stackoverflow.com/

New Comment on "WAV"

wtheronjones — Thu, 07 Mar 2013 20:16:39 GMT

This worked for me to play a wav file: using NAudio.Wave; ..... var soundFile = "Something.wav"; using (var wfr = new WaveFileReader(soundFile)) using (WaveChannel32 wc = new WaveChannel32(wfr) {PadWithZeroes = false}) using (var audioOutput = new DirectSoundOut()) { audioOutput.Init(wc); audioOutput.Play(); while (audioOutput.PlaybackState != PlaybackState.Stopped) { Thread.Sleep(20); } audioOutput.Stop(); } In this case, the PlaybackStopped event was raised, but I guess it's not good to count on that. This would work when running as a service on Windows 7.

New Comment on "WAV"

wtheronjones — Sat, 02 Mar 2013 01:32:48 GMT

Could someone be a lamb and post a sample? I need to play a WAV file from a Windows Service on Windows 7 and this is supposed to be the solution to my problems.

Updated Wiki: Home

markheath — Tue, 26 Feb 2013 11:03:02 GMT

NAudio Overview

Latest News

For the latest news and more documentation on NAudio, visit Mark Heath's blog.

26 Oct 2012 NAudio 1.6 Released. Read the release notes
9 Sep 2012 ASIO Recording Support added
19 Dec 2011 NAudio 1.5 Released. Read the release notes
20 Apr 2011 NAudio 1.4 Released. Read the release notes
15 Apr 2011 NAudio demo now shows how to select output devices (for WaveOut, DirectSound, WASAPI and ASIO), and can play 8 bit, 16 bit, 24 bit, and 32 bit float WAV files. Fixed a longstanding ASIO issue.
7 Nov 2010 Major improvements to Mp3FileReader
10 Oct 2009 Version 1.3 Released. Read the release notes
20 Sep 2009 We are getting close to feature complete for 1.3. Last chance to get in any feedback on the API
26 Aug 2009 WPF Waveform drawing demo project including FFT added
28 Feb 2009 Lots of new stuff is being added and planned, so do check out the Source Code tab to have a sneak peak at what's coming in 1.3
26 June 2008 Version 1.2 Released. Read the release notes

NAudio Features

Play back audio using a variety of APIs
- WaveOut
- DirectSound
- ASIO
- WASAPI (Windows Vista and above)
Decompress audio from different Wave Formats
- MP3 decode using ACM or DMO codec
- AIFF
- G.711 mu-law and a-law
- ADPCM
- G.722
- Speex (using NSpeex)
- SF2 files
- Decode using any ACM codec installed on your computer
Record audio using WaveIn, WASAPI or ASIO
Read and Write standard .WAV files
Mix and manipulate audio streams using a 32 bit floating mixing engine
Extensive support for reading and writing MIDI files
Full MIDI event model
Basic support for Windows Mixer APIs
A collection of useful Windows Forms Controls
Some basic audio effects, including a compressor

Projects Using NAudio

Skype Voice Changer - Modify your voice with audio effects while talking on Skype
.NET Voice Recorder - Record your voice, save to MP3, and visualise the waveform using WPF. Now includes autotune
MIDI File Mapper - Utility for mapping MIDI drum files for use on other samplers
MIDI File Splitter - Split MIDI files up at their markers
SharpMod - managed port of MikMod, can play mod files in both WinForms and Silverlight
NVorbis - Fully managed Vorbis decoder, with support for NAudio
Practice# - Windows tool for practicing playing an instrument with playback music. Includes FLAC playback support and an equaliser for NAudio.
WPF Sound Visualization Library - beautiful waveform and spectrum analyzer code written for WPF, comes with NAudio sample
Sound Mill - an audio player, list organizer and automation manager
Bravura Studio - a modular, extensible application and platform for creating and experimenting with music and audio.
SIPSorcery - .NET softphone framework
Squiggle - A free open source LAN Messenger
Helix 3D toolkit
airphone-tv - A revival of axStream to implement control through the iPhone
JamNet - a Silverlight drum sample player
Jingle Jim - Jingle Software (German language)
All My Music
iSpy - Open Source Camera Security Software
RadioTuna - Online internet radio player
Fire Talk New - chat program
AVR Audio Guard - utility to fix a HDMI related issue

More Info

For more information, please visit the NAudio Documentation Wiki

Donate

NAudio is a free open source project that is developed in personal time. You can show your appreciation for NAudio and support future development by donating.

Updated Wiki: Home

markheath — Mon, 25 Feb 2013 10:09:23 GMT

NAudio Overview

Latest News

For the latest news and more documentation on NAudio, visit Mark Heath's blog.

26 Oct 2012 NAudio 1.6 Released. Read the release notes
9 Sep 2012 ASIO Recording Support added
19 Dec 2011 NAudio 1.5 Released. Read the release notes
20 Apr 2011 NAudio 1.4 Released. Read the release notes
15 Apr 2011 NAudio demo now shows how to select output devices (for WaveOut, DirectSound, WASAPI and ASIO), and can play 8 bit, 16 bit, 24 bit, and 32 bit float WAV files. Fixed a longstanding ASIO issue.
7 Nov 2010 Major improvements to Mp3FileReader
10 Oct 2009 Version 1.3 Released. Read the release notes
20 Sep 2009 We are getting close to feature complete for 1.3. Last chance to get in any feedback on the API
26 Aug 2009 WPF Waveform drawing demo project including FFT added
28 Feb 2009 Lots of new stuff is being added and planned, so do check out the Source Code tab to have a sneak peak at what's coming in 1.3
26 June 2008 Version 1.2 Released. Read the release notes

NAudio Features

Play back audio using a variety of APIs
- WaveOut
- DirectSound
- ASIO
- WASAPI (Windows Vista and above)
Decompress audio from different Wave Formats
- MP3 decode using ACM or DMO codec
- AIFF
- G.711 mu-law and a-law
- ADPCM
- G.722
- Speex (using NSpeex)
- SF2 files
- Decode using any ACM codec installed on your computer
Record audio using WaveIn, WASAPI or ASIO
Read and Write standard .WAV files
Mix and manipulate audio streams using a 32 bit floating mixing engine
Extensive support for reading and writing MIDI files
Full MIDI event model
Basic support for Windows Mixer APIs
A collection of useful Windows Forms Controls
Some basic audio effects, including a compressor

Projects Using NAudio

Skype Voice Changer - Modify your voice with audio effects while talking on Skype
.NET Voice Recorder - Record your voice, save to MP3, and visualise the waveform using WPF. Now includes autotune
MIDI File Mapper - Utility for mapping MIDI drum files for use on other samplers
MIDI File Splitter - Split MIDI files up at their markers
SharpMod - managed port of MikMod, can play mod files in both WinForms and Silverlight
NVorbis - Fully managed Vorbis decoder, with support for NAudio
Practice# - Windows tool for practicing playing an instrument with playback music. Includes FLAC playback support and an equaliser for NAudio.
WPF Sound Visualization Library - beautiful waveform and spectrum analyzer code written for WPF, comes with NAudio sample
Sound Mill - an audio player, list organizer and automation manager
SIPSorcery - .NET softphone framework
Squiggle - A free open source LAN Messenger
Helix 3D toolkit
airphone-tv - A revival of axStream to implement control through the iPhone
JamNet - a Silverlight drum sample player
Jingle Jim - Jingle Software (German language)
All My Music
iSpy - Open Source Camera Security Software
RadioTuna - Online internet radio player
Fire Talk New - chat program
AVR Audio Guard - utility to fix a HDMI related issue

More Info

For more information, please visit the NAudio Documentation Wiki

Donate

NAudio is a free open source project that is developed in personal time. You can show your appreciation for NAudio and support future development by donating.

New Comment on "WAV"

jjxtra — Wed, 13 Feb 2013 01:35:02 GMT

So... is this page going to be updated ever?

New Comment on "MP3"

ggsmartboy — Thu, 07 Feb 2013 05:21:47 GMT

How to convert an wav file to mp3 using Naudio or can we able to convert the wave file to mp3 using Naudio. . .

Updated Wiki: Documentation

markheath — Thu, 03 Jan 2013 11:49:25 GMT

The NAudio Documentation Wiki

NAudio FAQ

What is NAudio?

Why NAudio?

Can I Use NAudio in my Project?

Is .NET Performance Good Enough for Audio?

How can I get help?

How do I submit a patch?

I welcome contributions to NAudio and have accepted many patches, but if you want your code to be included, please familiarise yourself with the following guidelines:

Your submission must be your own work, and able to be released under the MS-PL license.
You will need to make sure your code conforms to the layout and naming conventions used elsewhere in NAudio.
Remember that there are many existing users of NAudio. A patch that changes the public interface is not likely to be accepted.
Try to write "clean code" - avoid long functions and long classes. Try to add a new feature by creating a new class rather than putting loads of extra code inside an existing one.
I don't usually accept contributions I can't test, so please write unit tests (using NUnit) if at all possible. If not, give a clear explanation of how your feature can be unit tested and provide test data if appropriate. Tell me what you did to test it yourself, including what operating systems and soundcards you used.
If you are adding a new feature, please consider writing a short tutorial on how to use it.
Unless your patch is a small bugfix, I will code review it and give you feedback. You will need to be willing to make the recommended changes before it can be integrated into the main code.
The easiest way to provide a patch is to create your own fork on Mercurial and issue a pull request. See this video if you are new to Mercurial.
Please also bear in mind that when you add a feature to NAudio, that feature will generate future support requests and bug reports. Are you willing to stick around on the forums and help out people using it?

How do I...?

Getting Started with NAudio – Downloading and Compiling

Download a copy of the NAudio source code (or a pre-compiled version but the newest available code is available in source form first).
http://naudio.codeplex.com/SourceControl/list/changesets
The default project is set to the NAudio class library. Class Library’s don’t have anything to look at when you press F5. If this is your first time with NAudio, set the start-up project as NAudioDemo and then hit F5. The NAudioDemo project shows the base functionality you can utilise through your own project.
In the BIN directory for the built solution, you can find a copy of the NAudio library for using and referencing in your own project. Make sure that you grab a copy of the NAudio.XML file as well if your copying it over to your own projects directory, that way you will have the intellisense documentation for use in Visual Studio when working with the NAudio API.

Additional Tutorials from OpenSebJ's blog (n.b. these are for NAudio 1.3):

http://stackoverflow.com/

Updated Wiki: Convert a MP3 to WAV

markheath — Thu, 03 Jan 2013 11:47:48 GMT

MP3

Convert an MP3 to WAV

1) Add the using references for NAudio to your project:

using NAudio;
using NAudio.Wave;

2) Assuming that you are going to find the location of a MP3 and save the WAV file to the same location:

public static void Mp3ToWav(string mp3File, string outputFile)
{
    using (Mp3FileReader reader = new Mp3FileReader(mp3File))
    {
        WaveFileWriter.CreateWaveFile(outputFile, reader);
    }
}

3) You now have a WAV file in the directory of your MP3.

The complete sample program:

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;

using NAudio;
using NAudio.Wave;

namespace ConvertMP3toWAV
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void cmbOpen_Click(object sender, EventArgs e)
        {
            OpenFileDialog openFileDialog = new OpenFileDialog();
            openFileDialog.Filter = "MP3 Files (*.mp3)|*.mp3|All Files (*.*)|*.*";
            openFileDialog.FilterIndex = 1;
            if (openFileDialog.ShowDialog() == DialogResult.OK)
            {
                txtLocation.Text = openFileDialog.FileName;
            }
        }

        private void cmbConvert_Click(object sender, EventArgs e)
        {
            string outputFileName = txtLocation.Text;
            outputFileName = outputFileName.Substring(0, txtLocation.TextLength - 3) + "wav";
            Mp3ToWav(txtLocation.Text, outputFileName);
        }

        public static void Mp3ToWav(string mp3File, string outputFile)
        {
            using (Mp3FileReader reader = new Mp3FileReader(mp3File))
            {
                WaveFileWriter.CreateWaveFile(outputFile, reader);
            }
        }
    }
}

New Comment on "Convert a MP3 to WAV"

slygamer — Thu, 13 Dec 2012 13:34:23 GMT

@D1mex: This is a partial class of a WinForms form. It is assumed that you have a form that contains a Label called txtLocation, a Button called cmbOpen and Button called cmbConvert. The Click events of those buttons are linked to cmbOpen_Click and cmbConvert_Click respectively.

New Comment on "MP3"

simon_mb — Mon, 10 Dec 2012 23:22:23 GMT

Hi Mark, what do you think about this MatrixBus Implementation? I don't know if I got all the locks right... public class BusMatrixWaveProvider : IWaveProvider { private readonly IList<IWaveProvider> inputs; private readonly WaveFormat waveFormat; private readonly int outputChannelCount; private int inputChannelCount; private readonly int bytesPerSample; private float[] volumes; public float GetVolume(int inputIndex, int outputIndex) { if (inputIndex < 0 || inputIndex >= InputChannelCount) { throw new ArgumentException("Invalid input channel"); } if (outputIndex < 0 || outputIndex >= OutputChannelCount) { throw new ArgumentException("Invalid output channel"); } lock (volumes) { int index = inputIndex + (outputIndex * inputChannelCount); return volumes[index]; } } public void SetVolume(int inputIndex, int outputIndex, float value) { if (inputIndex < 0 || inputIndex >= InputChannelCount) { throw new ArgumentException("Invalid input channel"); } if (outputIndex < 0 || outputIndex >= OutputChannelCount) { throw new ArgumentException("Invalid output channel"); } lock (volumes) { int index = inputIndex + (outputIndex * inputChannelCount); volumes[index] = value; } } public void AddInput(IWaveProvider waveProvider) { lock (volumes) { //inputChannelCount += 1; inputChannelCount += waveProvider.WaveFormat.Channels; lock (inputs) { this.inputs.Add(waveProvider); Array.Resize<float>(ref volumes, outputChannelCount * inputChannelCount); } } } public void RemoveInput(IWaveProvider waveProvider) { int index = inputs.IndexOf(waveProvider); if (index == -1) throw new ArgumentException("input was not found in this mixer"); lock (volumes) { //inputChannelCount -= 1; int inputChannels = waveProvider.WaveFormat.Channels; inputChannelCount -= inputChannels; lock (inputs) { inputs.Remove(waveProvider); int offset = 0; for (int i = index; i < volumes.Length; i += (inputChannelCount + inputChannels)) { Array.Copy(volumes, i + inputChannels, volumes, i - offset, inputChannelCount); offset += inputChannels; } Array.Resize<float>(ref volumes, outputChannelCount * inputChannelCount); } } } public void RemoveInput(int index) { if (index > inputs.Count-1 || index < 0) throw new ArgumentOutOfRangeException("index was not found in this bus"); RemoveInput(inputs[index]); } /// <summary> /// Creates a mixing wave provider, allowing mixing of input channels to different /// output channels /// </summary> /// <param name="numberOfOutputChannels">Desired number of output channels.</param> public BusMatrixWaveProvider(int numberOfOutputChannels) { this.outputChannelCount = numberOfOutputChannels; if (numberOfOutputChannels < 1) { throw new ArgumentException("You must provide at least one output"); } } /// <summary> /// Creates a mixing wave provider, allowing mixing of input channels to different /// output channels /// </summary> /// <param name="inputs">Input wave providers. Must all be of the same format, but can have any number of channels</param> /// <param name="numberOfOutputChannels">Desired number of output channels.</param> public BusMatrixWaveProvider(IEnumerable<IWaveProvider> inputs, int numberOfOutputChannels) { this.inputs = new List<IWaveProvider>(inputs); this.outputChannelCount = numberOfOutputChannels; if (this.inputs.Count == 0) { throw new ArgumentException("You must provide at least one input"); } if (numberOfOutputChannels < 1) { throw new ArgumentException("You must provide at least one output"); } foreach (var input in this.inputs) { if (this.waveFormat == null) { if (input.WaveFormat.Encoding == WaveFormatEncoding.Pcm) { this.waveFormat = new WaveFormat(input.WaveFormat.SampleRate, input.WaveFormat.BitsPerSample, numberOfOutputChannels); } else if (input.WaveFormat.Encoding == WaveFormatEncoding.IeeeFloat) { this.waveFormat = WaveFormat.CreateIeeeFloatWaveFormat(input.WaveFormat.SampleRate, numberOfOutputChannels); } else { throw new ArgumentException("Only PCM and 32 bit float are supported"); } } else { if (input.WaveFormat.BitsPerSample != this.waveFormat.BitsPerSample) { throw new ArgumentException("All inputs must have the same bit depth"); } if (input.WaveFormat.SampleRate != this.waveFormat.SampleRate) { throw new ArgumentException("All inputs must have the same sample rate"); } } inputChannelCount += input.WaveFormat.Channels; } this.bytesPerSample = this.waveFormat.BitsPerSample / 8; this.volumes = new float[this.inputChannelCount * this.outputChannelCount]; } private byte[] inputBuffer; public int Read(byte[] buffer, int offset, int count) { //byte[] tempbuffer = new byte[count]; Array.Clear(buffer, offset, count); int outputBytesPerFrame = bytesPerSample * outputChannelCount; int sampleFramesRequested = count / outputBytesPerFrame; int sampleFramesRead = 0; lock (volumes) { // now we must read from all inputs, even if we don't need their data, so they stay in sync for (int inputIndex = 0; inputIndex < inputChannelCount; inputIndex++) { int inputBytesPerFrame = bytesPerSample; int bytesRequired = sampleFramesRequested * inputBytesPerFrame; this.inputBuffer = BufferHelpers.Ensure(this.inputBuffer, bytesRequired); lock (inputs) { int bytesRead = inputs[inputIndex].Read(inputBuffer, 0, bytesRequired); sampleFramesRead = Math.Max(sampleFramesRead, bytesRead / inputBytesPerFrame); Sum32BitAudio(buffer, inputBuffer, bytesRead, inputBytesPerFrame, inputIndex, outputChannelCount, volumes); } } } return sampleFramesRead * outputBytesPerFrame; } /// <summary> /// Actually performs the mixing /// </summary> private static unsafe void Sum32BitAudio( byte[] destBuffer, byte[] sourceBuffer, int bytesRead, int inputBytesPerFrame, int inputIndex, int outputChannelCount, float[] volumes) { fixed (byte* pDestBuffer = &destBuffer[0], pSourceBuffer = &sourceBuffer[0]) { fixed (float* volume = &volumes[inputIndex]) { float* pfDestBuffer = (float*)pDestBuffer; float* pfReadBuffer = (float*)pSourceBuffer; int samplesRead = bytesRead / inputBytesPerFrame; for (int n = 0; n < samplesRead; n++) { for (int nOutput = 0; nOutput < outputChannelCount; nOutput++) { //pfDestBuffer[(n * outputChannelCount) + nOutput] += (pfReadBuffer[n]); pfDestBuffer[n + nOutput] += (pfReadBuffer[n] * volume[outputChannelCount * nOutput]); } } } } } public WaveFormat WaveFormat { get { return waveFormat; } } public int InputChannelCount { get { return inputChannelCount; } } public int OutputChannelCount { get { return outputChannelCount; } } }

New Comment on "Convert a MP3 to WAV"

D1mex — Sat, 24 Nov 2012 06:37:33 GMT

"txtLocation" not in the present context?

Updated Wiki: Documentation

markheath — Sat, 10 Nov 2012 07:53:21 GMT

The NAudio Documentation Wiki

NAudio FAQ

What is NAudio?

Why NAudio?

Can I Use NAudio in my Project?

Is .NET Performance Good Enough for Audio?

How can I get help?

How do I submit a patch?

I welcome contributions to NAudio and have accepted many patches, but if you want your code to be included, please familiarise yourself with the following guidelines:

Your submission must be your own work, and able to be released under the MS-PL license.
You will need to make sure your code conforms to the layout and naming conventions used elsewhere in NAudio.
Remember that there are many existing users of NAudio. A patch that changes the public interface is not likely to be accepted.
Try to write "clean code" - avoid long functions and long classes. Try to add a new feature by creating a new class rather than putting loads of extra code inside an existing one.
I don't usually accept contributions I can't test, so please write unit tests (using NUnit) if at all possible. If not, give a clear explanation of how your feature can be unit tested and provide test data if appropriate. Tell me what you did to test it yourself, including what operating systems and soundcards you used.
If you are adding a new feature, please consider writing a short tutorial on how to use it.
Unless your patch is a small bugfix, I will code review it and give you feedback. You will need to be willing to make the recommended changes before it can be integrated into the main code.
The easiest way to provide a patch is to create your own fork on Mercurial and issue a pull request. See this video if you are new to Mercurial.
Please also bear in mind that when you add a feature to NAudio, that feature will generate future support requests and bug reports. Are you willing to stick around on the forums and help out people using it?

How do I...?

Getting Started with NAudio – Downloading and Compiling

Download a copy of the NAudio source code (or a pre-compiled version but the newest available code is available in source form first).
http://naudio.codeplex.com/SourceControl/list/changesets
The default project is set to the NAudio class library. Class Library’s don’t have anything to look at when you press F5. If this is your first time with NAudio, set the start-up project as NAudioDemo and then hit F5. The NAudioDemo project shows the base functionality you can utilise through your own project.
In the BIN directory for the built solution, you can find a copy of the NAudio library for using and referencing in your own project. Make sure that you grab a copy of the NAudio.XML file as well if your copying it over to your own projects directory, that way you will have the intellisense documentation for use in Visual Studio when working with the NAudio API.

Additional Tutorials from OpenSebJ's blog (n.b. these are for NAudio 1.3):

http://stackoverflow.com/

Updated Wiki: Home

markheath — Sat, 27 Oct 2012 07:33:30 GMT

NAudio Overview

Latest News

For the latest news and more documentation on NAudio, visit Mark Heath's blog.

26 Oct 2012 NAudio 1.6 Released. Read the release notes
9 Sep 2012 ASIO Recording Support added
19 Dec 2011 NAudio 1.5 Released. Read the release notes
20 Apr 2011 NAudio 1.4 Released. Read the release notes
15 Apr 2011 NAudio demo now shows how to select output devices (for WaveOut, DirectSound, WASAPI and ASIO), and can play 8 bit, 16 bit, 24 bit, and 32 bit float WAV files. Fixed a longstanding ASIO issue.
7 Nov 2010 Major improvements to Mp3FileReader
10 Oct 2009 Version 1.3 Released. Read the release notes
20 Sep 2009 We are getting close to feature complete for 1.3. Last chance to get in any feedback on the API
26 Aug 2009 WPF Waveform drawing demo project including FFT added
28 Feb 2009 Lots of new stuff is being added and planned, so do check out the Source Code tab to have a sneak peak at what's coming in 1.3
26 June 2008 Version 1.2 Released. Read the release notes

NAudio Features

Play back audio using a variety of APIs
- WaveOut
- DirectSound
- ASIO
- WASAPI (Windows Vista and above)
Decompress audio from different Wave Formats
- MP3 decode using ACM or DMO codec
- AIFF
- G.711 mu-law and a-law
- ADPCM
- G.722
- Speex (using NSpeex)
- SF2 files
- Decode using any ACM codec installed on your computer
Record audio using WaveIn, WASAPI or ASIO
Read and Write standard .WAV files
Mix and manipulate audio streams using a 32 bit floating mixing engine
Extensive support for reading and writing MIDI files
Full MIDI event model
Basic support for Windows Mixer APIs
A collection of useful Windows Forms Controls
Some basic audio effects, including a compressor

Projects Using NAudio

Skype Voice Changer - Modify your voice with audio effects while talking on Skype
.NET Voice Recorder - Record your voice, save to MP3, and visualise the waveform using WPF. Now includes autotune
MIDI File Mapper - Utility for mapping MIDI drum files for use on other samplers
MIDI File Splitter - Split MIDI files up at their markers
SharpMod - managed port of MikMod, can play mod files in both WinForms and Silverlight
NVorbis - Fully managed Vorbis decoder, with support for NAudio
Practice# - Windows tool for practicing playing an instrument with playback music. Includes FLAC playback support and an equaliser for NAudio.
WPF Sound Visualization Library - beautiful waveform and spectrum analyzer code written for WPF, comes with NAudio sample
SIPSorcery - .NET softphone framework
Squiggle - A free open source LAN Messenger
Helix 3D toolkit
airphone-tv - A revival of axStream to implement control through the iPhone
JamNet - a Silverlight drum sample player
Jingle Jim - Jingle Software (German language)
All My Music
iSpy - Open Source Camera Security Software
RadioTuna - Online internet radio player
Fire Talk New - chat program
AVR Audio Guard - utility to fix a HDMI related issue

More Info

For more information, please visit the NAudio Documentation Wiki

Donate

NAudio is a free open source project that is developed in personal time. You can show your appreciation for NAudio and support future development by donating.

New Comment on "Create an ID3v2 Tag"

FabioSilva — Thu, 27 Sep 2012 00:20:24 GMT

Hi, markheat, I like to read, you have an example? Thanks

New Comment on "MP3"

eejake52 — Thu, 20 Sep 2012 20:35:25 GMT

To answer my own question: MP3, WMA, and AIFF are possible; no sign of M4A. Here is my version of CreateInputStream: Private Function CreateInputStream(ByRef fileName As String) As WaveStream Dim inputStream As WaveChannel32 Dim fReader As WaveStream If fileName.EndsWith(".aiff") Then fReader = New AiffFileReader(fileName) ElseIf fileName.EndsWith(".mp3") Then fReader = New Mp3FileReader(fileName) ElseIf fileName.EndsWith(".wma") Then fReader = New WMAFileReader(fileName) Else Throw New InvalidOperationException("Invalid file extension") End If inputStream = New WaveChannel32(fReader) Return inputStream End Function

New Comment on "MP3"

eejake52 — Thu, 20 Sep 2012 19:28:28 GMT

I created a player using VB.NET. It was very easy to follow your example. It only plays MP3 files. What other file types are supported/allowed? I am hoping for M4A and AIFF; WMA would be nice but not essential.