If the input CDROM is a file, check for the file.
[clinton/abcde.git] / cddb-tool.1
CommitLineData
c9c2ca27 1.TH CDDB-TOOL 1
2.SH NAME
3cddb-tool \- Get CDDB information
4.SH SYNOPSIS
5.B cddb-tool parse
6.I file [-i|-d|-a|-t] [num|-c|-p]
7
8.B cddb-tool template disc-id tracks
9
10.B cddb-tool send
11.I [file] address
12
13.B cddb-tool query
14.I server user host disc-id tracks
15
16.B cddb-tool read
17.I server user host disc-id genre
18
19.B cddb-tool help
20
21.SH DESCRIPTION
22cddb-tool is a backend tool for abcde. It is passed information from
23cd-discid and uses it look up the CD title, artist, and track information
24on the cddb database (http://freedb.freedb.org) on the internet.
25.SH COMMANDS
26.B parse
27.I [file] option
28
29Get data out of a cddb file (use "-" for stdin).
30Options (use one and only one):
31.RS
32.TP
33.B id
34prints disc id
35.TP
36.B album
37prints album title
38.TP
39.B track num
40prints title of track num
41.TP
42.B
43artist
44prints artist
45.TP
46.B category
47prints category
48.TP
49.B cddbgenre
50synonym for category
51.TP
52.B all
53parse file and dumps to stdout in a form sourceable by the shell
54.RE
55
56.B send
57.I [file] address
58
59Mails file file (or stdin of no file specified)
60to specified address, using correct format. Category should
61be one of blues, classical, country, data, fold, jazz, newage,
62reggae, rock, soundtrack, misc.
63
64.B template
65.I [disc-id] [tracks]
66
67Generates a template (empty) cddb file to stdout. The command
68line should be essentially the output of cd-discid.
69
70.B query
71.I [server] [user] [host] [disc-id] [tracks]
72
73Looks up disc on server (should be of form "http://host/cddb/cddb.cgi")
74remainder of command line is in the same form as that returned
75by the cd-discid program. Uses wget, so if you need to use a proxy
76then just configure wget to do so. user and host will be used for
77identifying ourselves to the CDDB server. Outputs response code and entries
78with matching CDDB entries, if successful, from the CDDB server.
79
80
81.B read
82.I [server] [user] [host] [disc-id] [genre]
83
84Dumps CDDB entry to stdout. File will contain an extra #CATEGORY=
85line, which leaves it a valid CDDB file but which will be recognized
86by parse and send commands. Uses wget, so if you need to use a proxy
87then just configure wget to do so. user and host will be used for
88identifying ourselves to the CDDB server.
89
90.B help
91
92Prints usage information.
93
94.SH AUTHOR
95Nathaniel Smith <njs@uclink4.berkeley.edu>, maintained as part of abcde by
96Robert Woodcock <rcw@debian.org>. Manual page compiled from help information
97by Robert Woodcock.