Audio Tuner
A tool for musicians that analyzes and corrects the pitch of recorded audio.
Base package on PyPI: https://pypi.org/project/audio-tuner/
GUI on PyPI: https://pypi.org/project/audio-tuner-gui/
Codeberg page: https://codeberg.org/bluesloth/audio_tuner
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 has a CLI and an optional GUI, both of which are 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.
Graphical User Interface
The GUI program is tuner-gui. In addition to frequency analysis, it
includes an integrated audio player and file export capability with pitch
and/or tempo correction. Pitch and tempo can be adjusted on the fly while the
audio is playing.
The GUI is under active development, with more features and usability improvements planned for future versions. The current version is already usable, however.
tuner-gui man page in html format: tuner-gui
Command Line Interface
The CLI program is tuner. It’s designed in the spirit of the Unix
philosophy of small simple programs that do one thing well. It can give you
the pitch correction factor, and then you’ll need a different program such as
mpv to play the audio with the correction applied.
tuner man page in html format: tuner
Python Library
The package with the CLI program also includes the Python library
audio_tuner which can be used to analyze audio frequencies in your own
projects.
Free as in Freedom
Audio Tuner and it’s documentation are 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.
Installation
Configuration File
A configuration file is not required, but you can make one to change the default settings if you like.
Troubleshooting
The bug tracker is at https://codeberg.org/bluesloth/audio_tuner/issues