FAQ for the eDonkey Java Controller 1. What is the core ? The core is the eDonkey Command line client. You can get it from http://www.edonkey2000.com/downloads.html. See http://users.aber.ac.uk/tpm01/guihome.html#CORE for up-to-date Linux versions. The Java Controller depends on the core in order to function correctly, so try to get the latest version of the core. 2. How do I run the core ? If you run core and Java Controller on the same machine, the Java Controller will launch the core for you. If you run the core on another machine, you need to "cd" to that directory and type "./donkey - !" on Linux/UNIX/Mac and "donkey - !" on Windows respectively. 3. How do I get started with the Java Controller? Basically, the Java Controller serves
as a front-end to the core (command line client). You can run the core
on one machine and the Java Controller on another machine. Or you can
run both on the same machine. We call the machine on which the core is running the host. If you press the second toolbar button in the Java Controller, you'll see the Manage Host dialog. This dialog allows you manage a list of hosts. You can add localhost (127.0.0.1) to the list, or any other host. Windows users: Windows users are the luckiest ones, since I only test the Java Controller on the Windows platform. You not only get an install program for the Java Controller, but it also contains the least bugs. After you install the winjed2k_x.exe you downloaded, you can click on Start Menu - Program - eDonkey2000 - eDonkey Controller to start the application. Once you get in the application, click on the first button on the toolbar. It will launch the local core and connect to it automatically. Mac users: Since I don't have access to a Mac machine, I can't be very
helpful to you guys. I will try to ask someone to
make an install program for you. For now, if you try to run the core using
"./donkey", you will probably
get "Permission Denied" or some IO exception.
I just found sw0n3 posted very detailed step by step instructions about how to setup on Mac. Here it is: http://forums.edonkey2000.com/phpBB/viewtopic.php?topic=20671&forum=22&23. Please note, the jar name has changed over time. It was ed2k_1.jar when the message was posted. Thanks, sw0n3 ! Linux users: I rarely receive email from Linux users saying they don't know how to get started. Looks like most Linux users are experienced. Check the forums otherwise. 4. How do I make a native language version of the Java Controller ? The Java Controller can display itself in any language if there is a corresponding resource file. Right now, there are five languages supported, they are English, German, Slovenian, Chinese and French. Here are the necessary steps to add your own language:
However, before you start translating, please let me know. There may be other people working on the same translation already. I don't want both of you wasting your time doing the same task. It happened before so please send me email before you start the translation. I found displaying languages with different encoding than English is a little tricky in Java, especially in JDK 1.3. However, JDK 1.4 improved a lot. You may need to try a different theme in the "Look and Feel" tab of "Preference" for the best display result. You may try to set your Windows locale in "Control Panel" - "Regional Options", if you are using an English version of Windows. 5. What is the required JDK version to run the Java Controller ? The Java Controller requires JDK 1.3 and up. It will refuse to start if you are using JDK 1.2 or lower. I developed this program using JDK 1.3.1, so it is the best under JDK 1.3. It works fine under JDK 1.4 with some minor problems. One problem I know is that the ESC key doesn't work in dialogs. However due to the dramatic changes and reimplementation of JDK 1.4 over 1.3, there could be other things I haven't noticed. So if you find any of those problems, feel free to let me know. I am migrating the whole Java Controller to JDK 1.4 in order to use some nice features of the new JDK. But I am not sure how many users are willing to use JDK 1.4. I will wait for a while before I release a version exclusively for JDK 1.4. 6. Can I start donkey.exe as an NT service ? I happened to notice iamdoctorevil posted a message on the eDonkey forums talking about how to start donkey.exe as an NT service. I think it's a pretty good idea so I include the link here. http://forums.edonkey2000.com/phpBB/viewtopic.php?topic=14226&forum=1. 7. How do I enable ed2k links with the Java Controller ? As you know, when you install the eDonkey Windows client, clicking on any ed2k links will start the client automatically and add the file to the download list. Now the Java Controller has the same feature. Below are the steps for enabling it. Please note that enabling this feature for the Java Controller will disable it for the native Windows client. For Windows users:
For Linux users (Thanks, Alexander Dietrich): For the Gnome desktop environment, all you have to do is register a handler for the "ed2k" protocol in the Gnome control center. Open "Document Handlers > URL Handlers" and enter "ed2k" in the protocol field and a suitable handler command in the handler field. In case of the Java Controller the command is java -jar ed2k_x.x.x.jar "%s" Make sure java is either in your path or enter the full path to java. You also need replace ed2k_x.x.x.jar with the full path to the correct Java Controller jar. You need double quotes around %s. It will be replaced by the ed2k link. All browsers that use the Gnome URL handlers will now be able to dispatch ed2k links to the Java Controller. (Note: at the current time, this does not include Mozilla.) For Mozilla, there's no easy way yet to add protocol handlers to Mozilla, but bug 33282 looks promising: http://bugzilla.mozilla.org/show_bug.cgi?id=33282 If you absolutely need it right now, you could try Protozilla, a Mozilla add-on for very flexible protocol handling: For further information, you can refer to Tim-Philipp Müller's Linux GUI development webpage for more details at http://users.aber.ac.uk/tpm01/faq.html#Q23. It may have some updates for this particular issue. The solution, whatever it is, may be written for Linux C GUI only. However it should whenever it invokes a command, change the command to java -jar ed2k_1.1.2.jar <ed2k-link> Expected behavior if ed2k link passing is enabled:
|