home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 19 / AACD19.BIN / CDTools / Players / HippoPlayer / ARexx / HippoPlay.filer.doc < prev    next >
Text File  |  1994-05-27  |  8KB  |  193 lines
  1.  
  2.                              HippoPlay.filer
  3.                              ===============
  4.  
  5. HippoPlay.filer is an ARexx script for Filer, the file management program.
  6. Simply, it plays all selected files with HiP, but it also has a couple
  7. of nice features which make it more fun to use, like randomplying the
  8. contents of a selected directory or playing a mod by double-clicking it.
  9.  
  10. It should be possible to make this script work with DirOpus etc. instead
  11. of Filer. If you wish to do so and have problems (the code IS a mess:),
  12. contact me (see address at the end of this file).
  13.  
  14. This script is freeware, you can do anything you please with it. However,
  15. don't blame me if it mutates into a deadly hardcore virus and remixes
  16. all your modules as if they were abused by a gang of brainless techno
  17. freeks using an IBM 286 without a soundcard, that's YOUR problem, dude...
  18.  
  19.  
  20.                               Requirements
  21.                               ------------
  22.  
  23. Filer, HippoPlayer, ARexx and _rexxsupport.library_ should be enough.
  24. A couple of modules won't hurt, though... If you have lost your
  25. rexxsupport.library, all is not lost - just delete the ADDLIB-line from
  26. the script and off you go, but you wont be able to select directories.
  27.  
  28.  
  29.                               Installation
  30.                               ------------
  31.  
  32. First edit the script a little (sorry, but you really have to!). Change
  33. the first line of code after the comments, the one that says
  34.  
  35. HippoPath = 'dh2:Hippoplayer/HiP'
  36.  
  37. Yes, you guessed it, just replace the path with the one you use.
  38. After that, copy the script to the place you keep your Filer-scripts,
  39. usually REXX:. Then add a new button into Filer (Prefs-menu), and type
  40.  
  41. "RX Hippoplay.filer"
  42.  
  43. as the command. Save prefs, and you're ready to go!
  44.  
  45. *NEW in v1.2!*
  46. If you want to get mods playing by double-clicking them then you'll
  47. want to do this:
  48. Edit Filer's configuration file, S:Filer.RC, and add the following line
  49. in the end:
  50.  
  51. CLASS "(mod|MED|S3M).#?","","RX HippoPlay.filer %f"
  52.  
  53. Of course if you have mod names like "JesusLovesU.mod" instead of
  54. "mod.JesusLovesU" then you need to do this instead:
  55.  
  56. CLASS "#?.mod","",RX HippoPlay.filer %f"
  57.  
  58. Feel free to add as many filetypes (XM|MON|OK|FAST|...) as you have/like,
  59. just check that Hip can actually play them..
  60.  
  61.  
  62. You might also want to change HiP's prefs so that it opens on FilerScreen
  63. instead of Workbench, though the script forces HiP on FilerScreen anyway.
  64. And while you're at it, zip HiP with your right mouse button and position
  65. the titlebar to the upper left hand corner of FilerScreen, then save
  66. HiP's prefs. This way HiP will show up nicely zipped next time, as if it was
  67. always meant to be a part of Filer :)
  68.  
  69. There are also some extra things in the configuration part of the ARexx-
  70. script that you can edit to your liking, see "Bonus Stuff" below.
  71.  
  72.  
  73.                                  Usage
  74.                                  -----
  75.  
  76. *NEW in v1.2!* To play a mod which has a name that identifies it as a
  77. module, for example "mod.Nyponsoppa" then just double-click it and Njoy!
  78.  
  79. Use Filer to select all the mods you want to play and hit the play
  80. button. That causes the following actions to take place:
  81.  1) If HiP is not loaded, it will be loaded
  82.  2) The playlist is cleared (if files were selected)
  83.  3) All selected files are added into the playlist
  84.  4) HiP starts randomplaying the modules
  85.  
  86. Note that you can also select directories! They will be scanned recursively
  87. and all files in them will be added to playlist. So if you want HiP to
  88. randomplay ALL your modules, just select your module directory and
  89. press play...
  90.  
  91. If no files were selected then we ask HiP the name of the currently
  92. playing module and display it on Filer's statusbar (unless you enable
  93. RandomPlay, see Bonus Stuff) unless there is only one module in the list,
  94. in which case we eject it (emulating a stop button).
  95.  
  96.  
  97.  
  98.                                 Bonus Stuff
  99.                                 -----------
  100.  
  101. 1) Making Filer tell you the composer of the module
  102.  
  103.  I have the habit of putting the composer's name in the filenote, so of
  104.  course I made use of it in this script. Example: module "mod.IWantYou"
  105.  is done by "Superted of Grostesticle and Suspiria" (the filenote).
  106.  So when I select that module and hit play, the mod starts playing AND
  107.  the status line of Filer says:
  108.  
  109.  'HiP: Playing "mod.IWantYou" by Superted of Grostesticle and Suspiria'
  110.  
  111.  This way I don't have to remember the composer myself...
  112.  
  113.  If you don't like that idea, don't panic, because if the script sees that
  114.  the comment is empty, it just says what kind of a module it is, and
  115.  how big it is. If you don't like that either, just edit the CONFIGURATION
  116.  part of the script (it is at the beginning), change "Verbose" to "0".
  117.  This way you'll only get to know the name of the module, nothing more.
  118.  
  119. 2) Checking filenames for unwanted filetypes
  120.  
  121.  If you have icons lying around in your module directory you naturally
  122.  don't want HiP to try to play them. And if you have readme's for your mods,
  123.  they shouldn't be played either. If that's the case, here's what you do:
  124.  
  125.   - check the CONFIGURATION part of the script, it's at the beginning.
  126.   - change "CheckFileNames" to "1" instead of "0", this activates
  127.       filename checking.
  128.   - below that you see a list of unwanted suffixes and prefixes, edit
  129.       them to suit your taste.
  130.   - save the modified script and try it!
  131.  
  132.  Now if you select icons or readmes, the script simply ignores them, as
  133.  it should. Note, however, that checking makes the script considerably
  134.  slower, so if you're in a hurry, keep this feature disabled (default),
  135.  or at least keep the number of prefixes/suffixes as low as possible.
  136.  
  137. 3) Controlling what the script does when nothing is selected
  138.  
  139.  Normally when you just push the Play button on Filer without selecting
  140.  anything first this script prints out info about currently playing
  141.  module, which is useful when you for example have hidden HiP's window.
  142.  An alternative to this behaviour is making the button act like a random
  143.  play button, thus forcing HiP to jump to next random module. If you
  144.  prefer this feature, then just activate it in the CONFIGURATION part
  145.  of the script. As always, if there's only one mod in playlist we won't
  146.  random play it, but instead we eject it.
  147.  
  148.  
  149.                                 Known bugs
  150.                                 ----------
  151.  
  152. I use this script all the time and it seems to work with my plain vanilla
  153. A1200 HD. Don't know how the rexxsupport.library function ShowDir() works
  154. in exotic filesystems though.
  155.  
  156. - Filer doesn't seem to react to control-c, so you can't break the script
  157. from Filer! :(  It might take a little patience to wait if you accidentally
  158. began loading a diskful of chip-tunes, so don't...
  159.  
  160.  
  161.  
  162.                               Contact address
  163.                               ---------------
  164.  
  165. If you find any bugs or have suggestions or anything, don't hesitate to
  166. contact me:
  167.  
  168. Janne Simonen           - jsimonen@cc.joensuu.fi
  169. Merimiehenkatu 44 A 8
  170. FIN-80100 JOENSUU
  171. FINLAND
  172.  
  173. Especially if you put a mod or two in your letter I promise to seriously
  174. consider implementing any features you have in mind!
  175.  
  176. Anyways, I hope this piece of code will help you get even more fun out of
  177. HippoPlayer, the heavyweight mod player champ! :)
  178.  
  179.  
  180.                                 History
  181.                                 -------
  182.  
  183. pre-1.0 versions were not released because of my perfectionism...
  184.  
  185. v 1.0 - the first released version, added filename checking and
  186.         configuration part to the script. Can't think of anything
  187.         more to add, maybe it's perfect? Yeah, right! :)
  188.         Suggestions, anyone?
  189.  
  190.   1.1 - double-click added, not released.
  191.  
  192.   1.2 - support for double-clicking of files completed.
  193.