RGBPM(1)

πŸ’– rgbpm(1) β€” the manual page, but make it cute πŸ’–

okay so bestie, welcome to the rgbpm page. this is the manual for rgbpm, and we're gonna go through it together, no skipping, no skimming, we're doing the whole thing. grab a strawberry πŸ“ and let's go.


✨ NAME ✨

rgbpm β€” folder-based loudness and beats per minute scanning. yes, that's the whole name. folder-based. loudness. bpm. she does it all. πŸ’…


🌸 SYNOPSIS 🌸

rgbpm [OPTIONS] FOLDER [...]

that's it. that's the shape of it. options, then one or more folders. slay.


πŸŽ€ DESCRIPTION πŸŽ€

okay so here's the vibe: rgbpm assumes that each folder contains one music album, and that every audio track sitting in that folder is the same file type. that's the whole model. one folder = one album. she's not confused about it, she's not checking, she just trusts you. 🫢

then she does the thing: rgbpm will traverse from the folder (or folders) you gave her, all the way down into every sub-folder, and add the recommended ReplayGain 2.0 track and album tags to supported audio files. track tags and album tags. both. she ate. πŸ‘‘

now, the file types. this part depends on what you have installed, so listen up:

if loudgain is installed, rgbpm supports these file types:

  • FLAC (.flac)
  • Ogg (.ogg, .oga, .spx, .opus)
  • MP2 (.mp2)
  • MP3 (.mp3)
  • MP4 (.mp4, .m4a)
  • ASF/WMA (.asf, .wma)
  • WavPack (.wv)
  • APE (.ape)
  • WAV (.wav)
  • AIFF (.aiff, .aif)

if bpm-calc is installed, rgbpm will use it to calculate beats per minute, and then tag these file types:

  • MP2 (.mp2)
  • MP3 (.mp3)
  • FLAC (.flac)

so yeah, the loudness list is long and gorgeous, the bpm list is short and iconic. it's giving ✨specialisation✨. iykyk.


πŸ’… OPTIONS πŸ’…

  • -h β€” show help. that's it, that's the option, she's helpful, she's polite πŸŽ€
  • -v β€” show the version number of the script. identity check, bestie πŸ’–
  • -b β€” disable BPM calculation (and tagging). so the beats-per-minute stuff just… doesn't happen. no bpm, no bpm tags, nothing. sometimes you just want the loudness and that's valid πŸ¦‹

😭 BUGS 😭

so, the rgbpm script is maintained on GitHub as part of loudgain. if something's broken (and it happens, it's fine, we don't judge), please report all bugs to the issue tracker at:

https://github.com/Moonbase59/loudgain/issues

copy that link, paste it, tell them what happened. they want to know. we want to know. it's a whole community moment 🫢


Copyright (C) 2020 Hugh McMaster

rgbpm is released under the 2-clause BSD license. periodt.


okay that's the whole page, bestie, you read all of it, i'm so proud of you 🌈⭐

this was the RGBPM(1) manual page β€” August 2020, from the loudgain crew πŸ’œ