home *** CD-ROM | disk | FTP | other *** search
/ Freelog 2 / Freelog002.iso / Logs / Musique / FreeCd / README.TXT < prev   
Text File  |  1998-12-01  |  13KB  |  337 lines
  1. FreeCD v1.91 for Windows 95 
  2. 5/7/97 - by Nate Smith
  3. e-mail: nate@cryogen.com
  4.  
  5. --------------------------------------------
  6. - README.TXT: a fast & dirty user's manual -
  7. --------------------------------------------
  8.  
  9. -----------------------------
  10. WHAT IS FREECD? ("The Spiel")
  11. -----------------------------
  12. FreeCD is a 100% free audio CD player for Windows, featuring a
  13. graphical, intuitive, mouse-driven interface and a compact and
  14. customizable display.  It includes such useful features as track
  15. repeat, disc eject, and multiple time-display modes, plus it can be
  16. minimized to the taskbar notification area (by the clock) to save
  17. screen space, where it can still be completely controlled through a
  18. small icon and a pop-up menu.  Very versatile, easy to use, and you
  19. can't beat the price!
  20.  
  21.  
  22. --------------
  23. IMPORTANT NOTE
  24. --------------
  25. This version of FreeCD ONLY SUPPORTS Windows 95.  It should work on NT
  26. 4, but it WILL NOT work on earlier versions of Windows (not even
  27. Win32s).  However, the upcoming FreeCD version 2.0 WILL BE compatible
  28. with all Windows versions.  Just hang in there!
  29.  
  30.  
  31. ------------
  32. INSTALLATION
  33. ------------
  34. To install FreeCD, simply copy the file FREECD.EXE into your Windows
  35. folder (i.e.: C:\WINDOWS) or any other folder of your choice, and pick
  36. one of the following options:
  37.  
  38.  
  39. -- I. To create an icon for FreeCD on your Desktop --
  40.  
  41. 1. Open Windows Explorer and locate the file FREECD.EXE in your Windows
  42.    folder (or wherever you originally installed the file).  
  43. 2. Right-click the file and drag it onto your Desktop.
  44. 3. On the pop-up menu that appears, select "Create shortcut(s) here".
  45.    (To rename the icon, select it, press F2, type a new name, and press
  46.    Enter).
  47. 4. Double-click the new icon to run FreeCD.
  48.  
  49.  
  50. -- II. To create an icon on your Start Menu under "Programs" --
  51.  
  52. 1. Open Windows Explorer and locate the file FREECD.EXE in your Windows
  53.    folder (or wherever you originally installed the file).
  54. 2. Right-click the file and select "Create shortcut" from the pop-up
  55.    menu.
  56. 3. Right-click the new shortcut and select "Cut".
  57. 4. Locate your Windows folder (most likely C:\WINDOWS), and open the
  58.    subfolder named "Start Menu".
  59. 5. In the Start Menu directory, open the subfolder named "Programs".
  60. 6. In the right-hand pane of Explorer where the contents of "Programs"
  61.    are displayed, right click the mouse on any blank area.
  62. 7. From the pop-up menu, select "Paste".
  63. 8. Open your Start Menu, select Programs, and you'll see "Shortcut to
  64.    FREECD.EXE" (or something similar).  Select this to run FreeCD.
  65.    NOTE: To rename "Shortcut to FREECD.EXE" to something more
  66.    meaningful like "FreeCD", select "Shortcut to FREECD.EXE" in
  67.    Explorer (if it's not there, follow the steps above to locate it).
  68.    Press F2, type a new name, and press Enter.  Open your Start Menu to
  69.    see the changes.
  70.  
  71. Hope that covers all the bases.  If you encounter any problems getting
  72. FreeCD to work, see the end of this document for my e-mail address.
  73.  
  74.  
  75.  
  76. ------------
  77. UNINSTALLING
  78. ------------
  79. To completely remove FreeCD from your computer (come on, you wouldn't
  80. REALLY want to do something like that, now would you?), simply open
  81. Windows Control Panel, select "Add/Remove Programs", select "FreeCD
  82. v1.91" from the list, and press the "Add/Remove" button.
  83.  
  84. NOTE: If you're one of the few (un)lucky people who has FreeCD version
  85. 1.9, then be sure you delete the file FREECD.DAT from the same
  86. directory as your old FREECD.EXE.  This old file won't harm anything
  87. (you're welcome to leave it there if you want), but it won't be used
  88. anymore and simply takes up space.
  89.  
  90.  
  91.  
  92. ------------
  93. USING FREECD
  94. ------------
  95. Operation is pretty straightforward - I tried to make the interface
  96. resemble a typical home stereo, with a few extras.  Here's a list of
  97. all the buttons, and what they do (it helps if you read this in Windows
  98. Notepad with FreeCD running close by):
  99.  
  100. (from left to right)
  101.  
  102. - Reverse Skip - skip to the previous track; from track 1, skips to the
  103.   last track on the disc
  104.  
  105. - Play/Pause - plays the CD; while the CD is playing, pauses the CD
  106.   (the current status is indicated by the marks on the play button)
  107.  
  108. - Forward Skip - skip to the next track; from the last track on the
  109.   disc, skips to track 1
  110.  
  111. - Time Display - click here and drag to move the window; double-click
  112.   once to display the remaining track time; double-click again to
  113.   display the remaining disc time; double-click again to display the
  114.   total disc length; double-click a 4th time to return to the normal
  115.   display again
  116.  
  117. - Six little buttons, clockwise from top-left:
  118. Volume - opens the Windows volume control
  119. Minimize - minimizes the window onto the Taskbar
  120. Exit - exits FreeCD
  121. Help - displays version info as well as my e-mail address for
  122.    emergencies(?); in the future this will access the full help system
  123. Eject - ejects the disc, or if the drive is open, closes it
  124. Repeat - toggles track repeat on & off
  125.  
  126.  
  127. - Command Menu - right-click anywhere in the window to display this;
  128.   here you can access otherwise unavailable commands such as Options
  129.   and Always On Top
  130.  
  131.  
  132. Options - here's a list of the options in the Options dialog box and
  133. what they do:
  134.  
  135. - Show time on taskbar button - displays track & time info on the
  136.   FreeCD button on the taskbar (try it!)
  137.  
  138. - Always startup as taskbar icon - always starts FreeCD minimized as an
  139.   icon in the taskbar notification area, regardless of whether FreeCD
  140.   was minimized when you last exited
  141.  
  142. - Use last screen position on startup - saves the position of the
  143.   FreeCD window when you exit, and starts up in the same position next
  144.   time (If you leave this option turned off, FreeCD always starts up in
  145.   the lower-right corner of the screen)
  146.  
  147. - Automatically play current CD on startup - plays the CD in the drive
  148.   on startup or when a new CD is inserted (If this is turned off, you
  149.   must hit play everytime you start FreeCD and when you insert a new
  150.   disc) 
  151.  
  152. - Automatically repeat at end of disc - repeats the CD when the end is
  153.   reached (If this is turned off, the CD simply stops at the end) 
  154.  
  155. - Keep track repeat enabled when a new track is selected - if track
  156.   repeat is turned on, this option keeps it on even if you skip to a
  157.   new track (If this option is turned off, track repeat turns off
  158.   whenever you skip to a new track)
  159.  
  160.  
  161. My best advice for using the program is this: just play around and try
  162. clicking (left, right, and double) on everything.  Remember to RIGHT-
  163. CLICK anywhere on the window (or the taskbar icon) to display the
  164. command menu.
  165.  
  166. And remember that if you need any further help using FreeCD (or if
  167. these instructions just don't make sense) just check out the FreeCD web
  168. site or e-mail me (check the addresses below) to get the answers you
  169. need.  Good luck!
  170.  
  171.  
  172.  
  173. ---------------------------------------------
  174. TODAY & TODAY ONLY, WE'RE GIVING THEM AWAY!!!
  175. ---------------------------------------------
  176. Yes, it is called "FreeCD" and it does what it says.  Move over,
  177. shareware, here comes FREEWARE!  Yep, 100% free of charge.  You can use
  178. it, modify it, sell it, distribute it by electronic or other means, or,
  179. heck, do pretty much anything you want with it!  However, if you've got
  180. a little extra cash burning a hole in your pocket, see "A FINAL WORD"
  181. below... 
  182.  
  183. (Just one little request, since it is free and all: If you do decide to
  184. SELL it, sell it at whatever it cost you (and please give credit to the
  185. author), and if you MODIFY it, please send me a copy of your changes -
  186. I'd be very interested in what other developers think of my software.
  187. That's all, thanks :)
  188.  
  189.  
  190.  
  191. -------------
  192. RELEASE NOTES
  193. -------------
  194. Version 1.91 is probably the final step before version 2.0.  This is a
  195. bug fix and update to version 1.9, which I'm sorry to say I released in
  196. a hurry because I thought my ISP was going to shut me down (whoops!).
  197. Anyway, this (v1.9 & 1.91) is the third "real" release of this program,
  198. although there were a couple "pre-1.0" alpha releases which I'm not
  199. especially proud of :).  This version is a significant update to
  200. version 1.1, although not quite enough changes were made to warrant a
  201. step all the way up to 2.0 - as a matter of fact, v1.9 and v1.91 are
  202. beta releases of 2.0.  Among the changes made since v1.1 are:
  203.  
  204. - no more space-eating title bar (just click & drag the time display to
  205.   move the window around)
  206.  
  207. - fully configurable!  Just right-click to display the command menu,
  208.   click Options, and away you go!
  209.  
  210. - minimizes to an icon in the taskbar notification area, to save space
  211.   in the main taskbar, and to provide status info without having to
  212.   restore the main window.  NOTE: to see the current time while
  213.   minimized, hold the cursor over the icon for a few seconds...
  214.  
  215. - saves last display position and uses it every time you startup
  216.  
  217. - can display the current track & time on the taskbar button
  218.  
  219. - track repeat actually works!
  220.  
  221. - volume control! (well, kind of...)
  222.  
  223. - can display time remaining and total time
  224.  
  225. - nifty menu bitmap!
  226.  
  227. - the buttons now display their status, instead of using the time
  228.   display
  229.  
  230. - access Always On Top through the menu, instead of a button
  231.  
  232. and, as before:
  233.  
  234. - v1.9+ are Win95-only, written in native 32-bit code.  It may work
  235.   with Win32s, but I haven't tested this (though you're free to give it
  236.   a try and let me know whether it works...)
  237.  
  238. - as far as I can tell, all the bugs have been fixed (though, as usual,
  239.   there are a few new ones, though not nearly as significant as the old
  240.   ones...)
  241.  
  242. - minimizes onto the taskbar like a good little program should, instead
  243.   of the Desktop (like it used to)
  244.  
  245. - the window can now be moved around to your heart's content
  246.  
  247. - automatically plays the CD when the program starts and when a new CD
  248.   is loaded (this can be turned off in the Options menu)
  249.  
  250. - automatically repeats the CD when the end is reached (this can be
  251.   turned off in the Options menu)
  252.  
  253. - includes a disc eject button
  254.  
  255. - always on top feature
  256.  
  257. - disc length display
  258.  
  259. - OK, so it doesn't do much; but hey, what it does, it does well, and
  260.   it looks pretty nifty to boot
  261.  
  262.  
  263.  
  264. ----------
  265. KNOWN BUGS
  266. ----------
  267. I hope these won't cause you any difficulty (and rest assured, they'll
  268. all be fixed in v2.0), but here are the current bugs in FreeCD:
  269.  
  270. - the time display will occasionally skip a second or bog down if the
  271.   system is busy (this has been greatly improved in v1.91, but still
  272.   occasionally happens when the system is really busy)
  273.  
  274. - sometimes the track skip buttons won't behave as expected; just click
  275.   again and they usually work (this one sort of has a mind of its
  276.   own...)
  277.  
  278. - sometimes track repeat will fail to work (this should be pretty much
  279.   eliminated in v1.91)
  280.  
  281. If you find any other bugs or glitches, just e-mail me at the address
  282. below and let me know.  Your feedback is greatly appreciated!
  283.  
  284.  
  285.  
  286. -----------
  287. SOURCE CODE
  288. -----------
  289. Versions 1.9+ were programmed and compiled with Borland's C++ 5.0
  290. Development Suite (a great product), adapted from the 32-bit code for
  291. v1.1.  I may or may not continue to work on this particular program for
  292. much longer, so if you'd like to pick it up where I leave off, let me
  293. know.  Or if you'd simply like to know what makes it tick, you can get
  294. the source code at the FreeCD web site (see below). 
  295.  
  296.  
  297.  
  298. -----------------
  299. HOW TO CONTACT ME
  300. -----------------
  301. Thanks much for giving FreeCD a try.  Again, if you experience any
  302. problems or have any questions I'd be glad to help, and I always accept
  303. constructive criticism and suggestions for improvements.  You can reach
  304. me at my new e-mail address:
  305.  
  306.     nate@cryogen.com
  307.  
  308. Please include "FreeCD v1.91" in the subject line, and for problems
  309. with running the program, please include as much information as
  310. possible about relevant computer hardware and whatever software was
  311. running at the time the problem occurred.
  312.  
  313. NOTE: one problem I hear about quite often is that FreeCD displays NO
  314. DISC and doesn't play even when a CD is loaded.  In this case, it's
  315. most likely a problem with either your CD-ROM setup or your Multimedia
  316. setup.  To make sure, try playing a CD with Windows Media Player.  If
  317. this doesn't work, then you'll have to consult either your Win95
  318. documentation or your computer manufacturer to properly set up your
  319. multimedia hardware and Windows drivers.  For more help with this and
  320. other problems, see the FreeCD web site at:
  321.  
  322.     www.cryogen.com/freecd
  323.  
  324.  
  325.  
  326. ------------
  327. A FINAL WORD
  328. ------------
  329. Although I will continue to distribute my software free of charge until
  330. I start writing commercial-grade, truly useful programs, I'll be
  331. accepting job offers and charitable donations to the Nate Smith College
  332. Fund for the next four (or so...) years.  E-mail me if you'd like to
  333. pursue either of these.
  334.  
  335. Thanks again for your interest and support.
  336.  
  337. - Nate Smith