AUBIOCUT(1)

🎬 aubiocut(1) — bestie, let's chop some audio ✂️

okay so this is a aubio User's manual page, and it's about aubiocut 💖

---

🌸 NAME 🌸

aubiocut — a command line tool that slices your sound files right at the onset or beat timestamps, no cap 🫶

---

✨ SYNOPSIS ✨

aubiocut source
aubiocut [[-i] source]
         [-r rate] [-B win] [-H hop]
         [-O method] [-t thres]
         [-b] [-c]
         [-v] [-q] [-h]

---

💅 DESCRIPTION 💅

So the deal is you hand aubiocut a source and it goes slice slice slice at the onset or beat timestamps. That's the whole vibe. It's giving automatic chopping service 🎀

---

🦋 OPTIONS 🦋

okay so this program follows the usual GNU command line syntax — long options start with two dashes (--) — and here's the full rundown, nothing skipped, promise 🙈

• -i, --input source — run the analysis on this audio file. Most uncompressed and compressed formats 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 set to 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'.
• -b, --beat — use beat locations instead of onset locations.
• -t, --onset-threshold thres — set the threshold value for the onset peak picking. Values are typically in the range [0.001, 0.900]. Lower threshold values imply more onsets detected. Increasing this threshold should reduce the number of incorrect detections. Defaults to 0.3.
• -c, --cut — cut the input sound file at detected labels. A new sound file for each slice will be created in the current directory.
• -o, --output directory — specify the directory path where slices of the original source should be created.
• --cut-until-nsamples n — how many extra samples should be added at the end of each slice (default 0).
• --cut-until-nslices n — how many extra slices should be added at the end of each slice (default 0).
• --create-first — alway create first slice. (typo's canon, bestie, I don't make the rules 💀)
• -h, --help — print a short help message and exit.
• -v, --verbose — be verbose.
• -q, --quiet — be quiet.

---

🔥 ONSET METHODS 🔥

the available methods are, in this exact order, and I'm not paraphrasing:

default, energy, hfc, complex, phase, specdiff, kl, mkl, specflux

see aubioonset(1) for the details about these methods, iykyk ⭐

---

👑 SEE ALSO 👑

aubioonset(1), aubiopitch(1), aubiotrack(1), aubionotes(1), aubioquiet(1), and aubiomfcc(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 Foundation, either version 3 of the License, or (at your option) any later version 🌈

---

that's the whole page, bestie — go forth and slice 💅✨

signed off with love from aubio 0.4.9, dated 29 March 2025 🎀💖