Upstream tarball 20080721
[amule.git] / docs / ED2K-Links.HOWTO
blobac56d0eb4720047c24a5f813ca8a3f12ff8b2c0e
3           --------------------------------------------------
4           How to ED2K Links from your web browser with aMule
5           --------------------------------------------------
8  Previous notes
9 ----------------
11   This text file is old and discontinued.
12   This howto is now online in our wiki so please visit it
13   instead of this document.
15   http://www.amule.org/wiki/index.php/Ed2k_links_handling
17   You can safely stop reading this document now ;)
20  Konqueror
21 -----------
23   1. /usr/kde/3.1/share/services
24   You can find it by file names ended with .protocol
25   Somethign like `find /usr -name "*.protocol"` or `find /opt -name "*.protocol"`
26   or even put / to path if you want.
28   2. If the first was successful, create a file named something like e2k.protocol in
29   the mentioned directory:
31   [Protocol]
32   exec=/usr/local/bin/ed2k "%u"
33   protocol=ed2k
34   input=none
35   output=none
36   helper=true
37   listing=false
38   reading=false
39   writing=false
40   makedir=false
41   deleting=false
43   3. Reload konqueror
45   (Credits: gfdsa)
48  Opera
49 -------
51   * Opera 6.11
53     First of all: Opera 6.11 doesn't pass complete URL to external programs - only URL
54     without protocol. don't know wheather this behaviour has changed in later releases.
56     Create amule_submit.sh with this content:
58     #!/bin/sh
59     /usr/local/bin/ed2k "ed2k://$1";
61     Now edit (as root) /etc/opera6rc or as non-root ~/.opera/opera6.ini:
63     [Trusted Applications]
64     ed2k=/usr/local/bin/amule_submit.sh
66     [User Prefs]
67     TrustedExternalURLProtocols=ed2k
69     (Credits: thermoman ( Marcel Meckel ) )
71   * Opera 7.1 (slightly different from Opera 6)
73     Edit either /etc/opera6rc or ~/.opera/opera6.ini and add the following:
75     In [User Prefs]
76     TrustedExternalURLProtocols=ed2k
78     In [Trusted Applications]
79     ed2k=/path/to/ed2k ed2k://%u 
81     (Credits: ender)
84  Mozilla 1.3+ / FireFox 0.6+
85 -----------------------------
87   1. Go to http://mozex.mozdev.org/installation.html and click the
88   install link. This will automatically install Mozex plugin for
89   your browser.
91   2. Restart your browser.
93   3a. Firefox:  Go to Tools->Preferences->Extensions->Mozex->Options
94   and add 'ed2k %r' in the ED2K box.
96   3b. Mozilla: Go to Edit->Preferences->Mozex and add 'ed2k %r' in
97   the ED2K box.
99  Mozilla before v1.3 / Firefox before v0.6
100 -------------------------------------------
102   1) Go to http://protozilla.mozdev.org/download.html
103   Choose the version fitting your mozilla-version and click
104   on "install". It will auto-install protozilla.
105   Now close mozilla completely.
107   Notes:
108   - You must have write permission to the mozilla-installation-directory
109     for this. If you've installed mozilla to /usr , you'll have to be
110     root probably.
111   - The downloadable precompiled version of protozilla apparently does
112     _not_ work with debian mozilla packages. It _does_ work together
113     with the precompiled version of 1.2.1 available at mozilla.org for
114     example (or you can build both mozilla and protozilla yourself)
116   2) This step is only necessary if you had to start mozilla as root in
117   step 1). If you did step 1) with the same user as you normally use,
118   you can skip it
120   As root do:
121   cp -r /root/.mozilla/PROFILENAME/RANDOM.slt/protozilla/
122   /home/USERNAME/.mozilla/PROFILENAME2/RANDOM.slt/"
124   Copy protozilla-configuration from root's home to user's home.
126   cd /home/USERNAME/.mozilla/PROFILENAME/RANDOM.slt/
127   chown -R YOURUSER.YOURGROUP protozilla"
129   cd to user's mozilla config-dir and change file-ownership parameters.
131   Note:
132   USERNAME: name of your normal, non-root user
133   PROFILENAME: name of the profile you'll want to use
134   RANDOM: random alphanumeric string, autogenerated by mozilla
135   YOURUSER, YOURGROUP: user and group of your normal user
137   3) Setup a protocol-handler for ed2k-links:
139   cd to ~/.mozilla/PROFILENAME/RANDOM.slt/protozilla/protocol
141   Create a file called "ed2k.cmd" with the following content:
143   ed2k ed2k:$URI_DATA
145   Do this with your favorite text-editor, the file doesn't have to be executable
147   Now restart mozilla, and everything should work.
149   (Credits: R. Pokorny aka rpokorny )
152  Other browsers / More help
153 ----------------------------
155   Please visit http://www.amule.org/wiki/index.php/Ed2k_links_handling