home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / tc123.zip / readme.os2 < prev    next >
Text File  |  1999-04-03  |  4KB  |  89 lines
  1. Total Control 123(tc123) for OS/2, version 1.0.1-RELEASE.
  2. Written by Death Syndrome, with assitance from dink.
  3. This software is released under the GNU General Public License,
  4. version 2 or newer.  See COPYING for more details.
  5. This application does REQUIRE the emx runtime 0.9c or newer to function.
  6.  
  7. ***CHANGES:
  8. 1.0.1-RELEASE 04-03-99: 1.01-CURRENT with different version string.
  9. 1.01-CURRENT  03-18-99: This version is released to provide support for
  10.                             changes in z! v2.4b9.2 and later's rawinfo
  11.                             structure.
  12.  
  13. Acknowledgements:
  14. Many thanks go to dink for assistance on this code.
  15. OS/2 is copyright IBM Corporation, and is a registered trademark.
  16. z! is Copyright 1997-1999 dink.
  17. PM123 is copyright 1997-1998 Taneli Leppä / Samuel Audet.
  18. Many thanks to Eberhard Mattes for making emx!  Who needs a commercial
  19. compiler?  I've got gcc!!
  20.  
  21. Background:
  22. tc123 is an interface for named-pipe enabled mp3 players to your ircII
  23. compatible client.  This interface has been tested with OpenChat/2,
  24. ircII/OS2, PMBichx-75p1, and a beta port of ircII-EPIC3.004 for OS/2.
  25. Hopefully, bugs have been shaken out of this release, but see the end
  26. of COPYING for warranty details.  This application is designed to
  27. interface primarily with dink's z! MP3 player, version 2.4 and later.
  28. It also happens to function under Taneli's PM123, but is not optimized
  29. for such.  The aim of this application is to be able to totally control
  30. the MP3 player entirely from the console of the irc client.  Feel free
  31. to submit bug reports to deathsyn@yahoo.com.
  32.  
  33. Use:
  34. The easiest way to get started with tc123, unpacking the distribution
  35. package into the directory in which your ircII-compatible client resides.
  36. Next, if you're running a mp3 player other than z!(such as pm123), modify
  37. tc123.irc(bx) and change the value in the brackets of the player variable
  38. to the name of the named pipe used by your player.  PM123's pipe is pm123.
  39. Then, run your irc client in the normal manner.  Once the client is up,
  40. type the following into the console:
  41.  
  42. /load tc123.irc
  43.  
  44. (BitchX users, replace "irc" with "bx".  Currently, the only difference
  45. is the modification of the BX version string.  Future BX specific
  46. enhancements should occur, though.)
  47.  
  48. After doing the above, you should see something like this:
  49.  
  50. [tc123] Total Control 123 is loaded.
  51.  
  52. After that, you can now manipulate the player from your irc client.  With
  53. the player running, try the following:
  54.  
  55. /np
  56.  
  57. This should check what the player is playing, and broadcast it to the
  58. current channel, as well as on the console.
  59.  
  60. Other status type commands work in a similar manner.  These are /songinfo,
  61. /file, and /rawinfo.  Rawinfo doesn't broadcast to the channel, as its
  62. information is verbose enough to annoy many others.  /lnp, /lsonginfo, and
  63. /lfile are the same as their 'l'-less brethern, except they only give
  64. their information to the 'l'ocal console.
  65.  
  66. Now, for the control commands:
  67.  
  68. /play  -  tells the player to start playing the current playlist/file.
  69. /stop  -  tells player to stop playing the playlist.
  70. /pause -  pause play of current file at current posititon.  Do it again to
  71.           resume play.  PM123 will die on this command, as implemented.
  72.           If you don't like this, switch to z!, or write replacement code.
  73. /next  -  Move to next file in playlist.
  74. /prev  -  Move to previous file in the playlist.
  75. /shuffle -  Shuffles currently playing list.  Not sure if this works in z!
  76. /tcquit  -  Tells the player to diediedie.
  77. /tcver  -  Just a bit of self-absorbed pride.  Shows your friends how lame
  78.            you/they are.
  79.  
  80. That's it for now.  I plan on adding new stuff based upon feedback I get
  81. from this release, as well as whatever else I find I need.  This code is
  82. basically the same as the last .8bx edition, for those who wonder.  BTW,
  83. tchelper.exe has many other uses.  Run tchelper -? for information.  A few
  84. applications for this could be for email sigs, wacky shell scripts, etc.
  85.  
  86. Greets to #os2*(you know who you are), and specifically to dink, SpaceRat,
  87. |tSS|, and sehh, who were instrumental in making this thing as bug-free as
  88. it is.
  89.