XmmsCaddy Copyright (C) 2002 David Koenig This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA XmmsCaddy 0.3.alpha released 1/27/2001 SECTIONS ->Introduction ->What it is ->Java Client ->Xmms plugin ->Winamp plugin ->Afterword ->Contact This is alpha stage software. It works, but has bugs. It must be treated with care or it will give you the finger. Introduction First, XmmsCaddy came about when I was working at a software company. I shared an office with a fellow programmer. Only one of us had a good set of computer speakers. I had a Linux workstation setup as a secondary machine on my desk. So, I hooked the speakers up to that machine and setup Xmms. My co-work would often ask me to increase the volume or change songs, etc. I thought, well why can't he just do it himself? So, I created the first incarnation, which consisted of a Java client and server, plus a small executable that would make calls to Xmms. This was a very usable solution, but far from optimal. I thought a plugin to Xmms would be a much nicer solution, so that's what I've done. I currently use it to change songs on my main machine while I play Dark Age of Camelot. What the heck is it? Well, it's a client/server suite that allows you to control either Xmms or Wimamp remotely via tcp/ip. It consists of a Java client and both an Xmms plugin and one for Winamp. The full source code to all portions is included. Java Client You need to download the SUN Java jre version 1.2 or greater. You can do so at http://java.sun.com. The only thing you really need to do is make sure that the Java binary is in the system path. There is a batch file called 'run.bat' in the client directory. You will need to edit the ip.txt file with the proper IP address of the server..(ie. machine running xmms or winamp) Xmms Plugin(xmmscaddy) First off, there is no binary xmms plugin included in this package. You need to download the xmms source from http://www.xmms.org. The current vesrion was 1.2.6 when I wrote this. You will need to put the contents of the xmmscaddy directory in xmms-1.2.6/General/xmmscaddy for example... You need to go through the motions of compiling and installing xmms before you can compile the plugin. Once that is done, you can go to the xmms-1.2.6/General/xmmscaddy dir and run 'make' then su to root and run 'make install'. Known bugs(xmmscaddy): After making a few connections/disconnections you will need to restart xmms. There is a bug with the threading that may cause problems. So, keep that in mind. Winamp Plugin(ampcaddy) The Winamp plugin needs a little less care in order to get it up and running. There is a pre-bulit .DLL included.. All you need to do is drop it in your winamp/plugins directory. Known bugs(ampcaddy): There is a nasty 100 cpu usage bug on connection/disconnection. This is occasional. I believe it to be a problem with error handling on socket disconnection. It causes the thread to loop infinitly and very fast. So, it eats up lots of cpu cycles. This only kicks in on the event of a conenction or disconnection. So, keep an eye on that. You will need to restart Winamp when this happens. Afterword Well, I think that's it. I hope you get some use out of it. If you do, let me know. There are bugs. So, this application suite may not act as expected... ironicly.. this is expected as it is alpha grade software. Contact David Koenig dave@rancidmeat.com