1cueprint(1) General Commands Manual cueprint(1)
2
6 cueprint - report disc and track information from a CUE or TOC file
7
9 cueprint [ { -i format | --input-format=format } { -n number |
10 --track-number=number } { -d template | --disc-template=template } { -t
11 template | --track-template=template } ] [ file ... ]
12 cueprint -h | --help
13 cueprint -V | --version
14
16 cueprint reports disc and track information from CUE and TOC files,
17 which are typically created by compact disc ripping software.
18 By default, cueprint reports a default set of disc information, and a
20 default set of information for each track on the disc. With options,
21 the report can be restricted to a specific track, and the presentation
22 of the disc and track information can be extensively customized using
23 printf(3)-style format strings (referred to here as ‘templates’ to
24 avoid confusion with the concept of file format). All characters in a
25 template are reproduced as-is in the output except for conversions
26 (which begin with ‘%’) and escapes (which begin with ‘\’).
27 If no filenames are specified, cueprint reads from standard input, and
29 an input format option must be specified. If one or more filenames is
30 provided, but the input format option is not specified, the input for‐
31 mat will be guessed based on each file's suffix (e.g., .cue or .toc).
32 This heuristic is case-insensitive.
33 Conversions
35 A conversion has the form ‘%[flags][width][.precision]type’.
36 flags may be zero or more of the following:
38 Character Meaning
40 ───────────────────────────────────────────────────────────
41 - left-justify expansion
42 + place sign before numbers
43 ‘ ’ (space) place a blank space before a positive number
44 0 pad numbers with zeroes
45 width is the minimum field width. precision is the maximum width for
47 strings. type is a single character which specifies the conversion
48 type — apart from %, it is the only mandatory part of the conversion.
49 The available conversion types are presented in the table below; disc
51 conversion types are presented in the left half of the table, and track
52 conversion types in the right half. Disc template expansion characters
53 are valid for both disc and track templates.
54 Character Conversion Character Conversion
56 ────────────────────────────────────────────────────────────────
57 A album arranger a track arranger
58 C album composer c track composer
59 G album genre g track genre
60 i track ISRC
61 M album message m track message
62 N number of tracks n track number
63 P album performer p track performer
64 S album songwriter
65 T album title t track title
66 U album UPC/EAN u track ISRC (CD-TEXT)
67 Any other character used as a conversion type expands to itself. This
69 is how a literal percent sign is placed in the template; i.e., ‘%%’ ex‐
70 pands to ‘%’.
71 Escapes
73 The recognized escapes are all single characters, and listed in the ta‐
74 ble below.
75 Escape Sequence Expansion
77 ──────────────────────────────────
78 \a alert (bell)
79 \b backspace
80 \f formfeed
81 \n newline
82 \r carriage return
83 \t horizontal tab
84 \v vertical tab
85 \0 null
86 Any other character used after the ‘\’ in an escape sequence expands to
88 itself. This is how a literal escape character is placed in the tem‐
89 plate; i.e., ‘\\’ expands to ‘\’.
90
92 -d template, --disc-template=template
93 set disc template (see Conversions )
94 -h, --help
96 displays a usage message and exits.
97 -i format, --input-format=format
99 sets the expected format of the input file(s) to format, which
100 must be either cue or toc.
101 -n number, --track-number=number
103 only print track information for a single track. The default is
104 to print information for all tracks.
105 -t template, --track-template=template
107 set track template (see Conversions )
108 -V , --version
110 displays version information and exits.
111
113 cueprint exits with status zero if it successfully reports information
114 from each input file, and nonzero if there were problems.
115
117 To display disc and track information (using the default template for
118 both):
119 % cueprint album.cue
121 To print the number of tracks in a CUE file:
123 % cueprint -d '%N\n' album.cue
125
127 Cuetools was written by Svend Sorensen. Branden Robinson contributed
128 fixes and enhancements to the utilities and documentation.
129
131 cuebreakpoints(1), cueconvert(1), printf(3)
132 cueprint(1)