AUBIOCUT(1)						      General Commands Manual						       AUBIOCUT(1)

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.

																       AUBIOCUT(1)