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]
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
32       options 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.
52              Defaults to 256.
53
54       -O, --onset method
55              The onset detection method to  use.  See  ONSET  METHODS  below.
56              Defaults 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.
70              Defaults to 'default'.
71
72       -u, --pitch-unit unit
73              The unit to  be  used  to  print  frequencies.  Possible  values
74              include 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.
81              Defaults 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.
87              Defaults to -90.0.
88
89       -T, --timeformat format
90              Set time format (samples, ms, seconds). Defaults to seconds.
91
92       -j, --jack
93              Use Jack input/output. You will  need  a  Jack  connection  con‐
94              troller to feed aubio some signal and listen to its output.
95
96       -h, --help
97              Print a short help message and exit.
98
99       -v, --verbose
100              Be verbose.
101

ONSET METHODS

103       Available  methods: default, energy, hfc, complex, phase, specdiff, kl,
104       mkl, specflux.
105
106       See aubioonset(1) for details about these methods.
107

PITCH METHODS

109       Available  methods:  default,  schmitt,  fcomb,  mcomb,  specacf,  yin,
110       yinfft.
111
112       See aubiopitch(1) for details about these methods.
113

SEE ALSO

115       aubioonset(1),  aubiopitch(1),  aubiotrack(1),  aubioquiet(1),  aubiom‐
116       fcc(1), and aubiocut(1).
117

AUTHOR

119       This manual page was written by Paul Brossier <piem@aubio.org>. Permis‐
120       sion  is  granted to copy, distribute and/or modify this document under
121       the terms of the GNU General Public License as published  by  the  Free
122       Software  Foundation,  either  version  3  of  the License, or (at your
123       option) any later version.
124
125
126
127aubio 0.4.6                      24 July 2018                    AUBIONOTES(1)
Impressum