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