home *** CD-ROM | disk | FTP | other *** search
/ Boot Disc 6 / boot-disc-1997-02.iso / utils / mmedia / easycd / easycd.txt < prev    next >
Text File  |  1996-09-19  |  20KB  |  639 lines
  1.  _-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_
  2. /                    EasyCD, Version 2.20                   \
  3. \  (C) Copyright 1996, Greg Leichner, All rights reserved.  /
  4.  -_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-
  5.  
  6.                       September 19, 1996
  7.  
  8. User's Guide Contents
  9. ---------------------
  10.  
  11.     1 - Introduction
  12.  
  13.     2 - The EasyCD2 Tray Icon
  14.     2.1 - Left Mouse Button
  15.     2.2 - Right Mouse Button
  16.  
  17.     3 - The EasyCD2 Controls Dialog
  18.         3.1 - Status Display Area
  19.     3.2 - Play Button
  20.     3.3 - Pause Button
  21.     3.4 - Stop Button
  22.     3.5 - Next Track Button
  23.     3.6 - Previous Track Button
  24.     3.7 - Eject Button
  25.  
  26.     4 - The EasyCD2 Main Popup Menu
  27.     4.1 - Play
  28.     4.2 - Pause
  29.     4.3 - Stop
  30.     4.4 - Eject
  31.     4.5 - Next Track
  32.     4.6 - Previous Track
  33.     4.7 - Select Track
  34.     4.8 - Random Order
  35.     4.9 - Introduction Play
  36.     4.10 - Repeat All
  37.     4.11 - Repeat Current
  38.     4.12 - Show Controls
  39.     4.13 - Properties
  40.     4.14 - About EasyCD2
  41.     4.15 - Exit EasyCD2
  42.  
  43.     5 - The EasyCD2 Properties Dialog
  44.     5.1 - CD Information
  45.     5.1.1 - General
  46.     5.1.2 - Tracks
  47.     5.1.3 - Clear All Button
  48.     5.2 - Programming
  49.     5.3 - cddb Query
  50.     5.3.1 - Local Database
  51.     5.3.2 - Internet Database Server
  52.     5.3.2.1 - Firewall Proxy Host Configuration
  53.     5.3.2.2 - cddb Server List
  54.         5.3.2.3 - "Fuzzy" Search Results
  55.     5.4 - cddb Submit
  56.     5.4.1 - cddb Submission Guidelines
  57.     5.5 - Options
  58.     5.5.1 - CD Control Panel
  59.     5.5.2 - Play
  60.     5.5.3 - Introduction Play
  61.     5.5.4 - Time Display
  62.     5.5.5 - Eject And Exit
  63.  
  64.     6 - How to Contact GHL Software
  65.  
  66.     7 - Disclaimer
  67.  
  68.  
  69.  
  70. 1 - Introduction
  71.     ------------
  72.  
  73.     This file contains the instructions for using EasyCD2,
  74.     how to configure EasyCD2 to use the cddb local database
  75.     and Internet Servers, and procedures on submitting new
  76.     entries to the cddb database.
  77.  
  78.     EasyCD2 can get CD information from a number of sources.
  79.     When you enter a CD in the CD drive, EasyCD2 is automatically
  80.     started and looks for the information about the current
  81.     CD.  The order of search is as follows:  First, it checks
  82.     the registry for the CD information.  This is where EasyCD2
  83.     stores information when it exits.  Second, it looks in the
  84.     Windows 'cdplayer' applicationÆs 'ini' file.  This file
  85.     should be found in the Windows directory and is named
  86.     'cdplayer.ini'.  Third, EasyCD2 tries to check for the CD in
  87.     a local copy of the cddb database if configured to do so.
  88.     Lastly, if the current CD is not found in any of the previous
  89.     sources on your computer, it will query the cddb server over
  90.     the Internet.  You must already be connected to the Internet
  91.     for EasyCD2 to query the servers.
  92.  
  93.     Once EasyCD2 has information about the current CD, it stores
  94.     it in the registry.  This means after you have either entered
  95.     the information about a CD or the CD information was found
  96.     on a cddb server, it will be saved on your computer for future
  97.     display and you do not have to be connected to the Internet
  98.     to be able to display the entered or found CD information.
  99.  
  100.  
  101.  
  102. 2 - The EasyCD2 Tray Icon
  103.     ---------------------
  104.  
  105.     The tray icon shows the current state of the CD player.
  106.     It also has a 'tip' if the cursor is held over the icon
  107.     that displays more detailed information.
  108.  
  109.  
  110. 2.1 - Left Mouse Button
  111.  
  112.         When the CD is playing:
  113.       single-click: Pause
  114.           double-click: Go to next track
  115.           triple-click: Go to previous track
  116.  
  117.         When the CD is paused:
  118.           single-click: Resumes play
  119.  
  120.         When the CD is stopped:
  121.           single-click: Starts play on first track
  122.  
  123.  
  124. 2.2 - Right Mouse Button
  125.  
  126.     Displays the EasyCD main popup menu.  The menu
  127.     options are described in a section below.
  128.  
  129.  
  130.  
  131. 3 - The EasyCD2 Controls Dialog
  132.     ---------------------------
  133.  
  134.     The controls dialog provides a cd-player like control
  135.     panel for all basic control functions.  In addition,
  136.     a right mouse button popup menu is available to
  137.     get to all other options, including track selection
  138.     and access to the EasyCD2 properties dialog.
  139.  
  140. 3.1 - Status Display Area
  141.  
  142.     The status display area at the top of the controls
  143.     dialog show the current state of the CD player, the
  144.     current track playing and the time of play for that
  145.     track.
  146.  
  147.     If the right mouse button is used in the status display
  148.     area, a menu is displayed that allows track selection
  149.     and the ability to display the properties dialog.
  150.  
  151. 3.2 - Play Button
  152.  
  153.     Always plays the CD from the start of the first
  154.     track.
  155.  
  156.  
  157. 3.3- Pause Button
  158.  
  159.     Pauses the CD at the current position or continues
  160.     play from a previously paused position.
  161.  
  162.  
  163. 3.4 - Stop Button
  164.  
  165.     Stops the CD.  Resets the 'played' status for all
  166.     tracks.
  167.  
  168.  
  169. 3.5 - Next Track Button
  170.  
  171.     Starts play at the next sequential track.  If in
  172.     'Random Order' mode, play is started at a randomly
  173.     selected track from the tracks that have not yet
  174.     been played.  If the Next track button is held down,
  175.     the CD is then fast forwarded until the button is
  176.     released.
  177.  
  178.  
  179. 3.6 - Previous Track Button
  180.  
  181.     Starts play at the previous sequential track.  If
  182.     the previous track button is held down, the CD is
  183.     then fast rewound until the button is released.
  184.  
  185.  
  186. 3.7 - Eject Button
  187.  
  188.     Ejects the CD from the CD player.  This also exits
  189.     EasyCD2.
  190.  
  191.  
  192. 3.8 - Volume Up Button
  193.  
  194.     If a volume mixer was found on your system, this button
  195.     increases the volume.
  196.  
  197.  
  198. 3.9 - Volume Down Button
  199.  
  200.     If a volume mixer was found on your system, this button
  201.     decreases the volume.
  202.  
  203.  
  204. 3.10 - Volume Display
  205.  
  206.     The volume display shows the current volume in the form
  207.     of a small bar graph.  If you click the left mouse button
  208.     on the volume display, it is a "Mute" button.
  209.  
  210.  
  211.  
  212. 4 - The EasyCD2 Main Popup Menu
  213.     ---------------------------
  214.  
  215. 4.1 - Play
  216.  
  217.     Always plays the CD from the start of the first
  218.     track.
  219.  
  220.  
  221. 4.2 - Pause
  222.  
  223.     Pauses the CD at the current position or continues
  224.     play from a previously paused position.
  225.  
  226.  
  227. 4.3 - Stop
  228.  
  229.     Stops the CD.  Resets the 'played' status for all
  230.     tracks.
  231.  
  232.  
  233. 4.4 - Eject
  234.  
  235.     Ejects the CD from the CD player.  This also exits
  236.     EasyCD2.
  237.  
  238.  
  239. 4.5 - Next Track
  240.  
  241.     Starts play at the next sequential track.  If in
  242.     'Random Order' mode, play is started at a randomly
  243.     selected track from the tracks that have not yet
  244.     been played.
  245.  
  246.  
  247. 4.6 - Previous Track
  248.  
  249.     Starts play at the previous sequential track.
  250.  
  251.  
  252. 4.7 - Select Track
  253.  
  254.     Allows the user to select which track to play from
  255.     a menu.  Tracks that have already been played have a
  256.     check mark next to them and the track currently
  257.     playing is dimmed out (not selectable).
  258.  
  259.  
  260. 4.8 - Random Order
  261.  
  262.     Toggles EasyCD2 between playing the tracks in a
  263.     sequential order and a random order.
  264.  
  265.  
  266. 4.9 - Introduction Play
  267.  
  268.     EasyCD2 can play a user selected amount of time
  269.     of each track, starting at a selected time offset.
  270.     Please see the 'Options' section for more information
  271.     on 'Introduction Play' mode.
  272.  
  273.  
  274. 4.10 - Repeat All
  275.  
  276.     Repeat All mode will repeat the play of all tracks
  277.     when the end of play is reached.  If not in repeat
  278.     all mode, EasyCD2 will either stop play or exit.
  279.  
  280.  
  281. 4.11 - Repeat Current
  282.  
  283.     Toggles between repeating the current track
  284.     continuously or normal play mode.
  285.  
  286.  
  287. 4.12 - Show Controls
  288.  
  289.     Toggles the display of the CD player control panel
  290.     that allows you to control almost all functions
  291.     of EasyCD2 in very small window.  The control panel
  292.     is described in a previous section.
  293.  
  294.  
  295. 4.13 - Properties
  296.  
  297.     Displays the EasyCD2 properties dialog.  All EasyCD2
  298.     options are selectable from this dialog.  This dialog
  299.     is described in detail in a section below.
  300.  
  301.  
  302. 4.14 - About EasyCD
  303.  
  304.     Displays registration and GHL Software information
  305.     for EasyCD.
  306.  
  307.  
  308. 4.15 - Exit EasyCD2
  309.  
  310.     Exits EasyCD2 (really, that's unbelievable).
  311.  
  312.  
  313.  
  314. 5 - The EasyCD2 Properties Dialog
  315.     -----------------------------
  316.  
  317.     The properties dialog is the central window for all
  318.     EasyCD2 options and CD information.  It is composed of
  319.     five tabbed sheets:
  320.  
  321.     'CD Information' - Used to enter information about
  322.                            the CD currently playing.  This
  323.                            includes, artist, title and track
  324.                            names.
  325.  
  326.         'Programming' -    Used to generate a custom track play
  327.                            order.
  328.  
  329.     'cddb Query' -     Contains all configuration options
  330.                            for querying the cddb database.
  331.  
  332.         'cddb Submit' -    Allows you to submit a new entry to
  333.                            the cddb database by e-mail using
  334.                            an SMTP server.
  335.  
  336.         'Options' -        All general EasyCD2 configuration
  337.                options including play modes, eject
  338.                modes, etc.
  339.  
  340.     Detailed instructions for each sheet are listed below.
  341.  
  342.  
  343. 5.1 - CD Information
  344.       --------------
  345.  
  346.     This information is stored by EasyCD2 for each CD.
  347.     When you play a CD, EasyCD2 searches for the information
  348.     for that particular CD and will display it if it is
  349.     found.
  350.  
  351.  
  352. 5.1.1 - General
  353.  
  354.     You can enter the CD artist name and the title of the
  355.     CD in this section.
  356.  
  357.  
  358. 5.1.2 - Tracks
  359.  
  360.     To enter the title of a track, select the desired track
  361.     from the list and type the title in the text box below the
  362.     list.  The list contents will update as you type the title.
  363.  
  364.     To go to the next track, just press the 'Enter' key when
  365.     done typing the information for the current track.  The
  366.     next track will automatically be selected.
  367.  
  368.  
  369. 5.1.3 - Clear All Button
  370.  
  371.     Select the 'Clear All' button and confirm the clear
  372.     operation in the popup message to clear all CD
  373.     information.
  374.  
  375.  
  376. 5.2 - Programming
  377.       -----------
  378.  
  379.     To specify a custom play order, select a track in
  380.     the 'Disk Order' list and then press the 'Add' button.
  381.     The track is then added to the 'Programmed Order'
  382.     list.  Repeat this process for each track to be
  383.     included in the custom play order.  You may also
  384.     double click the mouse on a track in the 'Disk
  385.     Order' list to add it to the 'Programmed Order'
  386.     list.  A track may be included in the custom play
  387.     order as many times as you would like.
  388.  
  389.     To remove a track from the custom play order, select
  390.     the track in the 'Programmed Order' list and press
  391.     the 'Remove' button.  To clear the entire custom
  392.     play order list, press the 'Clear' button and then
  393.     confirm the clear operation in the popup message.
  394.     A track may be removed from the custom play order
  395.     by double clicking it in the 'Programmed Order' list.
  396.  
  397.     You may change the order of play in the 'Programmed
  398.     Order' list by selecting the track to move and then
  399.     using the 'Up' and 'Down' arrows to the right of the
  400.     list.
  401.  
  402.  
  403. 5.3 - cddb Query
  404.       ----------
  405.  
  406.     EasyCD2 is fully integrated with the CD Information
  407.     database, cddb.  You can lookup CD information from a
  408.     local copy of the database or you can query a cddb server
  409.     over the Internet.
  410.  
  411.     The CD Information database, cddb, and the application,
  412.     xmcd are copyrighted by Ti Kan and are licensed under the
  413.     GNU General Public License for free software.  The use of
  414.     and integration with cddb by EasyCD2 has been expressly
  415.     granted to GHL Software by Ti Kan.  Both cddb and xmcd
  416.     are freely downloadable from the Internet.  For more
  417.     information please see:
  418.  
  419.                http://sunsite.unc.edu/~cddb/xmcd/
  420.  
  421.  
  422. 5.3.1 - Local Database
  423.  
  424.     To download a copy of the Windows compatible database, you
  425.     can FTP it from:
  426.  
  427.         ftp://ftp.netcom.com/pub/tk/tkan/xmcd-cddb/xmcd-cddb.zip
  428.  
  429.         Space for the Windows compatible database file has
  430.     been generously provided by Ti Kan.
  431.  
  432.     The database uses about 10Mbytes when unzipped, the zip
  433.     file is about 3Mbytes.
  434.  
  435.     Unzip the file to a new directory (you can name it anything
  436.     you want, but I suggest "cddb").  Please use the "preserve
  437.     directory" option with whatever unzip tool you use.  cddb
  438.     is composed of category sub-directories.
  439.  
  440.     Select the 'Query Local Database' option to configure
  441.     EasyCD2 to look in the local database each time you play a
  442.     CD.  Enter the full path to the directory where you
  443.     un-zipped the database file in the 'Database Root
  444.     Directory', for example: "c:\cddb".
  445.  
  446.     Test the local database configuration by pressing the
  447.     'Query cddb Now' button.
  448.  
  449.  
  450. 5.3.2 - Internet Database Server
  451.  
  452.     EasyCD2 can use the Internet to query a cddb server for
  453.     the information about each CD you play.  You must already
  454.     be connected to the Internet to query a cddb server.
  455.  
  456.     Select the 'Query Server' option to configure EasyCD2 to
  457.     query a cddb Internet server for each time you play a CD.
  458.  
  459.     If you are behind a firewall, EasyCD2 supports the use of
  460.     a proxy host to get to a cddb server.  To use a proxy host,
  461.     select the 'Use Proxy Host' option.  Enter the name of your
  462.     proxy host and the port that will be used to connect to it.
  463.     The default port is, 888, and is the same port that the
  464.     cddb servers use for communication.
  465.  
  466.     If you are not behind a firewall, select the server name
  467.     from the provided list.  Please select the server that is
  468.     closest to you for fastest response.
  469.  
  470.     Test the cddb Internet server configuration by pressing
  471.     the 'Query cddb Now' button.  NOTE: If you have
  472.     configured EasyCD2 to query the local cddb database, it
  473.     will search there first and if not found then EasyCD2
  474.     will query the specified Internet cddb server.
  475.  
  476.  
  477. 5.3.2.1 - Firewall Proxy Host Configuration
  478.  
  479.     You will have to ask your network administrator to
  480.     create a proxy to one of the cddb servers using TCP/IP
  481.     port 888.  The port that EasyCD2 uses to get to the
  482.     proxy host is configurable.
  483.  
  484.  
  485. 5.3.2.2 - cddb Server List
  486.  
  487.     cddb.celestial.com - Mercer Island, WA, USA
  488.     cddb.sonic.net - Santa Rosa, CA, USA
  489.         smurfy.tcimet.net - East Lansing, MI, USA
  490.     cddb.schoneal.com - Austin, TX, USA
  491.         cddb.dartmouth.edu - Hanover, NH, USA
  492.     sunsite.unc.edu - Chapel Hill, NC, USA
  493.     cddb.shu.ac.uk - United Kingdom
  494.     cddb.ton.tut.fi - Finland
  495.         cddb.westel.hu - Hungary
  496.     cddb.sai.msu.su - Moscow, Russia
  497.     cddb.ieo.nctu.edu.tw - Taiwan
  498.     cddb.dentistry.adelaide.edu.au - Australia
  499.  
  500.  
  501. 5.3.2.2 - "Fuzzy" Search Results
  502.  
  503.     The remote cddb server will return a "fuzzy" search result
  504.     for some CD's.  This can result when your particular CD's
  505.     pressing is not found on the remote cddb server, but one
  506.     or more other pressings of the same title are.  In this
  507.     case EasyCD2 will display the Fuzzy Search Results dialog.
  508.     If the CD you are currently playing is displayed in the
  509.     list of possible matches, select it and press the 'Get
  510.     Information For Selected Title' button.  EasyCD2 will retrieve
  511.     the rest of the CD information.  If the CD you are currently
  512.     playing is not in the list of possible matches, it is
  513.     not present on the remote cddb server and you should select
  514.     the 'Current CD Not In List' button.
  515.  
  516.  
  517. 5.4 - cddb Submit
  518.       -----------
  519.  
  520.     EasyCD2 can submit entries to add to the cddb database.  If
  521.     the CD in question is not found on one of the servers, you
  522.     can enter the information on the 'CD Information' sheet and
  523.     then submit it for inclusion in the cddb database.  This will
  524.     help the database grow and hopefully, over time, more and
  525.     more of the CD's you play will be found automatically.
  526.  
  527.     To submit an entry, enter your e-mail address in the
  528.     'Return Address' text box.  You must also specify the
  529.     address of the SMTP server you use to send e-mail.  If you
  530.     do not know the name of the server, ask your network
  531.     administrator.
  532.  
  533.  
  534. 5.4.1 - cddb Submission Guidelines
  535.  
  536.     Please use the following guidelines for any entries you
  537.     wish to submit to the cddb database:
  538.  
  539.     Submit entries only after you verify they are not already
  540.     in the database.
  541.  
  542.     Do not submit entries that are not completely filled-out
  543.     (i.e., empty track titles, etc.).
  544.  
  545.     Capitalize the first letter of each word only.  Do not
  546.         use upper case for whole words unless it's absolutely
  547.         necessary.
  548.  
  549.     Verify that all spelling is correct.
  550.  
  551.     Submit the entry using the appropriate category.
  552.  
  553.  
  554. 5.5 - Options
  555.       -------
  556.  
  557. 5.5.1 - CD Control Panel
  558.  
  559.     To automatically display the CD control panel, select the
  560.     'Show at Startup' option.  To have the control panel always
  561.     be on top of all other windows, select the 'Always Visible'
  562.     option.
  563.  
  564.  
  565. 5.5.2 - Play
  566.  
  567.     To play tracks in random order (sometimes called 'shuffle
  568.     mode') select the 'Random Track Order' option.  To repeat
  569.     play of all tracks once they have already been played, select
  570.     the 'Repeat All Tracks' option.
  571.  
  572.  
  573. 5.5.3 - Introduction Play
  574.  
  575.     EasyCD2 allows you to configure which section of a track
  576.     will be played during 'Introduction Play' mode.  Instead
  577.     of always playing the first 10 to 15 seconds of the track,
  578.     you can select a starting point from 0 to 60 seconds and
  579.     a length of play from 0 to 60 seconds.  In addition you
  580.     can use the 'at middle of track' option to have EasyCD2
  581.     automatically find the middle of the track and play the
  582.     specified amount of time such that it will play the exact
  583.     middle of the track.
  584.  
  585.  
  586. 5.5.4 - Time Display
  587.  
  588.     You can choose between four different options for
  589.     the time display on the CD Control Panel and the tray
  590.     icon tip.  These are: Track time elapsed, Track time
  591.     remaining, Disc time elapsed, and Disc time remaining.
  592.  
  593.  
  594. 5.5.5 - Eject And Exit
  595.  
  596.     If you would like EasyCD2 to automatically eject the
  597.     current CD when it is done playing all tracks, select the
  598.     'Eject at End of Play' option.  This has no effect if the
  599.     'Repeat All' option is also selected.
  600.  
  601.     To eject the CD when you exit EasyCD2 from the main popup
  602.     menu, select the 'Eject When Exiting EasyCD' option.
  603.  
  604.     To have EasyCD2 stop the CD player when it exits, select
  605.     the 'Stop CD Player When Exiting EasyCD' option.  This
  606.     is the default behavior.
  607.  
  608.  
  609.  
  610. 6 - How to Contact GHL Software
  611.     ---------------------------
  612.  
  613.     E-Mail
  614.     leichner@ix.netcom.com
  615.  
  616.     WWW
  617.     http://www.transdyn.com/~gleichner/ghlsoft.html
  618.  
  619.     Snail-Mail
  620.     Greg Leichner, GHL Software
  621.     1205A Vicente Dr.
  622.     Sunnyvale, CA 94086
  623.     USA
  624.  
  625.  
  626.  
  627. 7 - Disclaimer
  628.     ----------
  629.  
  630.     THE INFORMATION, CODE AND EXECUTABLES PROVIDED ARE PROVIDED
  631.     AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
  632.     INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF
  633.     MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO
  634.     EVENT SHALL GREGORY HOWARD LEICHNER AND OR GHL SOFTWARE BE
  635.     LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT,
  636.     INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS, OR
  637.     SPECIAL DAMAGES, EVEN IF GREGORY HOWARD LEICHNER AND OR GHL
  638.     SOFTWARE HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  639.