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.