130 lines
4.0 KiB
Groff
130 lines
4.0 KiB
Groff
.\" Text automatically generated by txt2man
|
||
.TH AUBIOTRACK 1 "22 July 2023" "aubio 0.4.9" "aubio User's manual"
|
||
.SH NAME
|
||
\fBaubiotrack \fP- a command line tool to extract musical beats from audio signals
|
||
\fB
|
||
.SH SYNOPSIS
|
||
.nf
|
||
.fam C
|
||
|
||
\fBaubiotrack\fP \fIsource\fP
|
||
\fBaubiotrack\fP [[\fB-i\fP] \fIsource\fP] [\fB-o\fP \fIsink\fP]
|
||
[\fB-r\fP \fIrate\fP] [\fB-B\fP \fIwin\fP] [\fB-H\fP \fIhop\fP]
|
||
[\fB-T\fP \fItime-format\fP]
|
||
[\fB-s\fP \fIsil\fP] [\fB-m\fP]
|
||
[\fB-j\fP] [\fB-N\fP \fImiditap-note\fP] [\fB-V\fP \fImiditap-velo\fP]
|
||
[\fB-v\fP] [\fB-h\fP]
|
||
|
||
.fam T
|
||
.fi
|
||
.fam T
|
||
.fi
|
||
.SH DESCRIPTION
|
||
|
||
\fBaubiotrack\fP attempts to detect beats, the time where one would intuitively be
|
||
tapping his foot.
|
||
.PP
|
||
When started with an input \fIsource\fP (\fB-i\fP/\fB--input\fP), the detected beats are given
|
||
on the console, in seconds.
|
||
.PP
|
||
When started without an input \fIsource\fP, or with the jack option (\fB-j\fP/\fB--jack\fP),
|
||
\fBaubiotrack\fP starts in jack mode.
|
||
.SH OPTIONS
|
||
|
||
This program follows the usual GNU command line syntax, with long options
|
||
starting with two dashes (--). A summary of options is included below.
|
||
.TP
|
||
.B
|
||
\fB-i\fP, \fB--input\fP \fIsource\fP
|
||
Run analysis on this audio file. Most uncompressed and
|
||
compressed are supported, depending on how aubio was built.
|
||
.TP
|
||
.B
|
||
\fB-o\fP, \fB--output\fP \fIsink\fP
|
||
Save results in this file. The file will be created on the
|
||
model of the input file. Beats are marked by a short wood-block like sound.
|
||
.TP
|
||
.B
|
||
\fB-r\fP, \fB--samplerate\fP \fIrate\fP
|
||
Fetch the input \fIsource\fP, resampled at the given
|
||
sampling \fIrate\fP. The \fIrate\fP should be specified in Hertz as an integer. If 0,
|
||
the sampling \fIrate\fP of the original \fIsource\fP will be used. Defaults to 0.
|
||
.TP
|
||
.B
|
||
\fB-B\fP, \fB--bufsize\fP \fIwin\fP
|
||
The size of the buffer to analyze, that is the length
|
||
of the window used for spectral and temporal computations. Defaults to 512.
|
||
.TP
|
||
.B
|
||
\fB-H\fP, \fB--hopsize\fP \fIhop\fP
|
||
The number of samples between two consecutive analysis.
|
||
Defaults to 256.
|
||
.TP
|
||
.B
|
||
\fB-s\fP, \fB--silence\fP \fIsil\fP
|
||
Set the silence threshold, in dB, under which the pitch
|
||
will not be detected. A value of \fB-20.0\fP would eliminate most onsets but the
|
||
loudest ones. A value of \fB-90.0\fP would select all onsets. Defaults to \fB-90.0\fP.
|
||
.TP
|
||
.B
|
||
\fB-m\fP, \fB--mix-input\fP
|
||
Mix \fIsource\fP signal to the output signal before writing to
|
||
\fIsink\fP.
|
||
.TP
|
||
.B
|
||
\fB-f\fP, \fB--force-overwrite\fP
|
||
Overwrite output file if it already exists.
|
||
.TP
|
||
.B
|
||
\fB-j\fP, \fB--jack\fP
|
||
Use Jack input/output. You will need a Jack connection
|
||
controller to feed aubio some signal and listen to its output.
|
||
.TP
|
||
.B
|
||
\fB-N\fP, --\fImiditap-note\fP
|
||
Override note value for MIDI tap. Defaults to 69.
|
||
.TP
|
||
.B
|
||
\fB-V\fP, \fB--miditap-velop\fP
|
||
Override velocity value for MIDI tap. Defaults to 65.
|
||
.TP
|
||
.B
|
||
\fB-T\fP, \fB--timeformat\fP format
|
||
Set time format (samples, ms, seconds). Defaults to
|
||
seconds.
|
||
.TP
|
||
.B
|
||
\fB-h\fP, \fB--help\fP
|
||
Print a short help message and exit.
|
||
.TP
|
||
.B
|
||
\fB-v\fP, \fB--verbose\fP
|
||
Be verbose.
|
||
.SH BEAT TRACKING METHODS
|
||
|
||
Aubio currently implements one the causal beat tracking algorithm designed by
|
||
Matthew Davies and described in the following articles:
|
||
.PP
|
||
Matthew E. P. Davies and Mark D. Plumbley. Causal tempo tracking of audio.
|
||
In Proceedings of the International Symposium on Music Information Retrieval
|
||
(ISMIR), pages 164169, Barcelona, Spain, 2004.
|
||
.PP
|
||
Matthew E. P. Davies, Paul Brossier, and Mark D. Plumbley. Beat tracking
|
||
towards automatic musical accompaniment. In Proceedings of the Audio
|
||
Engineering Society 118th Convention, Barcelona, Spain, May 2005.
|
||
.SH SEE ALSO
|
||
|
||
\fBaubioonset\fP(1),
|
||
\fBaubiopitch\fP(1),
|
||
\fBaubionotes\fP(1),
|
||
\fBaubioquiet\fP(1),
|
||
\fBaubiomfcc\fP(1),
|
||
and
|
||
\fBaubiocut\fP(1).
|
||
.SH AUTHOR
|
||
|
||
This manual page was written by Paul Brossier <piem@aubio.org>. Permission is
|
||
granted to copy, distribute and/or modify this document under the terms of
|
||
the GNU General Public License as published by the Free Software Foundation,
|
||
either version 3 of the License, or (at your option) any later version.
|