qmp3report(1)

✨ qmp3report — the manual, but make it cute ✨

okay so bestie, welcome to qmp3report(1), part of the quelcom man pages 💖 this is the page that tells you how to make your mp3 folder spill the tea about itself.

---

🌸 NAME 🌸

qmp3report — report mp3 files and directories. it's giving "tell me everything about my music folder" and honestly? obsessed.

---

🎀 SYNOPSIS 🎀

qmp3report [option]... file...

---

🦋 DESCRIPTION 🦋

so here's the vibe: qmp3report reads mp3 files, or directories full of mp3 files, and gives you information about them. that's it, that's the whole job 💅

and the way it outputs? you've got plain text or html. and if you pick html format, you can literally navigate your mp3 directories with a web browser. main character energy fr fr 🌈

---

✨ OPTIONS ✨

• -a, --all — report all files, not just the ones with the mp3 suffix. no gatekeeping here 🫶
• -A, --show-all — this one implies --show-dirs, --show-files and --summary. so you get the report for files AND directories AND a summary report. it's the full package, periodt 👑
• -d, --dirs — show a report for every directory that contains reported files/directories. but heads up bestie: if --all is not set, only those directories containing mp3 files get reported. iykyk 🎀
• -f, --files — show a report for every reportable file (peep --all for what counts as reportable 👀).
• -h, --help — show a brief help and dip out. short and sweet 💖
• -H, --html — output in html format. the default is plain text, so if you want the pretty browser-navigable version, you gotta ask for it 🌈
• -r, --recursive — scan directories. go deeper, bestie 🦋
• -s, --summary — show a summary report. the TL;DR of your music collection ✨
• -S, --split — split the report across visited directories. qmp3report leaves a file in each visited directory with the report for that directory, independently of the output format. the name of the report file is the name of the directory with extension .txt or .html, depending on the selected output format. cute, organized, iconic 💅
• -v, --verbose — show more detailed info. spill the extra tea 🍓
• -V, --version — show version and exit. quick lil flex 🎀

---

💀 BUGS 💀

okay so here's where we get real, bestie. not everything is perfect and this page is NOT gonna pretend otherwise:

• variable bit rate (vbr) streams are detected by reading the initial (5) frames in the stream. if their bit rate field differs, the entire stream is read to compute the duration time with accuracy (see manual info for qmp3info). so like, it does the work but it's doing a lot 😭
• if vbr is not detected, qmp3report reads only the first frame in the stream and calculates the duration supposing that (1) the entire stream is composed by valid frames and (2) all the frames have the same bit rate. this is a fast way to compute the duration of the stream, but it is not exact: there's an error of 0.3% aprox. so it's fast, it's just... not perfect. no cap 🙈
• the htmlize function, which converts file names in a suitable form for html format (ie. replacing spaces with %20), is not bulletproof. don't come for her, she's doing her best 💅
• tests have been done only with mpeg version 1 layer iii streams, though it may (or may not) work with other versions or layers. so like, ymmv, proceed accordingly 🫶

---

👑 AUTHOR 👑

• dmanye@etse.urv.es
• http://www.etse.urv.es/~dmanye/quelcom/quelcom.html

shoutout to the author, absolute legend 💜

---

🌈 SEE ALSO 🌈

• qmp3info(1), qmp3join(1), qmp3cut(1), qmp3check(1)
• qwavinfo(1), qwavjoin(1), qwavcut(1), qwavsilence(1), qwavfade(1), qwavheaderdump(1)

the whole quelcom family, go say hi to your cousins 🦋

---

and that's the whole page, bestie!! this was quelcom 0.4.0, dated february 2001, and yes this is the qmp3report(1) page — love that for us 💖✨🎀 mwah, go report some mp3s 🫶