Installation on a Unix-Like OS
Audio Tuner and its GUI are available on PyPI:
https://pypi.org/project/audio-tuner/
https://pypi.org/project/audio-tuner-gui/
You will have to install some dependencies manually.
Dependencies
Use your system’s package manager to make sure Python version 3.11 or higher and libmpv2 version 0.40.0 or higher are installed. You’ll also need pip or pipx to install Audio Tuner. pipx is recommended, because it can install Audio Tuner in a virtual environment in your home directory without messing with the system Python environment.
Note
pip may or may not be included in your distro’s python package. pipx is usually a separate package.
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.
The following dependencies will be installed automatically inside Audio Tuner’s virtual environment by pipx:
Added in version 0.12.0: shtab dependency
Removed in version 0.10.0: namedpipe dependency
If you install the GUI, one more dependency will be automatically installed:
Installing the GUI
To install the graphical user interface, run this as a regular user (not root):
pipx install audio-tuner-gui
tuner-gui should now be available.
Note
The audio-tuner base package is included in the same virtual environment
as a dependency of audio-tuner-gui, but pipx doesn’t make the tuner
CLI app available by default. If you want it, you can pass the
–include-deps option in the above command to tell pipx to make it
available (along with whatever apps other dependencies have), or you can
follow the instructions below to install audio-tuner into it’s own virtual
environment.
Installing the CLI on it’s own
Run this as a regular user (not root):
pipx install audio-tuner
tuner should now be available.
Uninstalling
If the GUI’s installed:
pipx uninstall audio-tuner-gui
If the CLI is installed in it’s own virtual environment:
pipx uninstall audio-tuner
Upgrading from a Previous Version
If the GUI’s installed:
pipx upgrade audio-tuner-gui
If the CLI is installed in it’s own virtual environment:
pipx upgrade audio-tuner
Optional Extras
You can install additional dependencies into Audio Tuner’s virtual environment for more features.
Matplotlib
Matplotlib enables tuner and tuner-gui to display plots of the audio
spectrum.
To install:
If the GUI’s installed:
pipx inject audio-tuner matplotlib
If the CLI is installed in it’s own virtual environment:
pipx inject audio-tuner matplotlib