docs/ED2K-Links.HOWTO

   1
   2
   3           --------------------------------------------------
   4           How to ED2K Links from your web browser with aMule
   5           --------------------------------------------------
   6
   7
   8  Previous notes
   9 ----------------
  10
  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.
  14
  15   http://wiki.amule.org/index.php/Ed2k_links_handling
  16
  17   You can safely stop reading this document now ;)
  18
  19
  20  Konqueror
  21 -----------
  22
  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.
  27
  28   2. If the first was successful, create a file named something like e2k.protocol in
  29   the mentioned directory:
  30
  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
  42
  43   3. Reload konqueror
  44
  45   (Credits: gfdsa)
  46
  47
  48  Opera
  49 -------
  50
  51   * Opera 6.11
  52
  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.
  55
  56     Create amule_submit.sh with this content:
  57
  58     #!/bin/sh
  59     /usr/local/bin/ed2k "ed2k://$1";
  60
  61     Now edit (as root) /etc/opera6rc or as non-root ~/.opera/opera6.ini:
  62
  63     [Trusted Applications]
  64     ed2k=/usr/local/bin/amule_submit.sh
  65
  66     [User Prefs]
  67     TrustedExternalURLProtocols=ed2k
  68
  69     (Credits: thermoman ( Marcel Meckel ) )
  70
  71   * Opera 7.1 (slightly different from Opera 6)
  72
  73     Edit either /etc/opera6rc or ~/.opera/opera6.ini and add the following:
  74
  75     In [User Prefs]
  76     TrustedExternalURLProtocols=ed2k
  77
  78     In [Trusted Applications]
  79     ed2k=/path/to/ed2k ed2k://%u
  80
  81     (Credits: ender)
  82
  83
  84  Mozilla 1.3+ / FireFox 0.6+
  85 -----------------------------
  86
  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.
  90
  91   2. Restart your browser.
  92
  93   3a. Firefox:  Go to Tools->Preferences->Extensions->Mozex->Options
  94   and add 'ed2k %r' in the ED2K box.
  95
  96   3b. Mozilla: Go to Edit->Preferences->Mozex and add 'ed2k %r' in
  97   the ED2K box.
  98
  99  Mozilla before v1.3 / Firefox before v0.6
 100 -------------------------------------------
 101
 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.
 106
 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)
 115
 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
 119
 120   As root do:
 121   cp -r /root/.mozilla/PROFILENAME/RANDOM.slt/protozilla/
 122   /home/USERNAME/.mozilla/PROFILENAME2/RANDOM.slt/"
 123
 124   Copy protozilla-configuration from root's home to user's home.
 125
 126   cd /home/USERNAME/.mozilla/PROFILENAME/RANDOM.slt/
 127   chown -R YOURUSER.YOURGROUP protozilla"
 128
 129   cd to user's mozilla config-dir and change file-ownership parameters.
 130
 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
 136
 137   3) Setup a protocol-handler for ed2k-links:
 138
 139   cd to ~/.mozilla/PROFILENAME/RANDOM.slt/protozilla/protocol
 140
 141   Create a file called "ed2k.cmd" with the following content:
 142
 143   ed2k ed2k:$URI_DATA
 144
 145   Do this with your favorite text-editor, the file doesn't have to be executable
 146
 147   Now restart mozilla, and everything should work.
 148
 149   (Credits: R. Pokorny aka rpokorny )
 150
 151
 152  Other browsers / More help
 153 ----------------------------
 154
 155   Please visit http://wiki.amule.org/index.php/Ed2k_links_handling