TUNER-GUI

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
positional arguments:
tuning options:
analysis options:
low level options:
miscellaneous options:
BUGS
COPYRIGHT
SEE ALSO

NAME

tuner-gui - Audio Tuner GUI frontend

SYNOPSIS

tuner-gui [options] [file...]

DESCRIPTION

This is the GUI for Audio Tuner. Command line arguments can be used to run with different default settings. Arguments not listed here will be passed to the Qt GUI toolkit.

OPTIONS

positional arguments:

file

File(s) to analyze.

tuning options:

--tuning SYSTEM

Use SYSTEM as the tuning system. Default: equal_temperament

--ref-note NOTE

Use NOTE as the frequency reference note. Default: A4

--ref-freq FREQ

Frequency of the reference note.

analysis options:

--start TIME

Ignore the audio before TIME.

--end TIME

Ignore the audio after TIME.

--low-cut FREQ

Ignore frequencies below FREQ. Default: 20

--high-cut FREQ

Ignore frequencies above FREQ. Default: 15000

--dB-range RANGE

Ignore frequencies RANGE dB fainter than the highest peak. Default: 30

--max-peaks N

Maximum number of frequencies to show. Default: 10

low level options:

-s, --size-exp N

Use 2ˆN + 1 frequency bins in the spectrum. Default: 15 (32769 bins). Adjust this with care, and don’t go above 19 unless you know what you’re doing.

--samplerate FREQ

Convert the audio to a sample rate of FREQ.

--nopad

Does nothing. It’s only here for backwards compatibility and may be removed entirely in a future version.

miscellaneous options:

--savefile SAVEFILE

Which file to use for file specific options. The default varies by platform. Use the ‘--default_savefile_path‘ option to find out what it is on your system.

--default-savefile-path

Show the default path of the savefile and exit.

--config CONFIG

Which configuration file to read. The default varies by platform. Use the ‘--default_config_path‘ option to find out what it is on your system.

--default-config-path

Show the default path of the configuration file and exit.

--print-completion {bash,zsh,tcsh}

print shell completion script

--version

show version information and exit

-h, --help

show this help message and exit

Available tuning systems are "equal_temperament" and "pythagorean". Frequencies are in Hz. For backwards compatibility, underscores can be used instead of dashes in the middle of option names.

Times can be specified as a number of seconds, or in mm:ss or hh:mm:ss format. It doesn’t have to be an integer number of seconds; decimal points are allowed. Negative times are relative to the end of the audio (for example, -5 means 5 seconds before the end). Percentages are also allowed (for example. 50% means halfway through).

BUGS

https://codeberg.org/bluesloth/audio_tuner/issues

COPYRIGHT

Copyright © 2025, 2026 Jessie Blue Cassell.
License GPLv3+: GNU GPL version 3 or later
<https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

tuner(1)

HTML documentation is avaliable at
https://audio-tuner.readthedocs.io/