tuner - Audio Tuner CLI frontend
tuner [options] file [file ...]
Measure audio frequencies in a recording and compare them to a standard.
|
file |
File(s) to analyze. |
--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.
--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
-c, --color
Force color output even if stdout is a pipe.
-p, --plot [{log,linear,spectrogram}]
Show a plot of the spectrum. The default type is "log".
-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.
--verbose
Enable output of verbose calculation details.
--debug
Enable debugging output.
--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.
--savefile-header PATH
Convert PATH to a savefile header 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).
https://codeberg.org/bluesloth/audio_tuner/issues
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.
tuner-gui(1)
HTML
documentation is avaliable at
https://audio-tuner.readthedocs.io/