home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaMiscModsCD3.iso / _PROGRAMME / CONVERTER / sidconverter.lha / ConvertSID.readme < prev    next >
Encoding:
Text File  |  1994-09-06  |  4.8 KB  |  121 lines
  1. ConvertSID.rexx V1.0b 
  2.  
  3. Please read the entire .readme file before using this script! (I know
  4. its tough but you can do it. :-)
  5.  
  6. ============================================================================
  7. WHAT IS IT?
  8. ============================================================================
  9.  
  10. Its an automated arexx script that allows you to convert lots of
  11. those "pre-ripped" C64 tunes that have those icons that are required by 
  12. PlaySID V3.0 by Per Håkan Sundell & Ron Birk into the "one file" format.
  13. This way you can convert hundreds of files in a matter of a few minutes
  14. and not have to do it all by hand!  
  15.  
  16. I wrote this mainly for myself, but I figured there must be a few other
  17. people that might find this handy.  
  18.  
  19. ============================================================================
  20. WHAT DO I NEED TO RUN IT?
  21. ============================================================================
  22.  
  23. Arexx software (should have it if you have WB 2.0+)
  24. PlaySID V3.0 in SID: (found here on aminet where this file came from)
  25. rexxsupport.library in LIBS:
  26.  
  27. ============================================================================
  28. HOW DO I USE IT?
  29. ============================================================================
  30.  
  31. First there are 2 rules you need to follow:
  32.  
  33. 1) The script will ask you for a destination directory where the converted
  34.    files will go.  You need to make sure that you specify a path that does
  35.    not end in a ":".  Such as "RAM:" or "Music:".  Allowing this would have
  36.    required extra code to check for paths with and without a colon (so I
  37.    would know whether or not to append a "/" to the pathname when writing
  38.    out files) so I was lazy and assumed that a device (eg ram:) and a
  39.    directory would be specified (eg ram:Stuff).
  40.  
  41. 2) The ONLY icons allowed in the source directory where all the "ripped"
  42.    music is located is the ones for the music.  Since the script searches
  43.    for files with the extension ".info", the script has no way of
  44.    distinguishing between a music icon and say, a disk icon.
  45.  
  46.  
  47. Also, you will need to assign SID: to wherever PlaySID V3.0 has been
  48. installed.  The script will make use of the file: "SIDConv" 
  49.  
  50. If AREXX is not currently running, you need to start it.  Go into your
  51. SYSTEM directory of your WB disk and click on "RexxMast".  
  52.  
  53. Open a shell window and type the following:
  54. path sys:rexxc
  55.  
  56. This tells the shell where we will find the RX command (the one used to
  57. execute arexx scripts).
  58.  
  59. Now CD into the directory containing the "ripped" music files.
  60.  
  61. Then enter the following:
  62.  
  63. RX <PathName>:ConvertSID.rexx
  64.  
  65. Where <PathName> is the full path where the ConvertSID.rexx is located
  66. (such as dh0:downloads for example).
  67.  
  68. ============================================================================
  69. WHAT HAPPENS WHEN I EXECUTE THIS SCRIPT?
  70. ============================================================================
  71.  
  72. If you are wondering about your source files, this script WILL NOT 
  73. modify your original files in any way as long as you DO NOT specify
  74. the destination path to be the same as the source path.
  75.  
  76. When you enter the RX command as listed above, you will be prompted for
  77. a destination path for the converted files.  Please remember the rule
  78. mentioned at the beginning of the last section.
  79.  
  80. Once a destination has been entered, it will check to see if the chosen
  81. path exists.  If it does not exist it will ask you if you want to create
  82. that directory.
  83.  
  84. If the directory does exist, then conversion will continue until all
  85. music files have been converted.
  86.  
  87. The script will search out all files ending in ".info".  It will then
  88. merge the two files into one and save it into the specified
  89. destination directory (via the SIDConv command).
  90.  
  91. Upon completion, you will be notified that conversion is done and how
  92. many files were converted.
  93.  
  94. ============================================================================
  95. NOW WHAT?
  96. ============================================================================
  97.  
  98. Now you have a nice directory full of "ripped" sid songs nicely
  99. compacted into one file and easily playable by PlaySID V3.0. 
  100.  
  101. ============================================================================
  102. OK, WHO WROTE THIS WONDERFUL SCRIPT? :-)
  103. ============================================================================
  104.  
  105. This script was written by me, David Poland, a recent graduate from the
  106. University of Kansas in the field of Computer Science.
  107.  
  108. If you have any comments/questions/whatever, mail them to:
  109.  
  110. hawkwind@kuhub.cc.ukans.edu or,
  111. lordj@kuhub.cc.ukans.edu
  112.  
  113. ============================================================================
  114. DISCLAIMER?
  115. ============================================================================
  116.  
  117. The obligatory disclaimer, like you don't know this already.  If your HD
  118. goes nuts and spins so fast it catches fire and burns down your house
  119. its not my fault. :-)  Use or abuse this program as you see fit.
  120.  
  121.