1AUBIONOTES(1)                 aubio User's manual                AUBIONOTES(1)
2
3
4

NAME

6       aubionotes - a command line tool to extract musical notes
7

SYNOPSIS

9       aubionotes source
10       aubionotes [[-i] source]
11                  [-r rate] [-B win] [-H hop]
12                  [-O method] [-t thres] [-d drop]
13                  [-p method] [-u unit] [-l thres]
14                  [-T time-format]
15                  [-s sil]
16                  [-j] [-v] [-h]
17
18

DESCRIPTION

20       aubionotes  attempts  to  detect  notes  by looking for note onsets and
21       pitches.  Consecutive events are segmented using onset detection, while
22       a fundamental frequency extraction algorithm determines their pitch.
23
24       When  started with an input source (-i/--input), the detected notes are
25       printed on standard output, in seconds and midi note number.
26
27       When  started  without  an  input  source,  or  with  the  jack  option
28       (-j/--jack), aubionotes starts in jack mode.
29

OPTIONS

31       This  program  follows the usual GNU command line syntax, with long op‐
32       tions starting with two dashes (--). A summary of options  is  included
33       below.
34
35       -i, --input source
36              Run  analysis  on  this  audio  file. Most uncompressed and com‐
37              pressed are supported, depending on how aubio was built.
38
39       -r, --samplerate rate
40              Fetch the input source, resampled at the  given  sampling  rate.
41              The  rate  should be specified in Hertz as an integer. If 0, the
42              sampling rate of the original source will be used.  Defaults  to
43              0.
44
45       -B, --bufsize win
46              The  size  of  the  buffer to analyze, that is the length of the
47              window used for spectral and temporal computations. Defaults  to
48              512.
49
50       -H, --hopsize hop
51              The  number  of  samples  between two consecutive analysis.  De‐
52              faults to 256.
53
54       -O, --onset method
55              The onset detection method to use. See ONSET METHODS below.  De‐
56              faults to 'default'.
57
58       -t, --onset-threshold thres
59              Set the threshold value for the onset peak picking. Typical val‐
60              ues are typically within 0.001 and 0.900. Defaults to 0.1. Lower
61              threshold  values imply more onsets detected. Try 0.5 in case of
62              over-detections. Defaults to 0.3.
63
64       -M, --minioi value
65              Set the minimum inter-onset interval, in seconds,  the  shortest
66              interval between two consecutive notes. Defaults to 0.030
67
68       -p, --pitch method
69              The  pitch detection method to use. See PITCH METHODS below. De‐
70              faults to 'default'.
71
72       -u, --pitch-unit unit
73              The unit to be used to print frequencies.  Possible  values  in‐
74              clude midi, bin, cent, and Hz. Defaults to 'Hz'.
75
76       -l, --pitch-tolerance thres
77              Set  the  tolerance  for  the pitch detection algorithm. Typical
78              values range between 0.2 and 0.9. Pitch candidates found with  a
79              confidence  less  than  this threshold will not be selected. The
80              higher the threshold, the more confidence in the candidates. De‐
81              faults to unset.
82
83       -s, --silence sil
84              Set the silence threshold, in dB, under which the pitch will not
85              be detected. A value of -20.0 would eliminate  most  onsets  but
86              the  loudest ones. A value of -90.0 would select all onsets. De‐
87              faults to -90.0.
88
89       -d, --release-drop
90              Set the release drop threshold, in dB. If the level  drops  more
91              than  this  amount since the last note started, the note will be
92              turned off. Defaults to 10.
93
94       -T, --timeformat format
95              Set time format (samples, ms, seconds). Defaults to seconds.
96
97       -j, --jack
98              Use Jack input/output. You will  need  a  Jack  connection  con‐
99              troller to feed aubio some signal and listen to its output.
100
101       -h, --help
102              Print a short help message and exit.
103
104       -v, --verbose
105              Be verbose.
106

ONSET METHODS

108       Available  methods: default, energy, hfc, complex, phase, specdiff, kl,
109       mkl, specflux.
110
111       See aubioonset(1) for details about these methods.
112

PITCH METHODS

114       Available  methods:  default,  schmitt,  fcomb,  mcomb,  specacf,  yin,
115       yinfft, yinfast.
116
117       See aubiopitch(1) for details about these methods.
118

SEE ALSO

120       aubioonset(1),  aubiopitch(1),  aubiotrack(1),  aubioquiet(1),  aubiom‐
121       fcc(1), and aubiocut(1).
122

AUTHOR

124       This manual page was written by Paul Brossier <piem@aubio.org>. Permis‐
125       sion  is  granted to copy, distribute and/or modify this document under
126       the terms of the GNU General Public License as published  by  the  Free
127       Software  Foundation,  either version 3 of the License, or (at your op‐
128       tion) any later version.
129
130
131
132aubio 0.4.9                     18 January 2023                  AUBIONOTES(1)
Impressum