1@(#)CDDB	6.22 03/07/10
2
3Gracenote CDDB�
4---------------
5
6Xmcd and cda supports CDDB, the largest and fast growing database of
7CD information on the Internet.  The CDDB concept was originally
8pioneered by xmcd, and is now embraced as a standard by many other CD
9and music-related applications.
10
11With CDDB, you do not have to type in the artist, disc title, track
12titles and other disc information for the CDs in your collection.  Xmcd
13and cda automatically queries the CDDB server, and if the query is
14successful, the information is displayed.
15
16CDDB access is free of charge to end users, but you can use this feature
17only if your system has a working connection to the Internet, either via
18a dial-up link or a dedicated connection.
19
20On some platforms, this release of xmcd/cda supports the new CDDB�(R)
21service with many enhanced features.  On the other platforms, the
22CDDB "classic" service is used.  To determine which mode xmcd is running
23in, click the wwwWarp button (world symbol) and select "About xmcd...".
24The pop-up information window will indicate whether the CDDB� or the
25CDDB "classic" service is being used.  Also, after a successful lookup,
26the xmcd front panel will indicate "CDDB�" or "CDDB" depending on the
27mode.
28
29As of this writing, xmcd and cda are CDDB�-enabled on the following
30platforms:
31
32	OS			Platform	Version
33	---------------------------------------------------------
34	FreeBSD			x86		3.x, 4.x
35	HP-UX			PA-RISC		9.x, 10.x, 11.x
36	Linux-libc5		x86		2.x
37	Linux-libc6		x86		2.x
38	Solaris			sparc		2.x, 7, 8, 9, 10
39	Solaris			x86		2.x, 7, 8, 9, 10
40	SunOS			sparc		4.1.x
41	UnixWare		x86		1.x, 2.x, 7.x
42	SCO/Caldera Open UNIX	x86		8.x
43
44Please refer to the xmcd official web site's download area for the
45latest list, as Gracenote may add CDDB� library support to more
46platforms over time.
47
48Using xmcd's wwwWarp feature, you may also access dynamic content
49provided by CDDB�, or search the CDDB database.
50
51
52Using CDDB�
53-----------
54
55On selected platforms, xmcd uses the enhanced Gracenote CDDB� Music
56Recognition Service(sm) (MRS) to get the artist, title, track, credits,
57and other information about the CDs you play.  This service is free and
58automatic.  The first time you use the service, you must register with
59CDDB.  To register with CDDB, just play a CD with xmcd.  The CDDB User
60Registration window appears automatically.  Select a user handle and
61password.  The remaining information is optional, but does help CDDB
62provide better service.  Once you register, you do not have to
63re-register, unless you want to change your registration information or
64settings.  To change your CDDB� registration information, open the xmcd
65CD Information / Program Editor window (click on the button on the xmcd
66main window with the file cabinet symbol) and select the "Register..."
67button.
68
69The CDDB� service features richer content than the "classic" CDDB
70service, and provides international support via the use of the UTF-8
71Unicode character set.
72
73
74Using "classic" CDDB
75--------------------
76
77On those platforms that the Gracenote CDDB� interface library is not
78available, xmcd uses the "classic" CDDB service (same as what was used
79in xmcd version 2.x).  This service is also free, automatic, and does
80not require user registration.  However, "classic" CDDB provides less
81content than CDDB�.
82
83The CDDB interface library automatically translates between "classic"
84CDDB music categories and equivalent CDDB� genres.  Thus, only those
85genres are available in the xmcd genre menus.
86
87The "classic" CDDB service provides support for ISO Latin-1 character sets
88only.  Also, it will not provide data for the following CDDB�-enhanced
89fields:
90
91    In Album Details:
92	- Sort title, "The"
93	- Year
94	- Record label
95	- Compilation
96	- Genre 2 (secondary genre/subgenre)
97	- Region
98	- Language
99	- Disc x of y
100    In Album Credits:
101	- Role
102	- Name
103	- Notes
104    In Album Segments:
105	- Name
106	- Start track/frame
107	- End track/frame
108	- Notes
109	In Segment Credits:
110	    - Role
111	    - Name
112	    - Notes
113    In Track Details:
114	- Sort title, "The"
115	- Artist
116	- Year
117	- Record label
118	- BPM
119	- Genre 2 (secondary genre/subgenre)
120    In Track Credits:
121	- Role
122	- Name
123	- Notes
124
125If you submit album data to CDDB while running in "classic" CDDB mode,
126these CDDB�-enhanced fields will not be submitted.  Finally, "classic"
127CDDB does not support the CDDB Music Browser, the Album-specific
128URL links, or the URL submission feature under xmcd's wwwWarp menu.
129
130
131Submissions to CDDB
132--------------------
133
134Xmcd displays the album, track and credit information downloaded from
135CDDB.  If you see any omissions or error in the data, you are encouraged
136to correct it and use the Submit button to send it back to CDDB, so that
137others may share the corrections.
138
139In order for a submission to succeed, certain fields must be filled in.
140These fields are the album title, album artist name (if it's not a
141compilation CD) and track titles.  Moreover, the primary album genre
142("Genre 1") must not be "None".  Your computer must have an active
143Internet connection at the time of submission.
144
145To ensure high data quality, Gracenote employs a sophisticated scheme
146of submission processing.  It may use all, some, or none of the fields
147that you submit, based on certain heuristics, as well as whether a
148particular record already has a reliable data feed source.  Hence,
149it is not unusual to see the data come back not exactly as how you
150submitted it.
151
152
153Gracenote CDDB� Terms of Use
154----------------------------
155
156This application contains software from CDDB, Inc. of Berkeley,
157California d/b/a Gracenote (Gracenote).  The software from Gracenote
158(the Gracenote CDDB Client) enables this application to do online disc
159identification and obtain music-related information, including name,
160artist, track, and title information (Gracenote Data) from online
161servers (Gracenote CDDB Servers) and to perform other functions.  You
162may use Gracenote Data only by means of the intended End User functions
163of this application software.  You agree that you will use Gracenote
164Data, the Gracenote CDDB Client, and Gracenote CDDB Servers for your own
165personal non-commercial use only.  You agree not to assign, copy,
166transfer or transmit the Gracenote CDDB Client or any Gracenote Data to
167any third party.  YOU AGREE NOT TO USE OR EXPLOIT GRACENOTE DATA, THE
168GRACENOTE CDDB CLIENT, OR GRACENOTE CDDB SERVERS, EXCEPT AS EXPRESSLY
169PERMITTED HEREIN.  You agree that your non-exclusive license to use the
170Gracenote Data, the Gracenote CDDB Client, and Gracenote CDDB Servers
171will terminate if you violate these restrictions.  If your license
172terminates, you agree to cease any and all use of the Gracenote Data,
173the Gracenote CDDB Client, and Gracenote CDDB Servers.  Gracenote
174reserves all rights in Gracenote Data, the Gracenote CDDB Client, and
175the Gracenote CDDB Servers, including all ownership rights.  You agree
176that CDDB, Inc. may enforce its rights under this Agreement against you
177directly in its own name.  The Gracenote CDDB Client and each item of
178Gracenote Data are licensed to you AS IS.  Gracenote makes no
179representations or warranties, express or implied, regarding the
180accuracy of any Gracenote Data from in the Gracenote CDDB Servers.
181Gracenote reserves the right to delete data from the Gracenote CDDB
182Servers or to change data categories for any cause that Gracenote deems
183sufficient.  No warranty is made that the Gracenote CDDB Client or
184Gracenote CDDB Servers are error-free or that functioning of Gracenote
185CDDB Client or Gracenote CDDB Servers will be uninterrupted.  Gracenote
186is not obligated to provide you with any new enhanced or additional data
187types or categories that Gracenote may choose to provide in the future
188and is free to discontinue its online services at any time.  GRACENOTE
189DISCLAIMS ALL WARRANTIES EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED
190TO, IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
191PURPOSE, TITLE, AND NON-INFRINGEMENT.  Gracenote does not warrant the
192results that will be obtained by your use of the Gracenote CDDB Client
193or any Gracenote CDDB Server.  IN NO CASE WILL GRACENOTE BE LIABLE FOR
194ANY CONSEQUENTIAL OR INCIDENTAL DAMAGES OR FOR ANY LOST PROFITS OR LOST
195REVENUES.
196
197
198Gracenote CDDB� Proprietary Legends
199-----------------------------------
200
201CDDB, Inc. d/b/a "Gracenote."  CD and music related data from Gracenote
202CDDB� Music Recognition Service(sm) � 2000, 2001 Gracenote.  Gracenote
203CDDB Client Software � 2000, 2001 Gracenote.  U.S. Patents Numbers
204#5,987,525;  #6,061,680;  #6,154,773, and other patents issued or
205pending.  CDDB is a registered trademark of Gracenote.  CDDB-Enabled,
206the Gracenote logo, the CDDB Logo, and the "Powered by Gracenote CDDB"
207logo are trademarks of Gracenote.  Music Recognition Service and MRS are
208service marks of Gracenote.
209
210