Ed2k links handling

2004-10-30T22:50:29Z

217.234.123.184: Added instructions for links-hacked (and presumably other links versions, too) Greetings from Alex <alex@22-music.de>

The way to have [[aMule]] handle your [[ed2k links]] on your favorite WebBrowser will depend on which WebBrowser you use. So, here's a list of mini-HowTos for each of the most popular WebBrowsers.
Have in mind that everywhere on this document, ''/path/to/ed2k'' should be replaced with ''/usr/local/bin/ed2k'', ''/usr/bin/ed2k'', ''C:\Program Files\aMule\ed2k.exe'' or whatever, depending on your own system's configuration.

As a general idea, in most [http://www.kernel.org Linux] systems, self-compiled [[aMule]]s will install the [[FAQ_ed2k|ed2k]] utility in ''/usr/local/bin/ed2k'', while package-installed [[aMule]]s will install it in ''/usr/bin/ed2k''. As an exception, it is known that [http://www.suse.com SuSE] packages install it in ''/usr/local/bin/ed2k''.

== [http://www.microsoft.com/windows/ie Internet Explorer] ==
'''by ''[[User:Jacobo221|Jacobo221]]'''''

Go to "Start" -> "Run" and run "regedit" (without quotes).
Now, in regedit, get to ''HKEY_LOCAL_MACHINE\SOFTWARE\Classes\ed2k\shell\open'' 
It could happen that ''ed2k'' didn't exist. In such case, create it by selecting "New" -> "Key" and entering ''ed2k'' as value. Then do the same with ''shell'' and ''open''. 
Once inside the ''open'' key, if ''command'' exists, just double click on it, but if it doesn't, go to "New" -> "Value" and enter the path to the ed2k application as an ASCII string value, followed by ''"%1"'' (with quotes), so you should end with some value like ''C:\Program Files\aMule2\ed2k "%1"''.

== [http://www.konqueror.org Konqueror] ==
'''by ''gfdsa'''''

''/usr/kde/3.1/share/services'' you can find it by file names ended with ''.protocol'' kinda ''`find /usr -name "*.protocol"`'' or ''`find /opt -name "*.protocol"`'' or even put ''/'' to path if you want.

If the search was successful, create a file named like ''ed2k.protocol'' in
the mentioned directory:

<code>[Protocol] 
exec=/path/to/ed2k "%u" 
protocol=ed2k 
input=none 
output=none 
helper=true 
listing=false 
reading=false 
writing=false 
makedir=false 
deleting=false</code>

Now just restart [http://www.konqueror.org Konqueror].

== [http://www.opera.com Opera] ==
'''by ''thermoman [Marcel Meckel]'', ''ender'' and ''[[User:Jacobo221|Jacobo221]]''

Edit ''/etc/opera6rc'' as root or ''~/.opera/opera6.ini'' as non-root:

<code>[User Prefs] 
TrustedExternalURLProtocols=ed2k

[Trusted Applications] 
ed2k=/path/to/ed2k ed2k://%u</code>

Or an easier way: 
open ''Tools->Preferences->Paths and Programms->Add...'' 
protocol = ed2k 
choose the path: ''/path/to/ed2k''

'''[http://www.opera.com Opera] 6''' doesn't pass complete URL to external programs; only URL without protocol. The way to walk around this follows.

In [http://www.kernel.org Linux] or some other Unix-like flavour 
Create ''amule_submit.sh'' with this content:

<code>#!/bin/sh 
/path/to/ed2k "ed2k://$1"</code>

Change ''ed2k=/path/to/ed2k ed2k://%u'' with ''ed2k=/path/to/amule_submit.sh ed2k://%u''

In Windows systems 
Crate ''amule_submit.bat'' with this content:

''X:\path\to\ed2k.exe "ed2k://%1"''

Change ''ed2k=/path/to/ed2k ed2k://%u'' with ''ed2k=X:\path\to\amule_submit.bat ed2k://%u''

== [http://www.mozilla.org Mozilla] 1.7 (or later) & [http://www.mozilla.org/products/firefox Firefox] 0.9 ==
'''by ''GhePeU'''''

Mozex doesn't work anymore with [http://www.mozilla.org Mozilla] 1.7 and [http://www.mozilla.org/products/firefox Firefox] 0.9. There is an alternate method that seems to be working with both of them:

*Remove [http://mozex.mozdev.org/installation.html MozEx] if installed or at least remove the ed2k input from it (only if [http://mozex.mozdev.org/installation.html MozEx] is installed)

*Insert ''about:config'' in the address bar

*Right click on the list, select '''New''', then '''Boolean'''; insert ''network.protocol-handler.external.ed2k'' as '''Preference Name''' and ''true'' as '''Value'''

*Now another right click, select '''New''' and '''String'''; insert ''network.protocol-handler.app.ed2k'' as '''Preference Name''' and ''/path/to/ed2k'' (or path to where the file is installed on you system) as '''Value'''.

== [http://www.mozilla.org Mozilla] 1.3 to 1.6 & [http://www.mozilla.org/products/firefox Firebird] v0.6 & [http://www.mozilla.org/products/firefox Firefox] v0.8 ==
'''by ''DeltaHF'''''

Go to [http://mozex.mozdev.org/installation.html MozEx's WebPage] and install the ''mozex-1.07.xpi'' file. 
Restart your [http://www.mozilla.org Mozilla]/[http://www.mozilla.org/products/firefox FireBird]/[http://www.mozilla.org/products/firefox FireFox], go to Edit -> Preferences -> mozex -> ED2K and set it to ''/path/to/ed2k %r'' 
Click '''OK''' and you're done.

Note for Firefox 0.8 users 
Instead of Edit -> Preferences -> mozex -> ED2K, you'll find [http://mozex.mozdev.org/installation.html MozEx]'s preferences at Edit -> Preferences -> Extensions -> mozex -> Options -> ED2K

== [http://www.mozilla.org Mozilla] 1.2.1 or earlier ==
'''by ''rpokorny [R. Pokorny]'''''

1) Go to [http://protozilla.mozdev.org/download.html Protozilla's WebPage] 
Choose the version fitting your [http://www.mozilla.org Mozilla]-version and click on '''Install'''. It will auto-install [http://protozilla.mozdev.org Protozilla]. 
Now close [http://www.mozilla.org Mozilla] completely.

Notes for [http://www.kernel.org Linux] and other Unix-like systems users 
- You must have write permission to the [http://www.mozilla.org Mozilla] installation directory. If you've installed [http://www.mozilla.org Mozilla] in ''/usr'', you'll have to be '''root''' probably. 
- The downloadable precompiled version of [http://protozilla.mozdev.org Protozilla] apparently does '''not''' work with [http://www.debian.org Debian]'s [http://www.mozilla.org Mozilla] packages. It '''does''' work together with the precompiled version of 1.2.1 available at [http://www.mozilla.org Mozilla's WebPage] for example (or you can build both [http://www.mozilla.org Mozilla] and [http://protozilla.mozdev.org Protozilla] yourself).

2) This step is only necessary if you had to start [http://www.mozilla.org Mozilla]/[http://www.mozilla.org/products/firefox FireBird]/[http://www.mozilla.org/products/firefox FireFox] as '''root''' in step 1.

As '''root''' do:
''cp -r /root/.mozilla/PROFILENAME/RANDOM.slt/protozilla/ /home/USERNAME/.mozilla/PROFILENAME2/RANDOM.slt/''

This will have copied protozilla-configuration from root's home directory to user's home directory.

''cd /home/USERNAME/.mozilla/PROFILENAME/RANDOM.slt/
chown -R YOURUSER.YOURGROUP protozilla''

This will have changed file-ownership parameters in user's files.

Note: 
'''USERNAME:''' Name of your normal, non-root user. 
'''PROFILENAME:''' Name of the profile you'll want to use. 
'''RANDOM:''' Random alphanumeric string, autogenerated by mozilla. 
'''YOURUSER, YOURGROUP:''' User and group of your normal user. 

3) Setup a protocol-handler for [[ed2k links]]: 
''cd ~/.mozilla/PROFILENAME/RANDOM.slt/protozilla/protocol''

create a file called ''ed2k.cmd'' with the following content:

''ed2k ed2k:$URI_DATA''

(The file doesn't need to be executable).

Now restart [http://www.mozilla.org Mozilla].

== [http://xray.sai.msu.ru/~karpov/links-hacked/ links-hacked*] ==
(* probably this will work for the usual links and/or elinks, too)

add to url.c behind the lines about telnet and tn3270:
--snip
{"ed2k", 0, NULL, ed2k_func, 0, 0, 0},
--snap

add to links.h behind the definitions of /* mailto.c */:
--snip
void ed2k_func(struct session *, unsigned char *);
--snap

add to mailto.c at the end:
--snip
void ed2k_func(struct session *ses, unsigned char *url)
{
tn_func(ses, url, options_get("network_program_ed2k"), TEXT(T_ED2K), TEXT(T_BAD_ED2K_URL));
}
--snap

add to options_register.c behind telnet and tn3270:
--snip
register_option_char("network_program_ed2k", TEXT(T_ED2K_PROG),NULL,2);
--snap

add to intl/*.lng behind
"T_TN3270_PROG": T_ED2K_PROG, "ed2k program", (or whatever that is in your language), behind
"T_TN3270": T_ED2K, "ed2k", and behind
"T_BAD_TN3270_URL": T_BAD_ED2K_URL (I guess you've got the picture)

If you want to automatize this stuff, execute the following commands:
cd intl
for l in *.lng; do
cp $l $l.bak
cat $l.bak | sed -e "/T_TN3270_PROG*/aT_ED2K_PROG\, \"ed2k program\"\," \
-e "/T_TN3270,\ */aT_ED2K\, \"ed2k\"\," \
-e "/T_BAD_TN3270_URL*/aT_BAD_ED2K_URL\, \"Bad ed2k url\"\," > $l
done

Anyway, run afterwards before recompiling links-hacked:
./synclang
cd ..

Now you can compile with
./configure (add your favourite options here) &&
make &&
make install

Because links somewhat malforms the urls, we need a small bash script handler:
cat > /usr/bin/ed2k4links.sh << "EOF"
#!/bin/bash
ed2k $(echo "ed2k://$1" | sed s/_/\|/g)
EOF
chmod a+x /usr/bin/ed2k4links.sh

Do not forget to setup links (Options->Network Options->Mail and Telnet Programs) to call our ed2k4links.sh for ed2k links:
ed2k4links.sh %

Attention: The Percent Mark is important! Now links should work with ed2k links.

== More information ==

If the above information didn't help you enough, take a look at [http://www.amule.org/amule/ed2k.php http://www.amule.org/amule/ed2k.php]

AMule Project FAQ - User contributions [en]

Ed2k links handling