1<!-- ident "@(#)discog.htm 6.38 04/01/05" --> 2<HTML> 3<HEAD> 4<TITLE>Xmcd Local Discography</TITLE> 5</HEAD> 6<BODY BACKGROUND="bkgnd.gif" BGCOLOR="#FFFFFF"> 7 8<DIV ALIGN="center"> 9<A HREF="$XMCD_URL"><IMG SRC="xmcdlogo.gif" ALT="xmcd" BORDER="0"></A><BR> 10<FONT FACE="times">by <A HREF="http://www.amb.org/ti/">Ti kan</A></FONT> 11<P> 12<FONT SIZE="+4" FACE="times">Local Discography (UNIX version)</FONT> 13<P> 14<DIV ALIGN="center"><A HREF="index.html"><BIG><B>Main Index</B></BIG></A></DIV> 15<P> 16</DIV> 17<H2>Introduction</H2> 18<DIR> 19<P> 20Welcome to xmcd <I>Local Discography</I>. This is a storage area on 21your system that can be used to collect and organize files related to 22each CD you own. The files can be text, HTML or other documents, 23image or animation files, sound clips, etc. Examples are music reviews, 24artist interviews, photographs, fan information, MP3 sound files etc. 25You can download these from fan sites on the Internet, or create your own. 26You can make local web pages that contain links to Internet 27sites, or links to files associated with other CDs in Local Discography. 28<P> 29These files can be viewed, played and/or printed using the <I>wwwWarp</I> 30feature of xmcd. Xmcd will drive an external web browser to access 31the files. 32<P> 33</DIR> 34<H2>Directory Organization</H2> 35<DIR> 36<P> 37The top-level Local Discography directory is <B>$DISCOGDIR</B> 38on your system. This was created when xmcd was installed. 39Under this directory there are hierarchy of directories of music genres 40(i.e., <I>Rock, Classical, Jazz,</I> etc.). These genres match those 41of the CDDB<SUP>2</SUP> service. Xmcd automatically creates the genre and 42sub-genre directories, as well as the per-CD directories. 43When you select the "Xmcd Local Discography" entry in xmcd's 44<I>wwwWarp</I> menu, your web browser will go to a xmcd-generated web 45page about the CD that is currently loaded. 46<P> 47The Local Discography directory path pertaining to the CD is displayed 48on the web browser when you select "Xmcd Local Discography". 49Scroll the browser to the bottom of the page. 50<P> 51</DIR> 52<H2>Setup Instructions</H2> 53<DIR> 54<P> 55No setup in xmcd is necessary to use <I>wwwWarp</I> and Local Discography. 56However, you must have a supported and functioning web browser installed 57on your system. 58<P> 59<H4>Web browser configuration</H4> 60<P> 61Your system must have the 62<A HREF="http://www.mozilla.org" TARGET="_blank">Mozilla</A>, 63<A HREF="http://home.netscape.com" TARGET="_blank">Netscape</A>, 64<A HREF="http://www.galeon.org" TARGET="_blank">Galeon</A> or 65<A HREF="http://www.opera.com" TARGET="_blank">Opera</A> 66web browser software installed in order to use xmcd's <I>wwwWarp</I> 67and Local Discography features. Other web browsers will not work 68correctly with <I>wwwWarp</I>. 69<P> 70In order to reach Internet sites via <I>wwwWarp</I>, your system must 71be connected to the Internet. However, the Local Discography feature 72does not require an Internet connection. 73<P> 74If your system is within a firewall, and requires the use of a proxy server 75to access the Internet, then your web browser must be appropriately 76configured. See your local system administrator about configuring your 77web browser. To test internet accessibility, start your web browser 78and enter <B>$XMCD_URL</B> in the location bar. This should 79take you to the Xmcd official web site. 80<P> 81To test xmcd's <I>wwwWarp</I> capability, start xmcd and click on the 82<I>wwwWarp</I> button (the one with the world symbol). Choose the 83"<B>Xmcd official web site</B>" entry in the menu. This should 84cause your web browser to go to the Xmcd official web site. 85<P> 86Normally xmcd will search your system and automatically invoke a 87supported web browser on your system when you use <I>wwwWarp</I> 88and Local Discography. However, if one of the following conditions occur: 89<P> 90<UL> 91<LI>Xmcd cannot locate a supported web browser on your system. 92<LI>You have multiple browsers installed, and xmcd is invoking an 93 undesired version. 94</UL> 95<P> 96The remedy is to define the full path to the browser executable 97in the BROWSER_PATH environment variable. If you use Bourne Shell, 98Korn Shell or similar, add the following to your $HOME/.profile file: 99<P> 100<PRE> 101 BROWSER_PATH=/usr/local/bin/mozilla 102 export BROWSER_PATH 103</PRE> 104<P> 105If you use C-Shell or similar, add the following to your $HOME/.cshrc file: 106<P> 107<PRE> 108 setenv BROWSER_PATH /usr/local/bin/mozilla 109</PRE> 110<P> 111Substitute <I>/usr/local/bin/mozilla</I> above with the actual path to 112your desired browser executable. Log out and log in again to have this 113take effect. 114<P> 115<H4>Local Discography directories</H4> 116<P> 117When xmcd is installed for the first time, the top level Local Discography 118directory as well as some basic music genre subdirectories are created 119for you. When xmcd or cda gets a successful CDDB<SUP>2</SUP> query of 120CD information, it automatically creates the Local Discography directory 121for the loaded CD. 122<P> 123An HTML index file is also automatically installed by xmcd and cda 124in each CD's Local Discography directory. This is the file that xmcd will 125point your web browser to, when you view a CD's Local Discography. 126<P> 127You can put other related files in each CD's Local Discography directory, 128such as images and sound clips. These files will automatically appear 129in the CD's Local Discography when you use xmcd's wwwWarp system to 130view it. 131<P> 132Xmcd and cda will also automatically create the index files for browsing 133your Local Discography directories. Once you start loading and playing 134your CDs in the drive, you will find that your Local Discography 135will grow, and you can go to the Main Index to browse your CD collection 136by the genres and subgenres. 137<P> 138You are now ready to use Local Discography! 139<P> 140</DIR> 141<H2>How to Use</H2> 142<DIR> 143<P> 144To use Local Discography, start xmcd and load a CD in the drive. 145Click on the <B>wwwWarp</B> button on xmcd's main window (this is 146the button with the world symbol). A <I>wwwWarp</I> menu will pop up. 147Choose the "<B>Xmcd Local Discography</B>" entry, and your 148web browser will go to the appropriate entry. 149<P> 150The web browser will display the artist, disc title and track title 151information about the currently loaded CD, as well as other information 152from the CDDB<SUP>2</SUP> service. 153<P> 154Disc and track titles on the Local Discography page are usually clickable 155hyperlinks, that causes a search to be done on the CDDB search engine. 156<P> 157If there are other files in the directory, the browser will also 158display a listing of those files. You can click on a file to view 159or play it. Note that your web brower may need certain plug-ins in 160order to open or play some file formats. 161<P> 162The page will also display hyperlinks (URLs), if any are found in the 163Disc Notes or Track Notes portions of the CD information. 164<P> 165</DIR> 166<H2>Copyrights</H2> 167<DIR> 168<P> 169Please be aware of possible legal implications when sharing music-related 170files with others. Some of the information, including album cover art, 171graphics and photos, lyrics and other data are likely to be protected by 172copyright. Xmcd and its author are not liable for the users' actions. 173<P> 174</DIR> 175<H2>Related Links</H2> 176<P> 177<UL> 178<LI><A HREF="$XMCD_URL">Xmcd</A> 179 - Motif CD player by Ti Kan 180 </LI> 181<LI><A HREF="http://www.amb.org/xmmix/">Xmmix</A> 182 - Motif audio mixer by Ti Kan 183 </LI> 184<LI><A HREF="http://www.cddb.com/">CDDB</A> 185 - The #1 music info source 186 </LI> 187<LI><A HREF="http://www.hubbe.net/~hubbe/plugger.html">Plugger</A> 188 - Streaming multimedia plug-in for UNIX Mozilla and 189 Netscape by Fredrik Hübinette 190 </LI> 191<LI><A HREF="http://www.mp3dev.org/">LAME</A> 192 - High performance MP3 encoder, used by xmcd 193 </LI> 194<LI><A HREF="http://www.xiph.org/ogg/vorbis/">Ogg Vorbis</A> 195 - An open compressed audio format and encoder, used by xmcd 196 </LI> 197<LI><A HREF="http://flac.sourceforge.net/">Free Lossless Audio Codec</A> 198 - An open lossless audio compression format 199 </LI> 200<LI><A HREF="http://www.audiocoding.com/">Audiocoding.com</A> 201 - Home of the FAAC encoder and FAAD decoder software, for the 202 MPEG-2/MPEG-4 AAC audio formats 203 </LI> 204<LI><A HREF="http://www.spies.com/Sox/">Sox</A> 205 - Sound eXchange: sound file format conversion utility by Lance Norskog 206 </LI> 207<LI><A HREF="http://www.opensound.com/">Open Sound System</A> 208 - Sound driver for many UNIX platforms 209 </LI> 210<LI><A HREF="http://www.alsa-project.org/">Advanced Linux Sound Architecture</A> 211 - New audio support architecture for Linux 212 </LI> 213</UL> 214<P> 215<HR> 216<I>CDDB</I> and <I>CDDB<SUP>2</SUP></I> are trademarks of 217 <A HREF="http://www.gracenote.com/">Gracenote</A>. 218<BR> 219<SMALL>@(#)discog.htm 6.38 04/01/05</SMALL> 220 221</BODY> 222</HTML> 223 224