1cueprint(1)                 General Commands Manual                cueprint(1)
2
3
4

NAME

6       cueprint - report disc and track information from a CUE or TOC file
7

SYNOPSIS

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

DESCRIPTION

16       cueprint  reports  disc  and  track information from CUE and TOC files,
17       which are typically created by compact disc ripping software.
18
19       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
28       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
34   Conversions
35       A conversion has the form ‘%[flags][width][.precision]type’.
36
37       flags may be zero or more of the following:
38
39       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
46       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
50       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
55       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
68       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
72   Escapes
73       The recognized escapes are all single characters, and listed in the ta‐
74       ble below.
75
76       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
87       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

OPTIONS

92       -d template, --disc-template=template
93              set disc template (see Conversions )
94
95       -h, --help
96              displays a usage message and exits.
97
98       -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
102       -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
106       -t template, --track-template=template
107              set track template (see Conversions )
108
109       -V ,  --version
110              displays version information and exits.
111

EXIT STATUS

113       cueprint  exits with status zero if it successfully reports information
114       from each input file, and nonzero if there were problems.
115

EXAMPLES

117       To display disc and track information (using the default  template  for
118       both):
119
120       % cueprint album.cue
121
122       To print the number of tracks in a CUE file:
123
124       % cueprint -d '%N\n' album.cue
125

AUTHOR

127       Cuetools  was  written by Svend Sorensen.  Branden Robinson contributed
128       fixes and enhancements to the utilities and documentation.
129

SEE ALSO

131       cuebreakpoints(1), cueconvert(1), printf(3)
132
133
134
135                                                                   cueprint(1)
Impressum