Next: , Previous: , Up: mp3 tools   [Contents]


4.5 qmp3report

qmp3report reports mp3 files and directories

4.5.1 synopsis

qmp3report optionfile

4.5.2 description

qmp3report reads mp3 files or directories containing mp3 files and gives information about them. qmp3report can output the reports with plain text or in html format. using the latter format, you can navigate your mp3 directories with a web browser.

4.5.3 option list

-a
--all-files

report all files, not just files with suffix .mp3.

-A
--show-all

implies --dirs, --files and --summary. show report for files and directories and a summary report.

-d
--dirs

show a report for every directory containing reported files/directories. note that if option --all-files is not set, only will be reported those directories containing mp3 files.

-f
--files

show a report for every reportable file (see also --all-files).

-h
--help

show a brief help and exit.

-H
--html

output in html format (default is plain text).

-r
--recursive

scan directories.

-s
--summary

show a summary report.

-S
--split

split report across visited directories. qmp3report leaves in each visited directory a file 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.

-v
--verbose

show more detailed info.

-V
--version

show version and exit.

4.5.4 bugs

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 qmp3info).

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.

the htmlize function, which converts file names in a suitable form for html format (ie. replacing blanks with ’%20’), is not bulletproof.


Next: , Previous: , Up: mp3 tools   [Contents]