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 --helpDependencies
Audio Tuner requires Python version 3.11 or higher and libmpv2. In addition, The following dependencies will be installed automatically by pip or pipx:
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/
1 maintainer
Metadata
1 maintainer
Release files for audio-tuner 0.12.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| audio_tuner-0.12.0.tar.gz | 39.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| audio_tuner-0.12.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 86.1 kB
Release files / audio_tuner-0.12.0.tar.gz
| Download URL | audio_tuner-0.12.0.tar.gz |
|---|---|
| Size | 39.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
16c8b13a5e3165101c5291cf6a1fc3570fabe9ee170c4e094cfbfd64496fe74a
|
|
BLAKE2b-256 checksum How to use checksums |
da0684526fda8f8cb060d3f61a845206aee1ffad6d4f24a657d8249cb0801e78
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
Release files / audio_tuner-0.12.0-py3-none-any.whl
| Download URL | audio_tuner-0.12.0-py3-none-any.whl |
|---|---|
| Size | 46.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
79b6c9f91b149080ec972a712a2e21e03e4c71aecdb93e7923f29c5d415fe665
|
|
BLAKE2b-256 checksum How to use checksums |
03078eaf3a072f5e9d5ab0700dec8f0da874d9259acb3f06a3a8cc4d6de32dfb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
