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

FreeBSD Manual Pages


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

       aubionotes - a command line tool	to extract musical notes

       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]

       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.

       This  program  follows the usual	GNU command line syntax, with long op-
       tions starting with two dashes (--). A summary of options  is  included

       -i, --input source
	      Run  analysis  on	 this  audio  file. Most uncompressed and com-
	      pressed 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

       -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

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

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

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

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

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

       -u, --pitch-unit	unit
	      The unit to be used to print frequencies.	 Possible  values  in-
	      clude 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. De-
	      faults 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  loudest ones. A value of -90.0 would	select all onsets. De-
	      faults 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  con-
	      troller to feed aubio some signal	and listen to its output.

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

       -v, --verbose
	      Be verbose.

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

       See aubioonset(1) for details about these methods.

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

       See aubiopitch(1) for details about these methods.

       aubioonset(1),  aubiopitch(1),  aubiotrack(1),  aubioquiet(1),  aubiom-
       fcc(1), and aubiocut(1).

       This manual page	was written by Paul Brossier <>. Permis-
       sion  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 op-
       tion) any later version.

aubio 0.4.9		       09 November 2021			 AUBIONOTES(1)


Want to link to this manual page? Use this URL:

home | help