Skip to content
A simple class library that facilitates recording audio in Windows desktop applications.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
AudioRecorder.VisualBasic
AudioRecorder
BasicAudio.VisualBasic
BasicAudio
.gitignore Version 1.3: Slight refactors, upgrade to Visual Studio 2019 and .Net… Apr 5, 2019
BasicAudio.sln
LICENSE
README.md

README.md

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 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.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.

You can’t perform that action at this time.