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.