aubiocut

Langue: en

Version: 261346 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

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.