home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: InfoMgt / InfoMgt.zip / jukemb10.zip / jukebox.txt < prev    next >
Text File  |  1997-05-29  |  5KB  |  156 lines
  1. MaxBase Jukebox!
  2. ----------------
  3.  
  4. What is it? 
  5. -----------
  6.  
  7. This is a MaxBase plugin which implements a 
  8. Jukebox for multimedia files, like MIDI, WAV, 
  9. videos etc. This program is FREEWARE.
  10.  
  11. MaxBase, which is required, is not freeware,
  12. though it is cheap and you can download an 
  13. uncrippled version of it here:
  14. http://www.bmtmicro.com/catalog/mb-web
  15. or even here:
  16. http://www.ososoft.com/RXDBASE.HTM
  17.  
  18. The file size is small, but the program is
  19. smart: it uses GUI, multithreading and IPC.
  20. You gotta love Java. <g>
  21.  
  22.  
  23. Why should I use it?
  24. --------------------
  25.  
  26. Because Jukebox is:
  27.  
  28. 1) Simple to use. The interface isn't cluttered!
  29. 2) Powerful. You have a database engine working
  30.    for you (MaxBase), so you can issue a query
  31.    like "author=aerosm* .&. year=1989", order them
  32.    on title name and have all of the 1989 Aerosmith 
  33.    songs searched for and played. Add a 'score' field
  34.    and only have Jukebox play songs which are cool!
  35.    Also, full NetRexx source code is provided, so you
  36.    can improve the plugin at will. If you do that,
  37.    let me know. Let's build better products, ok?
  38. 3) Consistent. You can use it to play every kind of 
  39.    multimedia file which has a player. Never suffer
  40.    any more from having an under-featured or incredibly
  41.    clumsy to use player for some multimedia formats!
  42. 4) Portable. What about booting your other operating
  43.    system and still being able to use MaxBase and
  44.    jukebox? Or give it to a friend which has a different
  45.    machine/O.S.? Now you can!
  46.  
  47.  
  48. Installation
  49. ------------
  50.  
  51. This zip file has to be unzipped into a MaxBase DB 
  52. folder (usually you create one in OS/2 by drag'n'dropping 
  53. a "NewDB" from the MaxBase folder into the "db_store" 
  54. folder which is also in the MaxBase folder on your WPS). 
  55.  
  56.  
  57. Preparing a DB for jukebox
  58. --------------------------
  59.  
  60. To make it work, just be sure that the DB which is in
  61. the directory this plugin is in, has a field whose name
  62. contains the string "tit" (like title, Title, TITOLO, etc),
  63. and put the file names there.
  64.  
  65. For your convenience I have put here also a NetRexx program
  66. which creates a MaxBase database from a directory listing.
  67. Just type "java dir2dat" from the directory you have stored 
  68. your multimedia files and you're set: a new db called NEWDB.DAT
  69. is created in that directory. Open it with MaxBase, add fields 
  70. at will (e.g. author, type, quality of the composition, etc.) 
  71. and fill them (ok, there is still a lot of work to be done by 
  72. the user, but at least you don't have to type in all the file 
  73. names!)
  74.  
  75.  
  76. Using jukebox
  77. -------------
  78.  
  79. Double click on the DB, select some records and click on
  80. "jukebox" from the main panel. Customize the string to launch
  81. your favorite player and the drive/directory your files are
  82. stored in (there is an entryfield for that in the plugin GUI),
  83. and then listen to the files / view them by hitting "play".
  84. You have some controls like "next", "prev" and "stop" to control
  85. the flow of execution of the playlist.
  86. When you close the plugin, it saves the execution string so the 
  87. next time you won't have to type it again.
  88.  
  89. Warning: OS/2 wants the file names to be given inside quotes if there
  90. is a space in the file name itself (eg. "this is a file"), so if
  91. the plugin sees that there is an open quote somewhere, it will append
  92. a quote automatically. So, don't worry about having an open quote in
  93. the default execution string.
  94.  
  95.  
  96. Execution strings
  97. -----------------
  98.  
  99. The default string is :
  100.  
  101. cmd.exe /c play.cmd FILE="DRIVE:\DIRECTORY\
  102.  
  103. Which will launch the OS/2 default multimedia player.
  104. Use that for any video or audio file which is supported
  105. by OS/2.
  106.  
  107. When you press "start" or click on an item in the playlist,
  108. Jukebox appends the currently selected file name and closes
  109. the quotes (if, like in the example, quotes are present), then
  110. executes the string.
  111.  
  112.  
  113. Other execution strings:
  114. ------------------------
  115.  
  116. I use the following to play my MIDIs, because I have timidity
  117. (the wavetable software emulator) installed:
  118.  
  119. f:\progs\timidos2\timidity.exe -Od1S -idq -L f:\progs\timidos2 "d:\folders\midi\best\
  120.  
  121.  
  122. If you have the mpg123v3 mpeg audio player installed
  123. you can use a string like this:
  124.  
  125. f:\progs\mpg123v3\mpg123.exe -q -b3 "d:\folders\mp3\
  126.  
  127.  
  128. For mod/s3m and other formats, I use muse/2 and this 
  129. is the string I use to launch it:
  130.  
  131. f:\progs\muse2\Muse2Txt.exe -P -o"44k -220% S6" "d:\folders\mod\
  132.  
  133.  
  134. Of course you should customize the strings to meet your needs,
  135. eg. change f:\progs\muse2\ to whatever directory you have put
  136. muse/2 in, and change d:\folders\mod\ to whatever directory you
  137. store your .mod/.s3m etc in.
  138.  
  139.  
  140. Execution string for programs non listed here
  141. ---------------------------------------------
  142.  
  143. Creating them is pretty easy: you should take in mind that Jukebox
  144. will take your string, append a file name and close any quotes (")
  145. that are open (if any), so you can use your favourite player to
  146. play your songs/videos.
  147.  
  148.  
  149. Contact the author in case of questions etc: maxmars@pianeta.it
  150. (Max Marsiglietti, also author of MaxBase).
  151.  
  152. This program is public domain, and it must stay there!
  153. If you enhance it, just let me have a copy of the modified
  154. enhanced version, and I'll put it up on the official MaxBase
  155. site, with proper credits.
  156.