Man Linux: Main Page and Category List

NAME

       cueprint - report disc and track infomation 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 --help

DESCRIPTION

       cueprint  reports  disc  and  track information from CUE and TOC files,
       which are typically created by compact disc ripping software.

       By default, 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
       printf(3)-style format strings (referred  to  here  as  ‘templates’  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 ‘%’) and escapes (which begin with ‘\’).

       If  no filenames are specified, cueprint reads from standard input, and
       an input format option 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.,  .cue  or
       .toc).  This heuristic is case-insensitive.

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

       flags may be zero or more of the following:

       Character     Meaning
       -----------------------------------------------------------
       -             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.

       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.

       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)

       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,  and  listed  in  the
       table below.

       Escape Sequence   Expansion
       ----------------------------------
       \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 TEMPLATE EXPANSION)

       -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 TEMPLATE EXPANSION)

EXIT STATUS

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

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.

SEE ALSO

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

                                                                   cueprint(1)