audio-tuner 0.12.0

Analyze the tuning of audio recordings

A tool for musicians that analyzes and corrects the pitch of recorded audio.

This package provides the python library and a simple CLI front end, and can be used to analyze audio frequencies. A GUI front end is also available in the audio-tuner-gui package that can analyze audio and then play and export it with the pitch corrected.

Motivation

A surprisingly high proportion of recorded music doesn’t conform to any standard tuning system. You expect an A4 to be 440 Hz, but when you try to play along you realize it’s not. Audio Tuner is a tool for measuring the frequencies in an audio recording so it can be corrected if necessary. It’s designed to be convenient enough to use that you can do it with a musical instrument strapped to you.

The primary use case is to correct the tuning of your favorite songs so you can practice playing an instrument by playing along with them, but it can be used in any situation where you need to analyze and correct the pitch of a recording.

What it’s not

Audio Tuner is not autotune. It pitch corrects entire songs, not individual notes.

CLI Usage

Type ‘tuner’ at a shell prompt followed by the name(s) of the file(s) you want to analyze.

For more detailed usage information, run:

tuner --help

Dependencies

Audio Tuner requires Python version 3.11 or higher and libmpv2. In addition, The following dependencies will be installed automatically by pip or pipx:

• numpy

• python-mpv

• platformdirs

• shtab

On Windows, namedpipe will also be installed.

Note that pip is not able to install libmpv2. If your operating system has a package manager, use that to install it. See the documentation for details.

Audio Tuner can be configured to use ffmpeg and ffprobe instead of libmpv2, but this is not recommended if you intend to use the GUI.

Free as in Freedom

Audio Tuner is licensed under the GNU General Public License version 3 or later.

See What is Free Software? and Copyleft: Pragmatic Idealism.

Versioning

Audio Tuner attempts to use Semantic Versioning, but with PEP 440 compatible version numbers.

New versions of the base Audio Tuner package and Audio Tuner GUI are released at the same time with the same version numbers. The API is already reasonably stable, but of course nothing’s guaranteed until it reaches version 1.0.0.

See Also

audio-tuner-gui: https://pypi.org/project/audio-tuner-gui/