cueprint(1)

💖 cueprint(1) 💖

okay bestie, pull up a chair, we're doing the General Commands Manual thing 🎀 this is cueprint, and honestly? she eats.

---

✨ NAME ✨

cueprint — report disc and track information from a CUE or TOC file 🫶

---

🌸 SYNOPSIS 🌸

cueprint [ { -i format | --input-format=format } { -n number |
--track-number=number } { -d template | --disc-template=template } { -t
template | --track-template=template } ] [ file ... ]
cueprint -h | --help
cueprint -V | --version

---

🦋 DESCRIPTION 🦋

so cueprint reports disc and track information from CUE and TOC files, which — fun fact — are typically created by compact disc ripping software. yeah. the ripping software. we love her 💅

By default, cueprint reports a default set of disc information, and a default set of information for each track on the disc. that's the vibe out of the box, no notes.

With options tho? the report can be restricted to a specific track, and the presentation of the disc and track information can be extensively customized using printf(3)-style format strings — which this manpage calls ‘templates’, to avoid confusion with the concept of file format. iconic clarification, we stan. ✨

All characters in a template are reproduced as-is in the output except for conversions (which begin with %) and escapes (which begin with \).

If no filenames are specified, cueprint reads from standard input, and an input format option must be specified. no format option, no input, that's the rule 🚨

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., .cue or .toc). This heuristic is case-insensitive. she's guessing, but she's guessing smart 💅

---

🔥 Conversions 🔥

A conversion has the form ‘%[flags][width][.precision]type’.

flags may be zero or more of the following:

• - — left-justify expansion
• + — place sign before numbers
• ‘ ’ (space) — place a blank space before a positive number
• 0 — pad numbers with zeroes

width is the minimum field width. precision is the maximum width for strings. type is a single character which specifies the conversion type — apart from %, it is the only mandatory part of the conversion. she needs her type, periodt.

The available conversion types are presented below; disc conversion types are in the left half, and track conversion types in the right half. Disc template expansion characters are valid for both disc and track templates. iykyk ✨

• A — album arranger   |   a — track arranger
• C — album composer   |   c — track composer
• G — album genre   |   g — track genre
• (no disc version)   |   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)

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., ‘%%’ expands to ‘%’. 💜

---

🧚 Escapes 🧚

The recognized escapes are all single characters, bestie, and they're listed right here:

• \a — alert (bell)
• \b — backspace
• \f — formfeed
• \n — newline
• \r — carriage return
• \t — horizontal tab
• \v — vertical tab
• \0 — null

Any other character used after the ‘\’ in an escape sequence expands to itself. this is how a literal escape character is placed in the template; i.e., ‘\\’ expands to ‘\’. 🌀

---

👑 OPTIONS 👑

• -d template, --disc-template=template — set disc template (see Conversions )
• -h, --help — displays a usage message and exits.
• -i format, --input-format=format — sets the expected format of the input file(s) to format, which must be either cue or toc.
• -n number, --track-number=number — only print track information for a single track. The default is to print information for all tracks.
• -t template, --track-template=template — set track template (see Conversions )
• -V, --version — displays version information and exits.

---

💀 EXIT STATUS 💀

cueprint exits with status zero if it successfully reports information from each input file, and nonzero if there were problems. simple as. no cap. 🫶

---

🌈 EXAMPLES 🌈

To display disc and track information (using the default template for both):

% cueprint album.cue

To print the number of tracks in a CUE file:

% cueprint -d '%N\n' album.cue

---

🎀 AUTHOR 🎀

Cuetools was written by Svend Sorensen. Branden Robinson contributed fixes and enhancements to the utilities and documentation. legends only 👑

---

⭐ SEE ALSO ⭐

cuebreakpoints(1), cueconvert(1), printf(3)

---

ok that's the whole page, bestie 💖 go forth and print some cues, you're gonna slay

and that's a wrap on cueprint(1) from the General Commands Manual — she's iconic, she's useful, she's your girl. mwah 💋✨