Ed2k links handling

2007-08-13T21:42:34Z

193.95.242.55: /* Dirty way */

<center>'''English''' | [[Ed2k_links_handling-de|Deutsch]] | [[Ed2k_links_handling-nl|Nederlands]] | [[Ed2k_links_handling-ko_KR|Korean]]</center>

The way to have [[aMule]] handle your [[ed2k link]]s 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_command|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''.

== Special update for mac users ==
See this [http://forum.amule.org/index.php?topic=5679.0 thread] for an explanation on how to use ed2k-links on Mac.

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

Go to "Start" -> "Run" and run "regedit" (without quotes).

Now, in regedit, go to ''HKEY_LOCAL_MACHINE\SOFTWARE\Classes\ed2k\shell\open\command''

'''NOTE:''' It could happen that ''ed2k'' and/or it's subfolders didn't exist. In such case, create them one-by-one by selecting "New" -> "Key" and entering ''ed2k'' or whatever as it's value.

http://www.amule.org/dev-up/ed2k-win1.jpg

Now just double click on "(Default)" (or "(Standard)" or whatever the first value is there) and enter the path to the ed2k application, followed by ''"%1"'' (with quotes), so you should end with some value like ''C:\Program Files\aMule2\ed2k "%1"''.

http://www.amule.org/dev-up/ed2k-win2.jpg

Finally, do the same in ''HKEY_CLASSES_ROOT\ed2k\shell\open\command''

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

To have ed2k links work from [http://www.konqueror.com Konqueror] you have to add a protocol-file to the directory with the other protocol-files. You can find this directory by searching for file names ending with ''.protocol''. To search run ''`find /usr -name "*.protocol"`'' or ''`find /opt -name "*.protocol"`''. If you're not sure about the directory where KDE is installed you can even put ''/'' as search path.

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].

'''NOTE:''' You might get a security warning. don't worry. it is just warning you that the link is being sent to an external application.

'''NOTE2:''' If after clicking ''OK'' on the security warning the link is still not being sent to [[aMule]], just right-click on the [[ed2k link]] and tell [http://www.konqueror.org Konqueror] to open it in a new window/tab.

== [http://galeon.sourceforge.net Galeon] ==

=== Method 1 ===

In the [http://freshmeat.net/projects/gnomecc GNOME Control Center] go to "Complex" -> "File Types and Programs" -> "Internet Services" -> "Add Service...".

In the protocol filed enter ''ed2k''

In the Program field enter ''ed2k "%s"''

Unselect "Run in terminal" if it is selected.

Click ''OK'' and you're done!

=== Method 2 ===

Execute the following three commands to create the appropriate ''gconf'' keys:
*''gconftool-2 -t string -s /desktop/gnome/url-handlers/ed2k/command "/usr/local/bin/ed2k \"%s\""''
*''gconftool-2 -t bool -s /desktop/gnome/url-handlers/ed2k/enabled true''
*''gconftool-2 -t bool -s /desktop/gnome/url-handlers/ed2k/needs_terminal false''
Replace "''/usr/local/bin/ed2k''" above with the path and name of the ''ed2k'' executable on your system.

Uninstalling this protocol handler is similarly simple:
*''gconftool-2 -u /desktop/gnome/url-handlers/ed2k --recursive-unset''

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

=== Clean way ===

In [http://www.opera.com Opera] go to ''Tools->Preferences->Paths and Programms->Add...''

In the "Protocol" field enter ''ed2k''

In the "Path" or "Open with another application" field enter ''/path/to/ed2k''

http://www.amule.org/dev-up/ed2k-op.jpg

=== Dirty way ===

If the above instructions didn't work, you can try edit ''/etc/opera6rc'' as root or ''~/.opera/opera6.ini'' as non-root and setting:

''[User Prefs]'' 
''TrustedExternalURLProtocols=ed2k'' 
''[Trusted Applications]'' 
''ed2k=ed2k''

=== Opera 6 bug ===

'''[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.

==== [http://www.kernel.org Linux] or some other [http://www.unix.org Unix]-like flavour ====

Create ''amule_submit.sh'' with this content:

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

Now in ''Tools->Preferences->Paths and Programms->Add...->Path'' or in the ''opera6rc'' file change ''ed2k=/path/to/ed2k'' with ''ed2k=/path/to/amule_submit.sh''

==== [http://www.microsoft.com/windows Windows] ====

Create ''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 (or later)==
'''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'' (path to where the file is installed on your system) as '''Value'''.

http://www.amule.org/dev-up/ed2k-ff9.jpg

'''NOTE 1:''' Maybe you have to install "amule-utils" to get this way working with Kubuntu-Linux.

'''NOTE 2:''' Since version 1.5.x of Mozilla Firefox this method doesn't work any longer for the windows version. You must use the Internet Explorer method with the registry entries instead.

== [http://xray.sai.msu.ru/~karpov/links-hacked Links] ==
(Probably this will work for the usual links and/or [[ed2k link|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 link]]s:
''ed2k4links.sh %''

Attention: The Percent Mark is important! Now links should work with [[ed2k link]]s.

== Remotely handling links ==

You can also handle links remotely, which means that you click over an [[ed2k link]] in a browser somewhere in the world and it gets into your home's [[aMule]] queue.

How?

Easy enough: using [[aMuleCMD]] (thanks '''djtm''' for this tip). Instead of using the [[ed2k command]], use the following as the command to use:

''/'''path'''/'''to'''/amulecmd -rh $server -pw $pw -c "Add %u"''

On newer version the command is:

''/'''path'''/'''to'''/amulecmd -h $server -P $pw -c "Add %u"

Obviously, you'll have to replace ''$server'' and ''$pw'' with your server's [[IP]] (or [http://www.webopedia.com/TERM/D/DNS.html DNS]) and your [[External Connections]] password.

Please note that the above tip is only available since [[aMule]] 2.0.0rc8.

'''NOTE 1:''' In [http://www.mozilla.org Firefox], it is not possible to start a command with parameters. An easy solution is a shell script with the command described above. You only have to replace %u with $1. This shell script must be executable (chmod +x ed2k.sh) and defined as external ed2k app in Firefox.

'''NOTE 2:''' If you prefer simple tools, try this shell script (for [http://www.kernel.org Linux]) - can be used with the above mentioned tip:

#!/bin/bash
beep -f 100 -l 40 -r2
(sleep 1; echo dllink $1; sleep 2; echo q;) | nc '''''IP''''' '''''PORT'''''
beep -l 15 -r3

''nc'' is [http://netcat.sourceforge.net Netcat], but you can use telnet too (that's a bit simpler in [http://www.cygwin.com Cygwin]), ''beep'' is a simple program for beeping. ''IP'' and ''PORT'' should be replaced with the [[IP address]] and [[port]] of your remote server. That's it.

***N O T E***
I found the perfect way to do this.

To make FireFox launch ed2k links correctly (in aMule) you have to
follow some simple steps to tell it how to handle a new external
protocol. This should get rid of the dreaded "ed2k is not a registered
protocol" error you were most likely getting before.

* Enter about:config in the address bar.
* Right click on the list, select New, then Boolean; enter
network.protocol-handler.external.ed2k as Preference Name and true as Value
* Now right click, select New and String; enter
network.protocol-handler.app.ed2k as Preference Name and /usr/bin/ed2k:

== Special notes regarding Remotely handling links and Internet Explorer (win32) ==

- Create a file called "ed2k_remote.reg" and insert this lines (ignore the [START CODE] and [END CODE]) and save it:

[START CODE]

REGEDIT4

[HKEY_CLASSES_ROOT\ed2k]
@="URL: ed2k Protocol"
"URL Protocol"=""

[HKEY_CLASSES_ROOT\ed2k\DefaultIcon]
@="C:\\Program Files\\aMule\\amulegui.exe"

[HKEY_CLASSES_ROOT\ed2k\shell]
@="open"

[HKEY_CLASSES_ROOT\ed2k\shell\open]

[HKEY_CLASSES_ROOT\ed2k\shell\open\command]
@="\"C:\\Program Files\\aMule\\ed2k_remote.bat\" \"add %1\""

[END CODE]

- Create a file called "ed2k_remote.bat" and insert this lines (ignore the [START CODE] and [END CODE] and save it:

[START CODE]

"c:\Program Files\aMule\amulecmd.exe" /h REPLACE_WITH_YOUR_HOST_IP_ADDRESS /P REPLACE_WITH_YOUR_PASSWORD /c %1

[END CODE]

PS: don't forget to replace the fields "REPLACE_WITH_YOUR_HOST_IP_ADDRESS" and "REPLACE_WITH_YOUR_PASSWORD" with your data and save the file again.

- Make sure that you did select all options during aMule installation (amulecmd must be installed).

- Copy the files "ed2k_remote.reg" / "ed2k_remote.bat" to the amule installation directory, for example "c:\Program Files\aMule".

- If your Windows isn't English (%ProgramFiles% variable is different that the stated above) edit "ed2k_remote.reg" and change all paths to the correct one. If you don't know what your path is, at a command prompt type "set ProgramFiles" your path will be on screen.

- Double click on "ed2k_remote.reg" file.

- Edit "ed2k_remote.bat" file and insert your Host IP and also your Password (Host IP next to the /h switch and the Password after the /P switch). Don't forget to check/change the "Program Files" directory too.

Test it ;)

Good luck.

FJorgeR.

PS: Pay attention data is case sensetive for amulecmd option switch's.

AMule Project FAQ - User contributions [en]

Ed2k links handling