NAME¶
aubiocut — a command line tool to extract onsets and tempo from sound
files.
SYNOPSIS¶
aubiocut [options] -i soundfile
DESCRIPTION¶
aubiocut attempts to detect onset times, the beginning of discreted sound
events, or beat locations, in audio signals.
When using the
--cut option,
aubiocut takes an input sound file
and produce small files sliced at onset locations (or silences). The slices
can then be sent for example to a player, a sequencer, or a sampler.
A plotting module is available via the Gnuplot Python package.
OPTIONS¶
This program follows the usual GNU command line syntax, with long options
starting with two dashes (`-'). A summary of options is included below.
- -i --input filein
- input sound file
- -m --mode onset_detection_mode
- onset detection mode [default=dual]
complexdomain|hfc|phase|specdiff|energy|kl|mkl|dual
- -b --beat
- detect beats and output beat locations
- -B --bufsize=BUFSIZE
- buffer size [default=512]
- -H --hopsize=HOPSIZE
- overlap size [default=256]
- -t --threshold=THRESHOLD
- onset peak picking threshold [default=0.3]
- -C --dcthreshold=DCTHRESHOLD
- onset peak picking DC component [default=1.]
- -s --silence=SILENCE
- silence threshold [default=-70]
- -M --mintol=MINIOI
- minimum inter onset interval [default=0.048s]
- -D --delay=DELAY
- number of seconds to take back [default=system] default
system delay is 3*hopsize/samplerate
- -L --localmin
- use local minima after peak detection
- -c --cut
- cut input sound file at detected labels (best used with
option -L)
- -d --derivate
- derivate onset detection function
- -S --silencecut
- outputs silence locations instead of onset locations
- -z --zerocross=ZEROTHRES
- zero-crossing threshold for slicing [default=0.00008]
- -f --function
- print detection function
- -q --quiet
- be quiet
- -h --help
- Show a summary of options.
- -v --verbose
- make lots of noise [default]
Plotting options¶
When the Python interface to Gnuplot is installed, the following additional
options are available.
- -p --plot
- draw plot
- -n --no-onsets
- do not plot detected onsets, only detection functions
- -x --xsize=SIZE
- define horizontal plot size [default=1.]
- -y --ysize=SIZE
- define vertical plot size [default=1.]
- -O --outplot=OUTPLOT
- save plot to output.{ps,eps,png,svg} instead of displaying
it
BUGS¶
For now the program has only been tested on audio signals sampled at
44.1 kHz.
SEE ALSO¶
aubioonset(1) aubiotrack(1) aubionotes(1)
aubiopitch(1)
AUTHOR¶
This manual page was written by Paul Brossier (piem@altern.org). Permission is
granted to copy, distribute and/or modify this document under the terms of the
GNU General Public License, Version 2 any later version published by the Free
Software Foundation.
On Debian systems, the complete text of the GNU General Public License can be
found in /usr/share/common-licenses/GPL.