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