196 lines
4.6 KiB
Groff
196 lines
4.6 KiB
Groff
.TH cueprint 1
|
|
.SH NAME
|
|
cueprint \- report disc and track infomation from a CUE or TOC file
|
|
.SH SYNOPSIS
|
|
.B cueprint
|
|
[ {
|
|
.B \-i
|
|
.I format
|
|
|
|
|
.BR \-\-input\-format =\fIformat\fP
|
|
} {
|
|
.B \-n
|
|
.I number
|
|
|
|
|
.BR \-\-track\-number =\fInumber\fP
|
|
} {
|
|
.B \-d
|
|
.I template
|
|
|
|
|
.BR \-\-disc\-template =\fItemplate\fP
|
|
} {
|
|
.B \-t
|
|
.I template
|
|
|
|
|
.BR \-\-track\-template =\fItemplate\fP
|
|
} ]
|
|
[
|
|
.I file
|
|
\&... ]
|
|
.br
|
|
.B cueprint \-h | \-\-help
|
|
.br
|
|
.B cueprint \-V | \-\-version
|
|
.SH DESCRIPTION
|
|
.B cueprint
|
|
reports disc and track information from CUE and TOC files, which are
|
|
typically created by compact disc ripping software.
|
|
.PP
|
|
By default,
|
|
.B cueprint
|
|
reports a default set of disc information, and a default set of information
|
|
for each track on the disc.
|
|
With options, the report can be restricted to a specific track, and the
|
|
presentation of the disc and track information can be extensively
|
|
customized using
|
|
.BR printf (3)-style
|
|
format strings (referred to here as \(oqtemplates\(cq to avoid confusion
|
|
with the concept of file format).
|
|
All characters in a template are reproduced as-is in the output except for
|
|
conversions (which begin with
|
|
.RB \(oq % \(cq)
|
|
and escapes (which begin with
|
|
.RB \(oq \e \(cq).
|
|
.PP
|
|
If no filenames are specified,
|
|
.B cueprint
|
|
reads from standard input, and an input format option
|
|
.I must
|
|
be specified.
|
|
If one or more filenames is provided, but the input format option is not
|
|
specified, the input format will be guessed based on each file's suffix
|
|
(e.g.,
|
|
.I .cue
|
|
or
|
|
.IR .toc ).
|
|
This heuristic is case-insensitive.
|
|
.SS Conversions
|
|
A conversion has the form
|
|
.RB \(oq % [ \fIflags\fP ][ \fIwidth\fP ][ .\fIprecision\fP ] \fItype\fP \(cq.
|
|
.PP
|
|
.I flags
|
|
may be zero or more of the following:
|
|
.TS
|
|
nokeep;
|
|
l l.
|
|
Character Meaning
|
|
_
|
|
\- left-justify expansion
|
|
+ place sign before numbers
|
|
\(oq \(cq (space) place a blank space before a positive number
|
|
0 pad numbers with zeroes
|
|
.TE
|
|
.\"# (unused)
|
|
.PP
|
|
.I width
|
|
is the minimum field width.
|
|
.I precision
|
|
is the maximum width for strings.
|
|
.I type
|
|
is a single character which specifies the conversion type \(em apart from
|
|
.BR % ,
|
|
it is the only mandatory part of the conversion.
|
|
.PP
|
|
The available conversion types are presented in the table below; disc
|
|
conversion types are presented in the left half of the table, and track
|
|
conversion types in the right half.
|
|
Disc template expansion characters are valid for both disc and track
|
|
templates.
|
|
.TS
|
|
nokeep;
|
|
l l l l.
|
|
Character Conversion Character Conversion
|
|
_
|
|
A album arranger a track arranger
|
|
C album composer c track composer
|
|
G album genre g track genre
|
|
i track ISRC
|
|
M album message m track message
|
|
N number of tracks n track number
|
|
P album performer p track performer
|
|
S album songwriter
|
|
T album title t track title
|
|
U album UPC/EAN u track ISRC (CD-TEXT)
|
|
.TE
|
|
.PP
|
|
Any other character used as a conversion type expands to itself.
|
|
This is how a literal percent sign is placed in the template; i.e.,
|
|
.RB \(oq %% \(cq
|
|
expands to
|
|
.RB \(oq % \(cq.
|
|
.SS Escapes
|
|
The recognized escapes are all single characters, and listed in the table
|
|
below.
|
|
.TS
|
|
nokeep;
|
|
l l.
|
|
Escape Sequence Expansion
|
|
_
|
|
\ea alert (bell)
|
|
\eb backspace
|
|
\ef formfeed
|
|
\en newline
|
|
\er carriage return
|
|
\et horizontal tab
|
|
\ev vertical tab
|
|
\e0 null
|
|
.TE
|
|
.PP
|
|
Any other character used after the
|
|
.RB \(oq \e \(cq
|
|
in an escape sequence expands to itself.
|
|
This is how a literal escape character is placed in the template; i.e.,
|
|
.RB \(oq \e\e \(cq
|
|
expands to
|
|
.RB \(oq \e \(cq.
|
|
.SH OPTIONS
|
|
.TP
|
|
.BR \-d " \fItemplate\fP, " \-\-disc\-template=\fItemplate\fP
|
|
set disc template (see
|
|
.B Conversions
|
|
)
|
|
.TP
|
|
.BR \-h ", " \-\-help
|
|
displays a usage message and exits.
|
|
.TP
|
|
.BR \-i " \fIformat\fP, " \-\-input\-format=\fIformat\fP
|
|
sets the expected format of the input file(s) to
|
|
.IR format ,
|
|
which must be either
|
|
.B cue
|
|
or
|
|
.BR toc .
|
|
.TP
|
|
.BR \-n " \fInumber\fP, " \-\-track\-number=\fInumber\fP
|
|
only print track information for a single track.
|
|
The default is to print information for all tracks.
|
|
.TP
|
|
.BR \-t " \fItemplate\fP, " \-\-track\-template=\fItemplate\fP
|
|
set track template (see
|
|
.B Conversions
|
|
)
|
|
.TP
|
|
.B \-V ", " \-\-version
|
|
displays version information and exits.
|
|
.SH "EXIT STATUS"
|
|
.B cueprint
|
|
exits with status zero if it successfully reports information from each
|
|
input file, and nonzero if there were problems.
|
|
.SH EXAMPLES
|
|
To display disc and track information (using the default template for
|
|
both):
|
|
.PP
|
|
.RB "% " "cueprint album.cue"
|
|
.PP
|
|
To print the number of tracks in a CUE file:
|
|
.PP
|
|
.RB "% " "cueprint -d \(aq%N\en\(aq album.cue"
|
|
.SH AUTHOR
|
|
Cuetools was written by Svend Sorensen.
|
|
Branden Robinson contributed fixes and enhancements to the utilities and
|
|
documentation.
|
|
.SH "SEE ALSO"
|
|
.BR cuebreakpoints (1),
|
|
.BR cueconvert (1),
|
|
.BR printf(3)
|