Installation on Microsoft Windows

Audio Tuner and its GUI are available on PyPI:

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

You will have to install some dependencies manually.

Dependencies

You’ll need to make sure Python version 3.11 or higher and libmpv2 version 0.40.0 or higher are installed. If you have a package manager than can install those, use that.

If not, install Python and libmpv2 according to the following instructions:

Python

Python is available at https://www.python.org/downloads/. Download the appropriate installer and run it.

libmpv2

Go to https://github.com/shinchiro/mpv-winbuild-cmake/releases.
Download one of the mpv-dev-x86_64 compressed archives (there’s one for x86_64 architecture and one for x86_64-v3 architecture. Either one should work on a modern computer.)
Extract the archive. It should have libmpv-2.dll in it somewhere.
Put libmpv-2.dll in a folder where where Audio Tuner can find it (in other words, somewhere in your system’s %PATH%).

Note

Audio Tuner can use ffmpeg instead of libmpv2, with some caveats: The player and export functionality in the GUI won’t work, among other things. See the backends option in the Configuration File for details.

Everything Else

The following dependencies will be installed automatically by pip:

Added in version 0.12.0: shtab dependency

If you install the GUI, one more dependency will be automatically installed:

PyQt6

Installing the Audio Tuner base package (CLI and library):

Open a terminal and run:

py -m pip install audio-tuner

The tuner command and the audio_tuner python library should now be installed and ready to use.

Installing the GUI

Open a terminal and run:

py -m pip install audio-tuner-gui

tuner-gui should now be available.

Note

If you didn’t install the base package, it will be installed automatically as a dependency when you install audio-tuner-gui.

Uninstalling

To uninstall the GUI:

py -m pip uninstall audio_tuner_gui

To uninstall the base package:

py -m pip uninstall audio_tuner

Upgrading from a Previous Version

To upgrade the base package:

py -m pip install --upgrade audio_tuner

If the GUI is installed, run this to upgrade it:

py -m pip install --upgrade audio_tuner-gui

Optional Extras

You can install additional dependencies for more functionality.

Colorama

https://github.com/tartley/colorama

Audio Tuner’s command line interface tuner controls the color of it’s output to make it easier to read. This is more difficult on Windows because the Windows terminal doesn’t understand standard ANSI escape sequences. To make colored terminal output work on Windows, Colorama needs to be installed.

To install:

py -m pip install colorama

Matplotlib

http://matplotlib.org/

Matplotlib enables tuner and tuner-gui to display plots of the audio spectrum.

To install:

py -m pip install matplotlib