MP3ROASTER(1)

📦
version 0.3.0 · 4 versions
, in debian bookworm, ubuntu noble

💿 MP3ROASTER(1) — the perl(1) user-contributed manual page, bestie edition 💿

okay so. you found mp3roaster, she's a little Perl script living in the User Contributed Perl Documentation section of your man pages, and she is lowkey iconic. let's get into it. 🎀

✨ NAME ✨

mp3roaster — a Perl hack for burning audio CDs out of MP3/OGG/FLAC/WAVs 🦋

🌸 SYNOPSIS 🌸

mp3roaster [OPTION]... "MP3/OGG/FLAC/WAV files"

that's it. that's the whole vibe. no cap. 💅

👑 DESCRIPTION 👑

so mp3roaster is, and I quote from the source of truth, a Perl hack for burning audio CDs out of MP3, OGG VORBIS and FLAC files. 💖

the main highlights?? two of them, and they're both giving:

  • an easy to use command line syntax — literally, you just hand her files
  • automatic volume leveling support so you get the best audio CD quality 🎧

that's the whole pitch. she's not complicated, she's efficient. main character energy fr fr. ⭐

🧚 ENVIRONMENT 🧚

MP3Roaster should run on all Unix like operating systems which have Perl and wodim installed. she was developed on Debian GNU/Linux. 🐧

so like — if you've got Perl and wodim, you're good. if you don't, that's a you problem bestie, go install them. 🙈

💅 OPTIONS 💅

so real talk, the original page literally says: "All options have been imported, now we should add specific descriptions for each option." 😭 and honestly?? we love the honesty. anyway here's the whole roster, every single one, no skips:

  • -D, --dev — the CDR device to use 🎯
  • -s, --speed — burn speed. how fast we goin 🏎️
  • -d, --dummy — burn with the laser off (practice run, nothing actually gets written) 💀
  • -a, --dao — burn in disk-at-once (DAO) mode, which is the one for gapless recording ✨
  • -b, --burnfree — turn on Buffer Underrun Free writing 🛡️
  • -t, --temp — temporary directory 📁
  • -m, --mp3dec — which MP3 decoder to use 🎛️
  • -l, --lowercase — convert filenames to lowercase 🔡
  • -S, --spaces — replace spaces with underscores ␣
  • -B, --brackets — replace brackets with underscores
  • -q, --quotes — replace quotes with underscores
  • -Q, --questions — replace questionmarks with underscores ❓
  • -n, --normalize — normalize WAV files before burning 📈
  • -N, --no-normalize — don't normalize WAV files, even if --normalize is specified (either as a command line argument or in the configuration file) 🚫
  • -y, --no-confirm — don't prompt for confirmation. she trusts you 🫶
  • -w, --wodim-opts — specify options to pass to Wodim for CD recording 🎚️
  • -v, --verbose — enable verbose output 📢
  • -h, --help — show the help screen 🆘
  • -V, --version — show version and infos 🏷️

🔥 RETURN VALUE 🔥

mp3roaster returns 0 on success, 1 on error.

that's it. zero is the slay, one is the oh-no. 💀

😭 DIAGNOSTICS 😭

"This has to be written yet."

not me reading that straight off the page 💀 the diagnostics section is literally a placeholder. iconic behaviour honestly.

🌈 EXAMPLES 🌈

once she's correctly configured, MP3Roaster is very easy to use — just launch it from the command line with a bunch of compressed audio files. short example:

% mp3roaster "Root Dance.mp3" Free\ Software.flac bar.ogg Decoded.wav

this will burn Root Dance.mp3, Free Software.flac, bar.ogg and Decoded.wav on your audio CD preserving the song order as specified on the command line. 🎶 order matters, she respects your tracklist.

here's another one showing command line options in action, specifically the dummy option:

% mp3roaster -d "Root Dance.mp3" Free\ Software.flac bar.ogg Decoded.wav

this does the same job as above but with the laser of your CD writer turned off, so no data will be really written. 🚫🔥 perfect for a lil test run before the real thing.

you see?? MP3Roaster is really easy to use, and that was one of the author's main goals while writing the code: keep it simple ;) 🫶

📁 FILES 📁

MP3Roaster can be configured through a system wide config file and a personal config file. when you run MP3Roaster it will first check for your personal configuration file in your home directory, and if none is found it will fall back to the system wide configuration files placed in /etc.

by default MP3Roaster installs the configuration files in /etc/mp3roaster, but there are other possible file locations for the config file:

  • System wide configuration in /etc
    • /etc/mp3roaster/mp3roasterrc (DEFAULT) ⭐
    • /etc/mp3roasterrc
  • Personal configuration in your home
    • ~/.mp3roaster/mp3roasterrc
    • ~/.mp3roasterrc

so if you want a personal MP3Roaster configuration file, just copy the system wide configuration file to your home directory and edit it. easy. 💖

🎀 CAVEHEATS 🎀

(no that is not a typo I made, the section is literally spelled like that, we love her anyway 💀)

None actually. ✨

🦋 BUGS 🦋

there may be some minor troubles regarding file names, feel free to report any bugs you may encounter (In fact you shouldn't). 🙈

not the page gaslighting you into not filing bugs. we stan a confident queen.

⭐ NOTES ⭐

There are currently no special notes. 🍓

💜 SEE ALSO 💜

wodim.

👑 AUTHOR 👑

  • Ivo Marino <eim@users.sourceforge.net>
  • Lorenzo Taylor <lorenzo1@users.sourceforge.net>

🕰️ HISTORY 🕰️

take a look at the ChangeLog for now. 📜

and that's the whole page bestie!! this one was brought to you by perl v5.36.0, dated 2022-11-14 — so like, she's been around, she's seen things, and she's still serving. go burn something. 💿✨🎀

📦 where this page comes from