home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / cd2mp3.zip / cd2mp3pm.txt < prev    next >
Text File  |  1999-10-04  |  10KB  |  266 lines
  1. Welcome to CD2MP3 1.13!  The next step into MP3 world ... after PM123.
  2. =======================
  3.  
  4. I always make my products very straightforward and fast to use, and I hope
  5. this one lives up to my expectations.  Tell me what you think.
  6.  
  7. The BEST way to thank me if you like this program is to register your copy
  8. of PM123. ;)  Thank you.  Did you know I do this instead of working for
  9. paying my university expenses?  Oh, you don't know what is PM123?  point
  10. your Web Browser to http://www.teamos2.sci.fi/pm123/ and
  11. http://www.cam.org/~guardia/pm123.html ASAP, you don't know what you're
  12. missing!
  13.  
  14. Thanks to Aglaja Przyborski <aglaja@ibm.net> and Klaus Staedtler for the
  15. nice icons.
  16.  
  17.  
  18. Usage
  19. =====
  20.  
  21. For the MP3 setup, choose your Encoder and the global bitrate (ie.: not per
  22. channel).  Not all the bitrates are supported for all WAV files and by all
  23. Encoders.  Low Priority will launch the encoder in idle priority.  (This
  24. doesn't work for DOS programs, and for some programs like BladeEnc, see
  25. Notes).  High Quality is implementation depended (see below).  Specify the
  26. MP3 directory where the final MP3 is to be placed, and write some last
  27. minute custom parameters to be placed on the Encoder's command line.
  28.  
  29. For CDDB support, it is *****VERY IMPORTANT**** that you setup an e-mail
  30. address before attempting to do anything.  Afterwards, you can add new
  31. servers and the one you select will be the one used during operations,
  32. unless "Try all servers" is active.  "Filename format" is used when CDDB
  33. information was found and "Fallback filename format" is used when no
  34. information was found.  HTTP support is only useful when you need to access
  35. the web through a proxy or behind a firewall.
  36.  
  37. The filename formats have the following format specifications:
  38.  
  39. %t = song title
  40. %a = album artist
  41. %l = album title
  42. %y = year
  43. %c = song comment
  44. %g = genre
  45.  
  46. %k = song track
  47. %C = album comment
  48.  
  49. %m = length (minutes)
  50. %s = length (remaining seconds)
  51. %S = length (ALL in seconds).
  52.  
  53. To Grab CD Tracks, set the Grabber.  If CD2MP3 didn't detect your CD drive
  54. correctly, type it in.  Set an appropriate (ie.: huge) Temporary directory
  55. that will hold the WAV files.  After refreshing the view, you can start
  56. selecting tracks.  There is a popup menu available, and the usual container
  57. accelerators are available (shift-f8, shift-f9, shift-f10, ctrl-/, ctrl-\,
  58. shift-arrows, etc.). Custom is to add last minute custom parameters to the
  59. Grabber's command line.
  60.  
  61. To convert WAV files, add WAV files by either bringing up the file dialog
  62. or by dragging and dropping WAV files in the listbox.  The correspondent
  63. key for Add is Insert and Delete for Delete.
  64.  
  65. NOTE!!  If something goes terribly wrong with CDDB and you can't figure it
  66. out, CD2MP3 PM writes to the invisible console what comes in and out of the
  67. sockets.  So start CD2MP3 PM with console redirection to see what happens.
  68. ie.: "cd2mp3pm > log"
  69.  
  70.  
  71. Super Grab
  72. ==========
  73.  
  74. While in Super Grab mode, CD2MP3 PM gives the Encoder a priority a bit
  75. higher than the Grabber.  For example, if you set Low Priority, the Encoder
  76. is running at idle class, delta 1, and the Grabber at idle class, delta 0.
  77. Without Low Priority, the Encoder is running normal class, delta 1 and the
  78. Grabber, normal class, delta 0.
  79.  
  80. This is good when you're not trying to run a DOS program, as you know the
  81. OS/2 APIs can't set the priority for a DOS session.  So if you intend to
  82. use a DOS Encoder at Low Priority, edit the cd2mp3pm.cfg and follow the
  83. steps below to set the priority at "i1".  If not, set it to "r1".  The same
  84. for a DOS Grabber, "i0" and "r0".
  85.  
  86. Also note that real concurrent Encoding and Grabbing will only occur if you
  87. have a Bus Mastered CD-ROM drive connected and setup on a Bus Mastered
  88. controller.  For example, the secondary ATA controller on my motherboard is
  89. defective and doesn't work with Bus Mastering, and I have my CD-ROM drive
  90. plugged in it.
  91.  
  92.  
  93. Notes
  94. =====
  95.  
  96. CD2MP3 doesn't always know when a session has been killed or has stopped
  97. normally, so to prevent CD2MP3 from continuing as nothing happened, press
  98. Stop instead.  If the session doesn't get killed, then try to kill it by
  99. yourself.  This is the case for Win32-OS/2 programs.  Don't try to close
  100. the window.  You will not accomplish anything by doing so.  Kill -9 doesn't
  101. work on them either.  There are no way to terminate such sessions at the
  102. moment, but fortunately, ToMPG will end on a couple of key stroke.
  103.  
  104. To run DOS programs at idle priority, you will have to use Set Priority.
  105. (http://hobbes.nmsu.edu/pub/os2/util/system/sp103.zip)  After installing
  106. the utility properly, edit the Config file, set the executable to
  107. spdos.exe, and EncoderBefore parameter to something like "i1 l3enc.exe".
  108.  
  109. Alfons DOES NOT accept a temporary directory.  It will use the current
  110. directory as a WAV place holder.  THIS IS NOT A BUG IN CD2MP3.  It's even a
  111. feature, else Alfons wouldn't work at all.
  112.  
  113. Also note that BladeEnc sets its own priority, so CD2MP3 PM has _no_
  114. control over it.  Use its command line options to see which one makes it
  115. operate like it should.
  116.  
  117.  
  118. Known Bugs
  119. ==========
  120.  
  121. - Deleting the last record while in shift-f8 mode traps in PMCTLS.DLL.
  122.   This is an OS/2 bug.  Hell, it even happens in the WPS, but it can
  123.   recover due to great recovery mechanism.
  124.  
  125. - GrabberAcceptsOutput = FALSE screws the wav->mp3 function.  Erase the
  126.   temporary directory entry field when using such a Grabber.
  127.  
  128. - Same thing for Encoders and ID3 Tag function...
  129.  
  130. - HTTP/Proxy Authentification doesn't work.  Anybody need this?
  131.  
  132. - Proxy support untested.  Please test it.  If the code works at all, it
  133.   only works on HTTP/1.1 proxies.  HTTP/1.0 proxies are not very useful in
  134.   any case. .. ??
  135.  
  136.  
  137. Config Files
  138. ============
  139.  
  140. The config file cd2mp3pm.cfg permits to add custom CD Grabber and MP3
  141. Encoder programs support into CD2MP3.   Read the comments in the file for
  142. more information.
  143.  
  144.  
  145. Grabbers/Encoders Notes
  146. =======================
  147.  
  148. I included Leech, Alfons and JCread2, because I don't know of any other, do
  149. you?
  150.  
  151. I included ToMPG, L3Enc and BladeEnc because I feel these are the only
  152. Encoders anyone should ever use.  ToMPG is more than 9 times faster than
  153. L3Enc, and I can hear little difference when encoding CD quality WAVs at
  154. 128kb/s. Use it when you're in a hurry.  L3Enc 2.x just gives the best
  155. quality at 128kb/s. It's downsampling is magnificent and it even supports
  156. MPEG 2.5. With new "LFN support" for DOS encoders, you can now finally use
  157. L3Enc 2.x for DOS in all the comfort of long filenames as CD2MP3 PM will do
  158. the dirty renaming work. And finally, the author of BladeEnc assures his
  159. encoder gives best quality at and over 160kb/s (seems to be the case).
  160.  
  161. If you want to know more about my encoder choices, or where to find them,
  162. read others.txt.
  163.  
  164.  
  165. History
  166. =======
  167.  
  168. 1.13 - October 4, 1999
  169. ----
  170.  
  171. - CDDB server requires 8 char long ID.  Some CDs ID are now correctly
  172.   prefixed with zeros.
  173. - Multiple exact match now works.
  174.  
  175. 1.12 - January 30, 1999
  176. ----
  177. - Modified readcd to be CTCDROM.DMD compatible (This CD drive manager of
  178.   Unite CD Maker doesn't want to read in the CODE segment, so I had to
  179.   define local variables for the parameter)
  180. - Was able to properly make the notebook context menu, thanks to
  181.   Eric Norman <warped@cs.montana.edu>
  182.  
  183. 1.11
  184. ----
  185. - Fixed problems on CD drive opening failure.
  186. - Made various entry fields bigger.
  187. - Now does automatic translation of invalid filename characters.
  188. - Fixed keyboard mnemonic in the main dialog.
  189. - Added a few mini-icons.  It seems the PM doesn't draw mnemonic underlines
  190.   anymore, but they are still there (R for Refresh, C for Convert, S for
  191.   Stop and A for Cancel)
  192. - Fixed some socket failure report problem.
  193. - Added more ID3 Tag Genres.
  194.  
  195. 1.10
  196. ----
  197.  
  198. - Added CDDB support as well as ID3 tag support!
  199. - Added the ability to edit container fields.
  200. - Added mnemonics to static text... thanks to
  201.   Stefan Ruck <100664.1353@compuserve.com> for the trick in EDM/2!
  202. - Kludged Win32-OS/2 return code better.  It should now never care about
  203.   what garbage it may return.
  204. - Updated CFG file for new encoders and grabbers.
  205. - Fixed crash when auto-removing records from the WAV container.
  206. - Added "LFN support" for DOS programs through smart renaming.
  207.  
  208. - Sorry Aglaja Przyborski, didn't have the time to add the new icons.
  209.  
  210. 1.01
  211. ----
  212.  
  213. - DOH!!  pointers did it again... basename wasn't functional
  214. - remove & deselect wasn't save and reloaded to its previous state
  215.  
  216. 1.0
  217. ---
  218.  
  219. - Lots of things
  220.  
  221. 0.91
  222. ----
  223.  
  224. - numbering will go like 01,02,03 ... instead of 1,2,3.  Someone pointed
  225.   out only the former sorts properly after 9.
  226. - new GrabberNoDrive option for program such as READCDA
  227. - new EncoderAcceptsOutput for program such as BladeEnc
  228.  
  229. 0.90
  230. ----
  231.  
  232. - Initial release
  233.  
  234.  
  235. Legal stuff
  236. ===========
  237.  
  238. This free software (a la GNU) product is used at your own risk, although it
  239. is highly improbable it can cause any damage.
  240.  
  241. The code is MINE, all MINE MINE MINE.  I don't wanna see people starting to
  242. use this code as if it were public domain.  Always re-distribute the
  243. package in its entirety and don't charge anything from it.
  244.  
  245. If you plan on using the code or copying me, please give me the credits,
  246. thanks.  However, any commercial or profitable use of either the product or
  247. the source code will require a special permission directly from the author.
  248.  
  249.  
  250. Contacting the Author
  251. =====================
  252. If you have any suggestions, comments or bug reports, please let me know.
  253.  
  254. Samuel Audet
  255.  
  256. E-mail:      guardia@cam.org
  257. Homepage:    http://www.cam.org/~guardia
  258. IRC nick:    Guardian_ (be sure it's me before starting asking questions though)
  259. Talk Client: Guardian@guardian.dyn.ml.org
  260.  
  261. Snail Mail:
  262.  
  263.    377, rue D'Argenteuil
  264.    Laval, Quebec
  265.    H7N 1P7   CANADA
  266.