DragonFly On-Line Manual Pages

Search: Section:  

TAGLOOKUP(1)           DragonFly General Commands Manual          TAGLOOKUP(1)


NAME

     taglookup - tags groups of audio files using CDDB


SYNOPSIS

     taglookup [-c cache_mode] [-s hostname] [-p port] [-P protocol] [-h]
               command command_arguments file ...


DESCRIPTION

     Tags MP3s and other taggable audio files. It inspects a set of files and
     uses their lengths to look up an appropriate disc from a CDDB-compatible
     service. Its behaviour is depends on the given command.


COMMANDS

     id cddb_category cddb_id file ...
             Look up the details of the CDDB disc from a CDDB service using
             cddb_category and cddb_id file with each CDDB track using the
             closest track length.

             cddb_category
                     must be one of: blues, classical, country, folk, jazz,
                     misc, newage, reggae, rock or soundtrack.
             cddb_id
                     must be numeric. Begin hex IDs with 0x.

     sequence file ...
             Uses files in order to generate a CDDB ID and queries a CDDB
             service. CDDB IDs are generated based on the sequence of tracks.
             Choose the closest matching CDDB disc to tag the files.

     rename template file ...
             Renames files based the tages on template.  These tags are:
             %a is Artist
             %g is Genre
             %s is Song Title
             %t is Album title
             %y is Year; and
             %n is Track number.

     list file ..
             List the current tags in files.

     help    Prints taglookup usage.


OPTIONS

     -c cache_mode
           cache_mode = on, off, only

           on      check for cached result first, then connect to a service
           off     never use cached results
           only    only use cached results; never connect to a service

     -h hostname
           Hostname of the CDDB-compatable service.

     -p port
           Port to use for connecting to the CDDB service.

     -P protocol
           protocol = cddbp, http, proxy

           Sets the protocol that taglookup will use to connect to the CDDB
           service:

           cddbp   Uses the CDDB protocol. Defaults port = 888.
           http    Uses HTTP protocol. Defaults port = 80.
           proxy   Uses HTTP but connects to the proxy given by the
                   environment varaible, http_proxy. http_proxy must be in the
                   format:
                         http://user:password@proxy_name:proxy_port

     -h    Prints taglookup usage.


AUTHOR

     Alex Allan <alex@kamaz.org.uk>


SEE ALSO

     http://www.kamaz.org.uk/taglookup

                               October 28, 2007

Search: Section: