BasicAudio 2019.11.19.1

Basic audio recording for Windows desktop applications.  Although .NET Standard compliant requires Windows API's for audio recording and playback.

Install-Package BasicAudio -Version 2019.11.19.1
dotnet add package BasicAudio --version 2019.11.19.1
<PackageReference Include="BasicAudio" Version="2019.11.19.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add BasicAudio --version 2019.11.19.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Basic Audio

NuGet version (BasicAudio)
NuGet version (BasicAudio)

Basic audio is a class library with a test project (audio player/recorder) to faciliate basic audio
playing and recording. There are other frameworks available to give you very detailed and complex
audio functionality, this one aims to provide only the basic playback / record methods or provide light
weight code you can include in your project. That being the case, the goal is to keep it simple for
those that just want to incorporate playback/recording with minimal code or learning other frameworks.

If you need advanced recording and audio features I highly recommend NAudio.

Basic audio was originally written in Visual Basic but is now built off of C#. The Visual Basic
version has been left in this project for posterity.

The library provides its functionality through the mciSendString Windows API and thus binds it desktop
use cases. The playback features support wave files and mp3 files and the recoding supports wave files.
The class library contains 3 classes, one for playback, one for recording and one that is an MCI
error messages (there's an official API for this that I'll use in the future). The classes have
been kept slim to facilitate ease of use. If you're looking for very detailed recording objects
you'll want to consider another framework such as NAudio. Note
that this records through whatever the currently selected recording device is in Windows.

OS Support

  • Windows 10
  • Windows 8.1
  • Windows 8
  • Windows 7
  • Windows Vista

.Net Framework Support

  • .NET Standard 2.1
  • .NET Standard 2.0
  • .NET Standard 1.6
  • .NET Standard 1.5
  • .NET Standard 1.4
  • .NET Standard 1.3
  • .NET Framework 4.7.2
  • .NET Framework 4.7.1
  • .NET Framework 4.7
  • .NET Framework 4.6.2
  • .NET Framework 4.6.1
  • .NET Framework 4.6
  • .NET Framework 4.5.2
  • .NET Framework 4.5.1
  • .NET Framework 4.5
  • .NET Framework 4
  • .NET Framework 3.5

Start Recording Example

C#
// There are properties on this object to change the quality recording
var audioRecorder = new BasicAudio.Recording();
audioRecorder.Filename = @"c:\test.wav";
audioRecorder.StartRecording();
VB.Net
' There are properties on this object to change the quality recording
Dim audioRecorder As New BasicAudio.Recording()
audioRecorder.Filename = "c:\test.wav"
audioRecorder.StartRecording()   

Stop Recording Example

C#
// File is written out to disk when this is called.  The filename property must already be set.
audioRecorder.StopRecording();
VB.Net
' File is written out to disk when this is called.  The filename property must already be set.
audioRecorder.StopRecording()

Playback Example

C#
var audioPlayer = new BasicAudio.AudioPlayer();
audioPlayer.Filename = @"c:\test.mp3";
audioPlayer.Play();
VB.Net
Dim audioPlayer As New BasicAudio.AudioPlayer()
audioPlayer.Filename = "c:\test.mp3"
audioPlayer.Play()    ' Pause and Stop methods available

Stop Recording Example

C#
// File is written out to disk when this is called.  The filename property must already be set.
audioRecorder.StopRecording();
VB.Net
' File is written out to disk when this is called.  The filename property must already be set.
audioRecorder.StopRecording()

Troubleshooting

On some systems latency might be an issue due to installed audio drivers. If this occurs and
your sound card support ASIO drivers then it might be worth it to research ASIO for all. I
have used this on two systems in the past with success in mitigating any lag.

Basic Audio

NuGet version (BasicAudio)
NuGet version (BasicAudio)

Basic audio is a class library with a test project (audio player/recorder) to faciliate basic audio
playing and recording. There are other frameworks available to give you very detailed and complex
audio functionality, this one aims to provide only the basic playback / record methods or provide light
weight code you can include in your project. That being the case, the goal is to keep it simple for
those that just want to incorporate playback/recording with minimal code or learning other frameworks.

If you need advanced recording and audio features I highly recommend NAudio.

Basic audio was originally written in Visual Basic but is now built off of C#. The Visual Basic
version has been left in this project for posterity.

The library provides its functionality through the mciSendString Windows API and thus binds it desktop
use cases. The playback features support wave files and mp3 files and the recoding supports wave files.
The class library contains 3 classes, one for playback, one for recording and one that is an MCI
error messages (there's an official API for this that I'll use in the future). The classes have
been kept slim to facilitate ease of use. If you're looking for very detailed recording objects
you'll want to consider another framework such as NAudio. Note
that this records through whatever the currently selected recording device is in Windows.

OS Support

  • Windows 10
  • Windows 8.1
  • Windows 8
  • Windows 7
  • Windows Vista

.Net Framework Support

  • .NET Standard 2.1
  • .NET Standard 2.0
  • .NET Standard 1.6
  • .NET Standard 1.5
  • .NET Standard 1.4
  • .NET Standard 1.3
  • .NET Framework 4.7.2
  • .NET Framework 4.7.1
  • .NET Framework 4.7
  • .NET Framework 4.6.2
  • .NET Framework 4.6.1
  • .NET Framework 4.6
  • .NET Framework 4.5.2
  • .NET Framework 4.5.1
  • .NET Framework 4.5
  • .NET Framework 4
  • .NET Framework 3.5

Start Recording Example

C#
// There are properties on this object to change the quality recording
var audioRecorder = new BasicAudio.Recording();
audioRecorder.Filename = @"c:\test.wav";
audioRecorder.StartRecording();
VB.Net
' There are properties on this object to change the quality recording
Dim audioRecorder As New BasicAudio.Recording()
audioRecorder.Filename = "c:\test.wav"
audioRecorder.StartRecording()   

Stop Recording Example

C#
// File is written out to disk when this is called.  The filename property must already be set.
audioRecorder.StopRecording();
VB.Net
' File is written out to disk when this is called.  The filename property must already be set.
audioRecorder.StopRecording()

Playback Example

C#
var audioPlayer = new BasicAudio.AudioPlayer();
audioPlayer.Filename = @"c:\test.mp3";
audioPlayer.Play();
VB.Net
Dim audioPlayer As New BasicAudio.AudioPlayer()
audioPlayer.Filename = "c:\test.mp3"
audioPlayer.Play()    ' Pause and Stop methods available

Stop Recording Example

C#
// File is written out to disk when this is called.  The filename property must already be set.
audioRecorder.StopRecording();
VB.Net
' File is written out to disk when this is called.  The filename property must already be set.
audioRecorder.StopRecording()

Troubleshooting

On some systems latency might be an issue due to installed audio drivers. If this occurs and
your sound card support ASIO drivers then it might be worth it to research ASIO for all. I
have used this on two systems in the past with success in mitigating any lag.

Release Notes

Version 2019.11.19.1

- Support for .NET Standard 2.1
- Support for .NET Frameworks 4.8

Version 2019.4.5.1

- Support for .NET Standard 1.3-2.0
- Support for .NET Frameworks 3.5-4.7.2
- Recording and Playback relies on the Windows API and thus not suited for UWP or non Windows desktop development.

  • .NETFramework 3.5

    • No dependencies.
  • .NETFramework 4.0

    • No dependencies.
  • .NETFramework 4.5

    • No dependencies.
  • .NETFramework 4.5.1

    • No dependencies.
  • .NETFramework 4.5.2

    • No dependencies.
  • .NETFramework 4.6

    • No dependencies.
  • .NETFramework 4.6.1

    • No dependencies.
  • .NETFramework 4.6.2

    • No dependencies.
  • .NETFramework 4.7

    • No dependencies.
  • .NETFramework 4.7.1

    • No dependencies.
  • .NETFramework 4.7.2

    • No dependencies.
  • .NETFramework 4.8

    • No dependencies.
  • .NETStandard 1.3

  • .NETStandard 1.4

  • .NETStandard 1.5

  • .NETStandard 1.6

  • .NETStandard 2.0

    • No dependencies.
  • .NETStandard 2.1

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
2019.11.19.1 161 11/20/2019
2019.4.5.1 257 4/5/2019