BPM(1)

💅 BPM(1) — the bpm-tools girlies are here

okay so bestie, welcome to bpm-tools, a whole little family of commands that live in the General Commands Manual, section 1 🎀

---

✨ NAME ✨

bpm-tools — calculate the tempo of music files 🎵

---

🌸 SYNOPSIS 🌸

bpm-tag [options] file

bpm-graph file

bpm [options] < file.raw

---

🦋 DESCRIPTION 🦋

so basically, the bpm-tools commands automatically calculate the tempo of music — that's beats-per-minute, iykyk 💃 — and they can optionally show you an analysis and/or slap that tempo into the file's 'tags'. and why do we care? because the data in those tags is especially useful for navigating a music library in DJ software like xwax(1). iconic behaviour, no cap.

the bpm command is the one that implements the algorithm on raw data — very backstage, very raw, very main-character-in-the-lab 🔬 — but the command you'll actually reach for 99% of the time is bpm-tag. periodt.

---

✨ OPTIONS ✨

the options are described by the commands themselves, bestie — each one does its own little reveal. use one of these to get the full tea:

• bpm-tag -h
• bpm-graph -h
• bpm -h

lowkey the most efficient vibe check is just asking the command directly. it will tell you everything. 🫶

---

🌈 EXAMPLES 🌈

Tag a file with its tempo:

bpm-tag "Daft Punk - Get Lucky.mp3"

Calculate and display the tempo of a file without modifying it:

bpm-tag -f -n "Gwen Guthrie - Padlock.flac"

Tag a file, with a hint to look for a fast tempo:

bpm-tag -m 120 -x 200 "Roni Size - Brown Paper Bag.oga"

notice the quotes around those filenames, bestie. spaces in filenames are not your enemy, they're just dramatic. 💀

---

👑 HOMEPAGE 👑

http://www.pogo.org.uk/~mark/bpm-tools/

---

💖 AUTHOR 💖

Mark Hills <mark@xwax.org>

---

and that's the whole page, bestie ✨ it came to you from the General Commands Manual (that's the source/version vibe, section 1, the big leagues) — go forth, tag your tracks, and may your BPMs always be correct 💅🎀🦋