ref: d2af4085e1b9f8c0af6aad661a7059ac8690e037
dir: /doc/aubio.txt/
NAME aubio - a command line tool to extract information from sound files SYNOPSIS aubio [-h] [-V] <command> ... COMMANDS The general syntax is "aubio <command> <soundfile> [options]". The following commands are available: onset get onset times pitch extract fundamental frequency beat get locations of beats tempo get overall tempo in bpm notes get midi-like notes mfcc extract mel-frequency cepstrum coefficients melbands extract mel-frequency energies per band For a list of available commands, use "aubio -h". For more info about each command, use "aubio <command> --help". GENERAL OPTIONS These options can be used before any command has been specified. -h, --help show help message and exit -V, --version show version COMMON OPTIONS The following options can be used with all commands: <source_uri>, -i <source_uri>, --input <source_uri> input sound file to analyse (required) -r <freq>, --samplerate <freq> samplerate at which the file should be represented (default: 0, e.g. samplerate of the input sound) -H <size>, --hopsize <size> overlap size, number of samples between two consecutive analysis (default: 256) -B <size>, --bufsize <size> buffer size, number of samples used for each analysis, (e.g. FFT length, default: 512) -h, --help show help message and exit -T format, --time-format format select time values output format (samples, ms, seconds) (default: seconds) -v, --verbose be verbose (increment verbosity by 1, default: 1) -q, --quiet be quiet (set verbosity to 0) ONSET The following additional options can be used with the "onset" subcommand. -m <method>, --method <method> onset novelty function <default|energy|hfc|complex|phase|specdiff|kl|mkl|specflux> (default: default) -t <threshold>, --threshold <threshold> threshold (default: unset) -s <value>, --silence <value> silence threshold, in dB (default: -70) -M <value>, --minioi <value> minimum Inter-Onset Interval (default: 12ms) PITCH The following additional options can be used with the "pitch" subcommand. -m <method>, --method <method> pitch detection method <default|yinfft|yin|mcomb|fcomb|schmitt> (default: default, e.g. yinfft) -t <threshold>, --threshold <threshold> tolerance (default: unset) -s <value>, --silence <value> silence threshold, in dB (default: -70) The default buffer size for the beat algorithm is 2048. The default hop size is 256. BEAT The "beat" command accepts all common options and no additional options. The default buffer size for the beat algorithm is 1024. The default hop size is 512. TEMPO The "tempo" command accepts all common options and no additional options. The default buffer size for the beat algorithm is 1024. The default hop size is 512. NOTES The following additional options can be used with the "notes" subcommand. -s <value>, --silence <value> silence threshold, in dB (default: -70) -d <value>, --release-drop <value> release drop level, in dB. If the level drops more than this amount since the last note started, the note will be turned off (default: 10). MFCC The "mfcc" command accepts all common options and no additional options. MELBANDS The "melbands" command accepts all common options and no additional options. EXAMPLES Extract onsets using a minimum inter-onset interval of 30ms: aubio onset /path/to/input_file -M 30ms Extract pitch with method "mcomb" and a silence threshold of -90dB: aubio pitch /path/to/input_file -m mcomb -s -90.0 Extract MFCC using the standard Slaney implementation: aubio mfcc /path/to/input_file -r 44100 SEE ALSO aubiocut(1) AUTHOR This manual page was written by Paul Brossier <piem@aubio.org>. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.