X-JukeBox Project HomePage

X-JukeBox 0.4.x

(c)2001-2002 Xavier Fuentes

What is X-JukeBox?

X-JukeBox is an advanced C plugin for X-Chat, making it easier to download and share mp3's and other files types on IRC networks.

Features:

• Serving Files, commands understood: @mynick, @mynick-que, @mynick-stats, @find, @locator, !mynick filename, @mynick-remove [filename]
• Automatic Downloading files from multiple servers: you select files you want from servers and they will be downloaded for you, transfert problems are detected and incomplete download will be resumed.
• File List is updated automatically, using ID3 infos from MP3 files.
• Advertising on channels of you choice.



Installation

For current versions of X-Chat (2.4.7), building a C plugin is a little tricky. The plugin needs to be built using X-Chat sources configured the same way as your binary version of X-Chat. For example you can't load the plugin in a X-Chat binary built with SSL support if the plugin was built with X-Chat sources configured without SSL.
The easiest way would be to get X-Chat sources, configure build and install them, and use this source directory to build the plugin.

From here I will assume you have X-JukeBox sources untared somewhere, and you have X-Chat sources configured the same way as the binary version.

YOU DON'T NEED TO BE ROOT, I recommand using the same user that you run X-Chat for all the build and installation process.

Enter in X-JukeBox sources directory.
ie: cd xjukebox-0.4.1

Now we will configure the sources, we need to provide X-Chat sources directory in absolute form (do not use ../).
ie: ./configure --with-xchat=/home/furax/src/xchat-1.8.7

If configuration step was OK, building the sources:
ie: make

After this you can install the plugin, (it will be installed for the user who run this command)
ie: make install

X-JukeBox.so is now in your ~/.xchat/ directory.
If all went good, you should see a message saying X-JukeBox was loaded the next time you run X-Chat.



Sharing files

There is 2 way for configuring X-Jukebox, the command line version and the GTK+ dialog version. I will explain here the command line version, as dialog version is quite intuitive but not finished yet.

First you have to set your nickname, this will be used to generate your file list and to answer user's requests.
ie: /xjb set nick furax
You can list all global variables with "/xjb set".
To serve in #deathmp3, you have to add it to the channel list with "/xjb add #deathmp3".
We now need to add our directory with "/xjb add #deathmp3 dir /Furax/Extreme Metal" and to allow downloading of mp3 files "/xjb add #deathmp3 ext *.mp3".
Now type "/xjb list update", and the plugin will update your lists for channel where you are serving. Note that this command can be used when you add or remove files to have a list up-to-date.
Lets add a small advertising to let people know we are serving "/xjb set #deathmp3 advertise 1" with a small personalised text "/xjb set #deathmp3 title Extreme Metal Server".

Thats all folks, you are now serving on #deathmp3 !!

Auto-Downloading

This is working quite well but is quite borring to configure this with commands. I will provide some help when GTK+ version will be ready.


Authors

• Xavier Fuentes (furax at vaginal-skin.com)

If you want to contribute on something let me know.