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