analyzeAudio

Measure one or more aspects of one or more audio files.

Note well: FFmpeg & FFprobe binaries must be in PATH

Some options to download FFmpeg and FFprobe at ffmpeg.org.

Some ways to use this package

Use analyzeAudioFile to measure one or more aspects of a single audio file

from analyzeAudio import analyzeAudioFile
listAspectNames = ['LUFS integrated', 
                   'RMS peak', 
                   'SRMR mean', 
                   'Spectral Flatness mean']
listMeasurements = analyzeAudioFile(pathFilename, listAspectNames)

Use getListAvailableAudioAspects to get a crude list of aspects this package can measure

The aspect names are accurate, but the lack of additional documentation can make things challenging. 'Zero-crossing rate', 'Zero-crossing rate mean', and 'Zero-crossings rate', for example, are different from each other. ("... lack of additional documentation ...")

import analyzeAudio
analyzeAudio.getListAvailableAudioAspects()

Use analyzeAudioListPathFilenames to measure one or more aspects of individual file in a list of audio files

Use audioAspects to call an analyzer function by using the name of the aspect you wish to measure

from analyzeAudio import audioAspects
SI_SDR_channelsMean = audioAspects['SI-SDR mean']['analyzer'](pathFilenameAudioFile, pathFilenameDifferentAudioFile)

Retrieve the names of the parameters for an analyzer function with the ['analyzerParameters'] key-name.

from analyzeAudio import audioAspects
print(audioAspects['Chromagram']['analyzerParameters'])

Install this package

From Github

pip install analyzeAudio@git+https://github.com/hunterhogan/analyzeAudio.git

From a local directory

Windows

git clone https://github.com/hunterhogan/analyzeAudio.git \path\to\analyzeAudio
pip install analyzeAudio@file:\path\to\analyzeAudio

POSIX

git clone https://github.com/hunterhogan/analyzeAudio.git /path/to/analyzeAudio
pip install analyzeAudio@file:/path/to/analyzeAudio

Install updates

pip install --upgrade analyzeAudio@git+https://github.com/hunterhogan/analyzeAudio.git