Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
AUBIONOTES(1)		       aubio User's manual		   AUBIONOTES(1)

NAME
     aubionotes - a command line tool to extract musical notes

SYNOPSIS
     aubionotes source
     aubionotes [[-i] source]
		[-r rate] [-B win] [-H hop]
		[-O method] [-t thres] [-d drop]
		[-p method] [-u unit] [-l thres]
		[-T time-format]
		[-s sil]
		[-j] [-v] [-h]

DESCRIPTION
     aubionotes attempts to detect notes by looking for note onsets and pitches.
     Consecutive events are segmented using onset detection, while a fundamental
     frequency extraction algorithm determines their pitch.

     When  started  with  an  input  source (-i/--input), the detected notes are
     printed on standard output, in seconds and midi note number.

     When started without an input source, or with the jack option  (-j/--jack),
     aubionotes starts in jack mode.

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 source
	    Run analysis on this audio file. Most  uncompressed  and  compressed
	    are supported, depending on how aubio was built.

     -r, --samplerate rate
	    Fetch  the	input  source, resampled at the given sampling rate. The
	    rate should be specified in Hertz as an integer. If 0, the	sampling
	    rate of the original source will be used. Defaults to 0.

     -B, --bufsize win
	    The  size of the buffer to analyze, that is the length of the window
	    used for spectral and temporal computations. Defaults to 512.

     -H, --hopsize hop
	    The number of samples between two consecutive analysis.  Defaults to
	    256.

     -O, --onset method
	    The onset detection method to use. See ONSET METHODS below. Defaults
	    to 'default'.

     -t, --onset-threshold thres
	    Set the threshold value for the onset peak picking.  Typical  values
	    are typically within 0.001 and 0.900. Defaults to 0.1. Lower thresh-
	    old  values  imply more onsets detected. Try 0.5 in case of over-de-
	    tections. Defaults to 0.3.

     -M, --minioi value
	    Set the minimum inter-onset interval, in seconds, the  shortest  in-
	    terval between two consecutive notes. Defaults to 0.030

     -p, --pitch method
	    The pitch detection method to use. See PITCH METHODS below. Defaults
	    to 'default'.

     -u, --pitch-unit unit
	    The  unit  to  be used to print frequencies. Possible values include
	    midi, bin, cent, and Hz. Defaults to 'Hz'.

     -l, --pitch-tolerance thres
	    Set the tolerance for the pitch detection algorithm. Typical  values
	    range  between 0.2 and 0.9. Pitch candidates found with a confidence
	    less than this threshold  will  not  be  selected.	The  higher  the
	    threshold, the more confidence in the candidates. Defaults to unset.

     -s, --silence sil
	    Set  the silence threshold, in dB, under which the pitch will not be
	    detected. A value of -20.0 would eliminate most onsets but the loud-
	    est ones. A value of -90.0 would  select  all  onsets.  Defaults  to
	    -90.0.

     -d, --release-drop
	    Set  the release drop threshold, in dB. If the level drops more than
	    this amount since the last note started, the  note	will  be  turned
	    off. Defaults to 10.

     -T, --timeformat format
	    Set time format (samples, ms, seconds). Defaults to seconds.

     -j, --jack
	    Use Jack input/output. You will need a Jack connection controller to
	    feed aubio some signal and listen to its output.

     -h, --help
	    Print a short help message and exit.

     -v, --verbose
	    Be verbose.

ONSET METHODS
     Available methods: default, energy, hfc, complex, phase, specdiff, kl, mkl,
     specflux.

     See aubioonset(1) for details about these methods.

PITCH METHODS
     Available	methods:  default,  schmitt, fcomb, mcomb, specacf, yin, yinfft,
     yinfast.

     See aubiopitch(1) for details about these methods.

SEE ALSO
     aubioonset(1), aubiopitch(1), aubiotrack(1),  aubioquiet(1),  aubiomfcc(1),
     and aubiocut(1).

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 Founda-
     tion,  either  version 3 of the License, or (at your option) any later ver-
     sion.

aubio 0.4.9			  30 July 2026			   AUBIONOTES(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=aubionotes&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help