For updates and history of development please see this page.
Audiorecorder2 Note: Audiorecorder2 can now be installed along side audiorecorder by adding the flag --with-audiorecorder2
to the following homebrew install commands.
audiorecorder can be installed via homebrew on macOS and linuxbrew on Linux.
MacOS Installation: Audiorecorder can be installed via Homebrew with the following commands:
brew tap amiaopensource/amiaos
brew install audiorecorder
Linux Installation (Tested in Ubuntu 16.04)
The following division of commands seeks to install up-to-date versions of audiorecorder dependencies while avoiding conflicts.
Standard package manager commands
sudo apt-get install sox
sudo apt-get install libsdl2-2.0
Install current MPV ppa, then sudo apt-get install mpv
linuxbrew commands
brew install dialog
If FFmpeg has already been installed with these options then skip next step.
brew install ffmpeg --with-freetype
sdl2 is necessary to build FFmpeg with FFplay, but removing it after build will avoid conflicts between other installations of sdl2.
brew uninstall --ignore-dependencies sdl2
brew install --ignore-dependencies audiorecorder
Usage: [-p] passthrough mode, [-e] edit config, [-m] edit metadata for BWF insertion
To set up audiorecorder, first run the command audiorecorder -e
. This will open an interface where settings such as recording bit depth and sample rate can be selected. This is also where the option to embed BEXT metadata can be selected.
To set the metadata that will be embedded in the BEXT chunk (if activated in the configuration menu) run the command audiorecorder -m
. This will open an interface where the desired values can be entered.
1: Peak volume meters (dB)
2: Audio spectrum - lines (from left) represent 1, 5, 10, 15, 20kHz respectively
3: Recording time
4: Spectrogram
5: Audio vecorscope
6: Graph of peak volume values (dB) from -30dB to 0dB. Colored area represents -5dB to 0dB.
Running audiorecorder -p
will open the preview window. This window can be closed with the escape key. This allows you to check your settings and playback machine calibration using the audiorecorder interface without creating a file. It is recommended to use this mode before every recording. Once you are satisfied that everything is calibrated appropriately, move on to record mode.
Running the command audiorecorder
will start record mode. You will be prompted for the name of the file created. Wait until the audiorecorder interface opens, and then press play on your playback machine. During recording do not resize the window, as this can cause problems with the audio buffer. To stop recording press the escape key.
Once recording is complete, audiorecorder will process the file, and then an interface will open showing the waveform of the recorded file, as well as giving options to 'preview' and 'trim' the file.
Press 'Preview' to hear the file you recorded. To trim file, enter the amount (in seconds) to trim from the start and end of the file and press 'Trim'. If 'Start Trim' is left blank, auto-trim will be applied to start of file. If no trim at start is desired enter '0'. After trimming, a preview window will open for your new file. Trim can be run as many times as is necessary. Once you are done, press 'Finish' to finalize and quit. It is at this point that BEXT metadata will be embedded if that option has been selected.
Andrew Weaver (@privatezero)
Ashley Blewer (@ablwr)
privatezero (Andrew Weaver), retokromer (Reto Kromer), dericed (Dave Rice), todrobbins (Tod Robbins), ablwr (Ashley Blewer)
Special thanks to Matt Boyd at the University of Washington for extensive testing assistance!
The audiorecorder script is covered under a BSD 3-clause license
All documentation for audiorecorder is licensed under a Creative Commons Attribution 4.0 International License.