---
name: "aubionotes"
section: "1"
platform: "linux"
package: "aubio"
version: "0.4.9-25"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/aubionotes"
---

# aubionotes(1)

a command line tool to extract musical notes

## 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 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. 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** **loudest 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)](/aubioonset/1.md) for details about these methods.**

## PITCH METHODS

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

**See [aubiopitch(1)](/aubiopitch/1.md) for details about these methods.**

## SEE ALSO

**[aubioonset(1)](/aubioonset/1.md),** **[aubiopitch(1)](/aubiopitch/1.md),** **[aubiotrack(1)](/aubiotrack/1.md),** **[aubioquiet(1)](/aubioquiet/1.md),** **[aubiomfcc(1)](/aubiomfcc/1.md),** **and** **[aubiocut(1)](/aubiocut/1.md).**

## 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.**