AMule Project FAQ - User contributions [en]

HowTo compile on Win32 with MinGW

2008-02-19T19:31:10Z

Xaignar:

<center>'''English''' | [[HowTo compile on Win32-de|German]] | [[HowTo compile on Win32-fr|French]]</center>

This wiki page only covers the latest [[aMule_CVS|CVS]] version of [[aMule]], not releases in the 1.x.x or 2.x.x branches.

''For those of you that don't want to compile [[aMule]] from source, there is also the option of the [[Win32_binary|aMule Windows Installer]].''

== Requirements for compiling [[aMule]] ==

You will need the following packages:

*[http://www.microsoft.com/windows Windows] port of [http://gcc.gnu.org GNU C compiler], [http://www.mingw.org MinGW] -> [http://prdownloads.sourceforge.net/mingw/MinGW-5.1.3.exe?download Download (5.1.3)]
*Minimal [http://www.gnu.org GNU] shell for [http://www.microsoft.com/windows Windows], [http://www.mingw.org/msys.shtml MSys] -> [http://prdownloads.sf.net/mingw/MSYS-1.0.10.exe?download Download (1.0.10)]
*Developer toolkit for [http://www.mingw.org/msys.shtml MSys] (for [http://www.gnu.org/software/cvs CVS] & co) -> [http://prdownloads.sf.net/mingw/msysDTK-1.0.1.exe?download Download (1.0.1)]
*[http://www.gnu.org/software/libiconv LibIConv] (required by [http://www.gnu.org/software/gettext gettext]) -> [http://prdownloads.sf.net/mingw/libiconv-1.8.0-2003.02.01-1.exe?download Download (1.8)]
*[http://www.gnu.org/software/gettext GetText] (for [http://www.gnu.org/software/gettext po files], [http://www.gnu.org/software/automake/automake.html autogen.sh], etc) -> [http://prdownloads.sf.net/mingw/gettext-0.11.5-2003.02.01-1.exe?download Download (0.11.5)]
*[http://www.zlib.org zlib] compression library -> [http://www.zlib.net/zlib-1.2.3.tar.gz Download (1.2.3)]
*[http://www.microsoft.com/windows Windows] port of [[wxWidgets]] library (knows as [[wxWidgets|wxMSW]]) -> [http://prdownloads.sourceforge.net/wxwindows/wxMSW-2.6.1.zip Download (2.6.1)]
* [http://www.cryptopp.com/ Crypto++] library -> [http://prdownloads.sourceforge.net/cryptopp/cryptopp552.zip Download(5.5.2)]
*[[aMule]]'s latest release sources or [[aMule CVS]] -> [http://www.hirnriss.net/?area=cvs Download aMule]

Also, 800MB-1500MB free space on your hard disk (around 40MB to download the above packages and the rest for temporary compilation files and installations. The amount of space needed will largely depend on the configuration flags you use).

As a reference, the whole compilation process will take around 3 hours on a medium-high resourced computer.

== Installing the Minimal System ==

The first step is to create a [http://www.kernel.org Linux]-like environment, which is required in order to be able to perform the build. This can be done by following these steps '''in this order''':

#Install [http://www.mingw.org MinGW]. Select ''Compact installation'' unless you know what you are doing. When it prompts you for a folder, the default (''C:\mingw'') is slightly messy but the safer selection.
#Install [http://www.mingw.org/msys.shtml MSys]. When it prompts you for the [http://www.mingw.org MinGW] folder, it's very important to specify it correctly. Failure on this step will stop any compilation attempts. If for some reason you fail, install [http://www.mingw.org/msys.shtml MSys] again, or edit the file ''/etc/fstab'' in your [http://www.mingw.org/msys.shtml MSys] environment.
#Install the [http://www.mingw.org/msys.shtml MSys] developer toolkit.
#Install [http://www.gnu.org/software/libiconv LibIConv].
#Install [http://www.gnu.org/software/gettext GetText].

== Compiling the libraries ==

There are two libraries that [[aMule]] will need compiled: [http://www.zlib.org zlib] and [[wxWidgets]].

We will compile them from [http://www.mingw.org/msys.shtml MSys], so just run it. Once you are running [http://www.mingw.org/msys.shtml MSys], you'll be on your home folder. Copy the [http://www.zlib.org zlib] and [[wxWidgets]] files you downloaded above into this folder (something like ''C:\msys\1.0\home\'''user''''').

The steps for compiling them is as follow:
(Hint: If you are using a multi-core system, you can speed up compiling by adding "-jX" after the make command, where X is the number of cores in your system plus one. For instance, ''./configure --prefix=/mingw && make -j3 && make install'')

#[http://www.zlib.org zlib]: Uncompress [http://www.zlib.org zlib], cd to the newly created directory and run ''./configure --prefix=/mingw && make && make install''
#[[wxWidgets]]: Uncompress [[wxWidgets]], cd to the newly created directory and run ''./configure --enable-unicode --disable-shared --without-checklistbox && make && make install''
#[[Crypto++]]: Uncompress the Crypto++ libraries (you'll need to create a directory yourself!), cd to the newly created directory and run ''make && PREFIX=/mingw/ make install''

If you want to help us developers, you can add ''--enable-debug'' flag to the [[wxWidgets]] configure command, right after ''--disable-shared'', but be warned it will result into an ''aMule.exe'' file bigger than 100MB.

== Compilation ==

Ok, we're all done with the compilation environment. Let's do the last step: compiling [[aMule]].

First of all, extract [[aMule]]'s sources and enter the newly created folder.

The compilation itself is actually just a matter of following the usual method: ''./configure && make''. Use your favorite flags on ''./configure'', for example, ''--disable-debug'' will remove debug info, but will also make it harder for us developers to understand the bugs you might find.

You might want to compile just the remote GUI: the flags would be ''--disable-monolithic --disable-ed2k --enable-amule-gui''

'''Beware:''' The following programs do not work yet on [http://www.microsoft.com/windows Windows]:
*[[aMuled|aMule Daemon]]: Doesn't even compile.
*[[CAS]]: Fails to find the [[signature]] file.

'''Note:''' To keep the size of the binaries down, you can run ''strip'' from within [http://www.mingw.org/msys.shtml MSys], e.g. ''find . -name '*.exe' -print | xargs -r strip''.

== Running ==

To run the binaries we've created you need ''mingwm10.dll''. This file can be found in ''C:\MinGW\bin\mingwm10.dll'' (or whatever path you used to install [http://www.mingw.org MinGW]).

You now have to place this file in some place so that the binaries find it when they are executed. Here you have three options:

#Place it in the same folder where the binaries are (if you have them spread in several different folders, copy this file once into each folder. Since it is a very small file, it is not much of a loss).
#Place it in ''C:\windows'' or some other any other path where [http://www.microsoft.com/windows Windows] might look for libraries (such as ''C:\Windows\System'' or ''C:\Windows\System32'').
#Add ''C:\MinGW\bin'' (or whatever path you used to install [http://www.mingw.org MinGW]) to your ''PATH'' environment variable.

Now... just run your binaries and have fun with [[aMule]] on your [http://www.microsoft.com/windows Windows] box!

'''Note:''' By default, the binaries are compiled to ''C:\MSys\1.0\home\'''user'''\amule-2.0.3\src\''.

== Having different languages ==

Now [[aMule]] will be successfully running, but you will not be able to use any other language but default english.

TO be able to choose between any of the lot of languages [[aMule]] is shipped with, from [http://www.mingw.org/msys.shtml MSys] go to [[aMule]]'s extracted folder and then into ''po/'' folder. Something like the following should do it:

cd
cd amule-2.0.3/po

Now install the languages:

make install-data-yes

This language files are now in ''C:\MSys\1.0\local\share\locale'', so exit [http://www.mingw.org/msys.shtml MSys], go to ''C:\msys\1.0\local\share\locale'' and copy that folder to the folder were you are keeping your compiled ''amule.exe'' and ''amulegui.exe'' files.

== Downloading precompiled win32 version ==

'''Keep in mind this is a user contributed build. Install it at your own risk'''

If you prefer a stable (and more recent) build, you can grab amulegui from the stable 2.1.1 sources here:
http://conrausch.elise.no-ip.com/aMuleGUI-2.1.1-all_lang.zip

Again, this is a user contributed build, which you should not trust ;). It works pretty well though. It is a little big (almost 3MB), but it contains the .dll plus all language packs that were available with the release. For problems with this one, please contact conrausch [at] gmx de

== Author ==
Originally by '''[[User:Madcat|Madcat]]'''

Install-amule-freebsd

2008-01-07T14:08:38Z

Xaignar: No embedded crypto++

<h1><font color=red>The Information on this page is very Old. Someone should update it</font></h1>

== Installing official [[aMule]] ports ==

Version 2.1.3

The amule port can be found at:

/usr/ports/net-p2p/amule2

I prefer the installation of applications on freebsd through the ports collection. Assumeing you're useing freebsd 6.2, as root:

# cd /usr/ports/net-p2p/amule2
# make install clean

In the next menu select deamon if you've plans to remote control aMule, or leave the options as they are, press OK and wait for compilation. The time needed depends on the depended applications that has te be installed. The program directory can be found: (~./aMule/). Means as root:

/root/.aMule/

any other user:

/usr/home/<username>/.aMule/

amule.conf can be found directly in the program folder. The webserver config file has to be made:

# amuleweb -w.

and is called remote.conf

The stable [[aMule]] is version 2.1.3.

We wanna stay current? Help test? Help debug? Continue with this article to learn how to install/compile aMule on your system.

== Install [[aMule CVS]] on [http://www.freebsd.org FreeBSD] 6.2 ==

Check that your /usr/port is up-to-date, for example using portsnap:
''portsnap fetch update''

Upgrade the FreeBSD flex release (2.5.4) with the new one (2.5.33):

''cd /usr/ports/textproc/flex''
''make install clean''

This installation didn't override the old /usr/bin/, but put a new release on /usr/local/bin/.

Then we need to rename the old flex release:

''mv /usr/bin/flex /usr/bin/flex.old''

And check your version with this command:

''flex --version''

You should obtain: 2.5.33

Install wxgtk28:

''cd /usr/ports/x11-toolkits/wxgtk28-unicode/''

''make install clean''

Download the latest [[aMule CVS]] snapshot
[http://www.amule.org/files/download.php?file=5 here].

(This article is tested with http://www.hirnriss.net/files/cvs/aMule-CVS-20071002.tar.bz2)

''tar -zxvf aMule-CVS-20071002.tar.bz2''

''cd amule-cvs/''

''./configure --prefix=/home/'''user'''/amule-cvs/
--with-wx-config=/usr/local/bin/wxgtk2u-2.8-config
--disable-debug --with-curl-config=/usr/local/bin/curl-config --enable-webserver
--enable-optimize --with-included-gettext --enable-amule-daemon --enable-amulecmd --enable-cas''

'''NOTE:''' Check [[configure]]. Also, change '''user''' for your user name.

''gmake''

''gmake install''

== Install [[aMule CVS]] on [http://www.freebsd.org FreeBSD] 5.3 ==

Make sure you have installed:

''/usr/ports/x11-toolkits/wxgtk2''

* Ignore the "problems" about [[wxGTK]]2 on [http://www.freebsd.org FreeBSD]. It works perfectly!

Download the latest [[aMule CVS]] snapshot
[http://www.amule.org/files/download.php?file=5 here].

(This article is tested with http://amule.hirnriss.net/cvs/aMule-cvs-20041215.tar.bz2)

''tar -zxvf aMule-cvs-20041215.tar.bz2''

''cd amule-cvs/''

''./configure --prefix=/home/'''user'''/amule-cvs/
--with-wx-config=/usr/X11R6/bin/wx-config
--with-wxbase-config=/usr/X11R6/bin/wx-config
--disable-debug --with-curl-config=/usr/local/bin/curl-config
--enable-optimize --x-libraries=/usr/X11R6/lib
--x-includes=/usr/X11R6/include --localstatedir=/usr/X11R6/share/gnome
--datadir=/usr/X11R6/share/gnome --with-html-dir=/usr/X11R6/share/doc
--with-crypto-prefix=/usr/local --with-included-gettext --disable-cas''

'''NOTE:''' Check [[configure]]. Also, change '''user''' for your user name.

''gmake''

''cd ~/amule-cvs/src/amule''

If you would like to compile/install [[aMule]] 2.0.0-rc7, you can follow the same instructions.

Greetz,
Martin

[mailto://amule@air-maxx.net amule@air-maxx.net]

== Manual compilation ==

Follow this guide to compile [[aMule]] on your [http://www.freebsd.org FreeBSD] system.

=== Requirements ===

Install this ports if you don't already have them installed (see ''pkg_info''), since they are needed to compile [[aMule]]:

''x11-toolkits/wxgtk''
''security/cryptopp''

Also (but you will have these already ;-)) ''devel/gettext'' and ''devel/gmake''

You know how to install ports as a [http://www.bsd.org BSD] user, so I don't have to tell you, I hope. It's just too easy you know. In case you're very new to [http://www.freebsd.org FreeBSD], consult the great [http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook handbook] at [http://www.freebsd.org http://www.freebsd.org].

'''NOTE:''' If you think you have [[wxWidgets|wxGTK]] installed because you see [[wxWidgets|wxGTK2]], you should know, [[wxWidgets|wxGTK]] is linked against [http://www.gtk.org GTK1] and [[wxWidgets|wxGTK2]] is linked against [http://www.gtk.org GTK2]. Using [[wxWidgets|wxGTK2]] with [[aMule]] might become [[aMule]] unstable! You should use [[wxWidgets|wxGTK]], not [[wxWidgets|wxGTK2]].

=== Configure ===

(Tested with [http://www.freebsd.org FreeBSD] 5.2-CURRENT 03-May-2004)

The ''./configure'' does not work 100% automagically, we must help it out a bit (check [[configure]]).

Edit the '''<your home>''' tag, of course, or install it elsewhere.

''./configure --prefix=/home/'''<your home>'''/amule --with-wx-config=/usr/X11R6/bin/wxgtk-2.4-config --with-wxbase-config=/usr/X11R6/bin/wxgtk-2.4-config''

'''NOTE:''' This is one single line, not 3 lines or whatever [http://wiki.org/wiki.cgi?WhatIsWiki wiki]/HTML/your browser wraps this line into.

You will see configure doesn't find ''gdlib-config'', even if you installed ''gdlib''. Don't care, it's just not there and it's no "must have". Just skip it.

'''NOTE:''' If you get the following warning:

''WARNING!! Your wxWidgets copy has been linked against GTK2 and this will make aMule be unstable, use so much cpu and ram. You have been advised, don't report bugs so.''

at the end of ''configure'' you are probably linking against [[wxWidgets|wxGTK2]] instead of [[wxWidgets|wxGTK]]. [[aMule]] will memleak and eat your CPU. It will probably crash as well. Use [[wxWidgets|wxGTK]] as mentioned above!

=== Make ===

''make'' will fail, use ''gmake''

''make'' is [http://www.bsd.org BSD] [http://www.gnu.org/software/make make], ''gmake'' is [http://www.gnu.org GNU] [http://www.gnu.org/software/make make]. They are '''not''' compatible.

Now do:

''gmake''

Get yourself a hot green tea (I prefer some sort of sencha) while it is compiling.

Then do:

''gmake install''

=== Use it ===

Just start it with ''/home/<your home>/amule/bin/amule''
or wherever you installed it to...

Have phun

Eugene

== The [[aMule]] 2.0.0 port ==

Hi :)

I've just released the 2.0.0 port !!! As ususal, available here :
http://contribs.martymac.com and soon on http://dl.amule.org !!!!

A few modifications : it is now linked against [[wxGTK]]2-unicode-devel ; it will be linked back against [[wxGTK]]2-unicode (stable) when [[wxWidgets|2.6]] is out. The small [[ed2k_command]] binary is also now named ''ed2k'', it is no more renamed to ''amule-ed2k''. Finally, the port will only build on [http://www.freebsd.org 5.x], no more on [http://www.freebsd.org 4.x], sorry... For [http://www.freebsd.org 4.x] compatibility, see this old good port ''net/amule'' (which should be soon renamed to ''net/amule1'') in the official source tree.

The port builds fine on [http://www.x86-64.org amd64], and should on [http://www.intel.com/design/support/faq/embed_proces/x86faq.htm x86] :P

Enjoy!

Ganael LAPLANCHE

http://contribs.martymac.com

[mailto://ganael.laplanche@martymac.com ganael.laplanche@martymac.com]

== The [[aMule]] 2.0.0-rc7 port ==

Hi all, the rc7 port is now available on my website:
http://contribs.martymac.com

I've also added binaries for those who don't want to spend time to compile. The port works on [http://www.freebsd.org FreeBSD] 4.10 and 5.2.1. Any feedback welcome. I've changed some options to the Makefile: amule-ed2k-handler is now amule-ed2k, and cmd+GUI options are now joined in global ones. Do a "make config" prior to the "make install" to update your config file.

Enjoy :)

Ganael LAPLANCHE

http://contribs.martymac.com

[mailto://ganael.laplanche@martymac.com ganael.laplanche@martymac.com]

== The [[aMule]] 2.0.0-rc6 port ==

Visit http://www.amule-project.net/amule/thread.php?threadid=3758 and do as it says ;-)

== The [[aMule]] 2.0.0-rc4a ports ==

Hi all, new update to this wiki: 2.0.0rc4a ports are available. No, you ain't dreaming, you've just seen an 's' appended, because there are two ports.

Unfortunately, [http://www.freebsd.org FreeBSD] 4.x (and [http://gcc.gnu.org GCC] 2.95) doesn't provide some required libs (see the patches inside the archive) to build this brand-new [[aMule]] version, so I released two ports :

*One for the 4.x branch, which won't compile under 5.x:
Includes many patches, sometimes tricky, to make it work. This could lead to unstability and require further testing. Any feedback is welcome :)

*Another one for the 5.x branch, wich won't compile under 4.x:
This one doesn't include any patch.

To download the ports: http://www.amule.org/amule/download.php or http://contribs.martymac.com

Enjoy!

Ganael LAPLANCHE

http://contribs.martymac.com

[mailto://ganael.laplanche@martymac.com ganael.laplanche@martymac.com]

== The [[aMule]] 2.0.0-rc3 port ==

I've just released the 2.0.0rc3 port.

See http://www.amule.org/amule/download.php (and http://contribs.martymac.com ) to download it.

== Installing non-official ports ==

If you download a port which is not officially available, you'll have to uncompress it (''tar xvzf file.tgz'') into the ''/usr/ports/net'' directory and then do a standard ''make install''.

Any feedback welcome, many thanks to Eugene for this great wiki :)

Ganael Laplanche.

== Compilation problems ==

If you still can't compile [[aMule]] see if the following patches work.

=== Patch 1 ===

The problem would be:

''<pre>[...]
/usr/bin/ld: cannot find -lcryptopp
gmake[2]: *** [cas] Error 1
gmake[2]: Leaving directory `/home/eugene/aMule-2.0.0rc3/src'
gmake[1]: *** [all-recursive] Error 1
gmake[1]: Leaving directory `/home/eugene/aMule-2.0.0rc3'
gmake: *** [all] Error 2</pre>''

So we patch it now:

''edit src/Makefile''

Search for the line containing

''cryptopp''

This line will read as:

''LIBS = -lcryptopp''

Add ''-L/usr/local/lib'' to that line

Now the line will read as:

''LIBS = -L/usr/local/lib -lcryptopp''

=== Patch 2 ===

The problem would be:

''<pre>[...]
amule.cpp:39:30: execinfo.h: No such file or directory
amule.cpp:40:28: mntent.h: No such file or directory
In file included from /usr/local/include/cryptopp/pkcspad.h:4,
from /usr/local/include/cryptopp/rsa.h:9,
from ClientCredits.h:32,
from amule.cpp:86:
/usr/local/include/cryptopp/cryptlib.h:1358:9: warning: "/*" within comment
amule.cpp: In member function `virtual bool CamuleApp: nInit()':
amule.cpp:423: error: `setmntent' undeclared (first use this function)
amule.cpp:423: error: (Each undeclared identifier is reported only once for
each function it appears in.)
amule.cpp:429: error: `getmntent' undeclared (first use this function)
amule.cpp:431: error: invalid use of undefined type `struct mntent'
amule.cpp:427: error: forward declaration of `struct mntent'
amule.cpp:432: error: invalid use of undefined type `struct mntent'
amule.cpp:427: error: forward declaration of `struct mntent'
amule.cpp:437: error: invalid use of undefined type `struct mntent'
amule.cpp:427: error: forward declaration of `struct mntent'
amule.cpp: In member function `virtual void CamuleApp: nFatalException()':
amule.cpp:982: error: `backtrace' undeclared (first use this function)
amule.cpp:987: error: `backtrace_symbols' undeclared (first use this function)
gmake[2]: *** [amule-amule.o] Error 1
gmake[2]: Leaving directory `/home/eugene/aMule-2.0.0rc3/src'
gmake[1]: *** [all-recursive] Error 1
gmake[1]: Leaving directory `/home/eugene/aMule-2.0.0rc3'
gmake: *** [all] Error 2</pre>''

So we patch it now:

As there is no official [http://www.freebsd.org FreeBSD] support in [[aMule]] yet we will patch it to work... Well there is [http://www.openbsd.org OpenBSD] support and this support will work for us too :-)

Edit ''src/amule.cpp''

and insert

''#define __OPENBSD__''

at the top of this file. I placed it right before the first ''#include'' line...

"What a workaround!" you may scream. Hey, we don't fiddle too much around with the code, just hack it to work and get ready to share ;-)

IRC rules

2006-04-09T23:02:06Z

Xaignar: =Introduction=

== Introduction ==

While you stay at our [[IRC]] channels, we expect you to follow these rules. You are expected to have read and understood this page. Ignorance of these rules is not an excuse.

The most basic of all rules is: '''Have manners.'''

Failure to comply with the rules can result in kicks, temporary bans and even permanent bans depending on the severity of the transgression.

== What you must do ==

* Speak English. For other languages, visit our [http://forum.amule.org forums].
* Since many people speak English as a second language, you should make sure that what you are writing is proper English, and understandable.
* Search before you ask. In many cases, your questions have already been answered before. Places to search include, the [http://forum.amule.org Forums], the [[Main Page|Wiki]] and [http://www.google.com Google].
* Private conversations should be conducted via a query (''/query <nick>'').

== What you must not do ==

* You must not violate any of your country's laws nor any of the [http://europa.eu.int European Community] laws nor any of the [http://www.firstgov.gov USA] laws nor any of the international laws while staying at any of our channels. Sounds funny? Well, it's not.
* You must not talk about anything that doesn't regard '''directly''' (in the most strict way) to [[aMule]] as an application. Exceptionally, you may ask questions about the [[FAQ_ed2k|ed2k]] and [[Kademlia]] protocols, but an answer is not guaranteed.
* You must not talk, directly or indirectly, about any copyrighted non-free (in the ''beer way'') material.
* You must not provide any URL which's contents break any of our channels rules.
* You must not provide '''any''' [[ed2k link]].
* Do not flood. If you need to share large ammounts of text, use a pastebin service such as [http://www.pastebin.ca pastebin.ca].
* You must not use any bots in the channels unless some channel operator allows you to do so.
* Do not spam. That includes scripts, away-messages, advertising, repeatedly asking the same question, etc.

== Suggestions ==

* Have patience. If nobody is answering your question, it may be because nobody is around to read it, or nobody present knows the answer.
* Use the latest stable [[aMule]] release.
* Distro specific questions, should go the distro's channel or forums. Mostly because we won't know the answer.

== What if a rule is not clear? ==

These rules are made by the channels operators. If you are uncertain about some particular rule or other, you can either assume the worst or ask if you have understood them correctly.

However, since we have not yet merged into a Borg collective, different operators may interprent the rules differently. If an operator confronts you with doing something another operator told you was ok, let the second operator know (including who told you so). If the operator that tells you not to do something is [[User:Kry|Kry]], you're doomed.

IRC rules

2006-03-28T15:17:42Z

Xaignar: =Introduction=

== Introduction ==

While you stay at our [[IRC]] channels, we expect you to follow these rules. You are expected to have read and understood this page. Ignorance of these rules is not an excuse.

The most basic of all rules is: '''Have manners.'''

Failure to comply with the rules can result in kicks, temporary bans and even permanent bans depending on the severity of the transgression.

NOTE: The Care Bears are not off topic!

== What you must do ==

* Speak English. For other languages, visit our [http://forum.amule.org forums].
* Since many people speak English as a second language, you should make sure that what you are writing is proper English, and understandable.
* Search before you ask. In many cases, your questions have already been answered before. Places to search include, the [http://forum.amule.org Forums], the [[Main Page|Wiki]] and [http://www.google.com Google].
* Private conversations should be conducted via a query (''/query <nick>'').

== What you must not do ==

* You must not violate any of your country's laws nor any of the [http://europa.eu.int European Community] laws nor any of the [http://www.firstgov.gov USA] laws nor any of the international laws while staying at any of our channels. Sounds funny? Well, it's not.
* You must not talk about anything that doesn't regard '''directly''' (in the most strict way) to [[aMule]] as an application. Exceptionally, you may ask questions about the [[FAQ_ed2k|ed2k]] and [[Kademlia]] protocols, but an answer is not guaranteed.
* You must not talk, directly or indirectly, about any copyrighted non-free (in the ''beer way'') material.
* You must not provide any URL which's contents break any of our channels rules.
* You must not provide '''any''' [[ed2k link]].
* Do not flood. If you need to share large ammounts of text, use a pastebin service such as [http://www.pastebin.ca pastebin.ca].
* You must not use any bots in the channels unless some channel operator allows you to do so.
* Do not spam. That includes scripts, away-messages, advertising, repeatedly asking the same question, etc.

== Suggestions ==

* Have patience. If nobody is answering your question, it may be because nobody is around to read it, or nobody present knows the answer.
* Use the latest stable [[aMule]] release.
* Distro specific questions, should go the distro's channel or forums. Mostly because we won't know the answer.

== What if a rule is not clear? ==

These rules are made by the channels operators. If you are uncertain about some particular rule or other, you can either assume the worst or ask if you have understood them correctly.

However, since we have not yet merged into a Borg collective, different operators may interprent the rules differently. If an operator confronts you with doing something another operator told you was ok, let the second operator know (including who told you so). If the operator that tells you not to do something is [[User:Kry|Kry]], you're doomed.

Getting Started

2006-02-23T23:37:40Z

Xaignar: Info about kad and categories.

<center>
'''English''' | [[Getting_Started-fr|Français]] | [[Getting_Started-nl|Nederlands]] | [[Getting_Started-es|Español]] | [[Getting_Started-de|Deutsch]] | [[Getting_Started-hu|Magyar]] | [[Getting Started-ru|Russian]] | [[Getting Started-da|Dansk]]
</center>

== What is [[aMule]] ==

[[aMule]] is a [[P2P|p2p]], or peer-to-peer, client for the [[FAQ_eD2k-Kademlia|eD2k]] network, commonly known as [[FAQ_eD2k-Kademlia|eDonkey network]] or eD2k network ([[eDonkey2000]]). This guide does not require you to be familiar with these networks (but it does help), however it does require that you have [[aMule]] installed on your computer.
If you haven't installed [[aMule]] yet, please refer to the proper installation guide for your system. Links to these guides can be found on the [[Main_Page|main page]].

--[[User:Xaignar|Xaignar]] 01:12, 10 Jul 2004 (CEST)

== Running [[aMule]] for the first time ==
First, launch [[aMule]]. This can be done by executing the command ''amule'' in a console window or by whatever method might be provided by your distro and/or windows manager in terms of icons, etc.

Once started, if you are using the [http://www.gnu.org/software/cvs CVS] build, [[aMule]] will display a notification telling you that you are running it for the first time. Read this to learn what you are getting yourself into ;)

A note for MacOSX users:
aMule makes extensive use of right-click menus, so if you can't find a function, try right-clicking on the item you wish to manipulate.

=== Configuring [[aMule]] ===
Before you begin file sharing, you will need to properly configure [[aMule]]. This includes connection speeds and limits, directories to be used, proxies, port settings and other settings.
You can access [[aMule]] preferences by clicking on the ''Preferences'' icon at the top of the [[aMule]] window.

==== Connection Speed ====
You should know that the eDonkey clients enforce upload. This means that in order to download, you'll have to share files yourself (don't worry if you don't have anything to share). This is enforced in two ways:
* Your download speed depends on how fast you upload. If your upload speed is set to anything below 10kb/s then your maximum download speed will be 3 or 4 times your uploadspeed (read [[FAQ_eD2k-Kademlia#Are_there_any_limitations_on_the_ED2K_network?|this]] to know more about it), so if you limit your upload speed to 5kb/s, you'll only be able to download with 20kb/s.
* Partially downloaded files are shared as well. You automatically start sharing a file after you've received at least one [[FAQ_eD2k-Kademlia#What_is_a_chunk?|chunk]] (a [[FAQ_eD2k-Kademlia#What_is_a_chunk?|chunk]] is a 9.28Mb piece of a file).

Note: If you ever enter the [http://forum.amule.org aMule forum] or [[IRC|IRC channel]] to complain about this or demand that we change the ratio, I will hunt you down and eat your spleen. -- [[User:Xaignar|Xaignar]]

When you first open the Preferences dialog, the page shown will be "General", which contains some general settings, like the [[nickname]] other people will see when they download from or upload to you.
To proceed, click on the tab named "Connection":

http://www.amule.org/dev-up/Limits.png

The only settings relevant to this guide are the settings under "Bandwidth Limits" marked "Upload" and "Download". You don't need to enter a max download speed, but it is recommended that you set the upload speed to around 80% of your actual speed, since it can cause slower downloads otherwise.

Once you have entered the proper values, you can explore the rest of the settings. To save the changes, simply click the "OK" button.

=== ED2K and Kademlia ===

As of v2.1.0, aMule is also capable of connecting to the serverless network dubbed [[Kademlia]]. This allows aMule and other eDonkey2000 clients to function without having to rely on generous souls running servers. Both [[Kademlia]] and the server-based [[ED2K]] network are enabled by default, but you can disable either of the two networks on the lower part prefences page titled 'Connection'. Users with slow upload speeds should consider enabling only one of the two networks, due to the added overhead.

=== Connecting to a Server ===

You should now be looking at the servers dialog:

http://www.amule.org/dev-up/ServerDlg.png

The empty list normally contains the servers you know about, but since this is the first time you're running [[aMule]], you don't have any. To remedy this situation, simply click in the text-field containing the text ''http://www.srv1000.com/azz/server.met'' and press enter.
A dialog will pop up and close again once the download has completed.

You should now have a full list of servers, if not search google for ''server.met'', replace the url mentioned above and press enter to initiate the download.

http://www.amule.org/dev-up/ServerList.png

Next you need to connect to a [[server]]. Normally it's a good idea to select one with as many users as possible, but for now, lets just click the large "Connect" button near the top-left of the window. This will connect you to a random server. Please wait while [[aMule]] contacts servers and tries to establish an connection. Once this happens, proceed on to the next section.

=== Connecting to the Kademlia Network ===

To connect to the [[Kademlia]] network, provided that it is enabled in the preferences, all you need to do is to do is press the "Connect" button on the top toolbar. Note that manually connecting to a server (by double-clicking or right-clicking and selecting the 'Connect to server' item) wont connect you to the [[Kademlia]] network. Another way to connect to the [[Kademlia]] network is to enter the 'Kad' sub-page on the 'Networks' page, and press the 'Bootstrap from known clients' button. In case this is the first time you use Kad, you may want to updates your nodes.dat file, by clicking in the Url textfield and pressing enter. It is not nescesarry to do this again later, as the nodes list is kept up to date when aMule is running.

=== [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|High and Low ID]] ===
Because [[P2P|p2p]] networks work by [[Client|clients]] directly connecting to each other, being behind a firewalls, or routers that do not/cannot pass traffic on specific ports, can really cause problems. If you don't know whenever or not you are behind a firewall, simply look at the globe icon in the bottom-right of the window. If its arrows are green, then you have [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|High ID]] and can proceed, but if they are yellow, then you need to take a look at the page on [[Firewall|Firewalls]] and/or [[AMule_problems#aMule_connects_to_server,_but_it_is_always_given_LowID._Why?_and,_can_I_do_something_about_it?|common problems]], since having a [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|Low ID]] greatly reduces [[P2P|p2p]] experiences.

== Basic Usage ==
This will cover some basic usage of [[aMule]].

=== Searching and Downloading ===
OK, this is what [[P2P|p2p]]'ing is about: Downloading files.
For the sake of this guide, I'll presume that you are really keen on downloading the latest [http://www.knoppix.org Knoppix] CD (who isn't?). To download this, first ensure that you are connected to a server, or the [[Kademlia]] network, and then click on the "Searches" button.

This will bring up the search dialog:

http://www.amule.org/dev-up/SearchDlg.png

Since we only care about CD images, we click on "Extended Options" and select the option "CD-Images" from the "File Type" dropdown menu. If you are connected to an [[ED2K]] server, select the "[[Search#Local_search|Local]] [[Search]]" setting, since we don't really need to search anything other than the currently connected [[server]]. Otherwise, if you are connected to the [[Kademlia]] network, select the 'Kad' search-type. Then we enter ''Knoppix'' in the top "Name" field and hit enter or the "Search" button. You should now have a listful of results:

http://www.amule.org/dev-up/SearchResults.png

Lets sort the list by [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]], by clicking twice on the field marked "Sources", this makes it easier to find popular files. The second one looks interesting, so we double-click on it (or click on it and then on the "Download" button). This will queue the file for download.

Results can be displayed in a number of colors, which signify the following:
* Blue represents the number of sources, the more sources the darker the blue.
* Red represents files that you are currently downloading.
* Green is for files you have downloaded or shared before, in other words files you already have.

=== Search Types ===
I only mentioned 'Local' and 'Kad' searching above.

A local search only asks the server you are connected to, and is enough in most cases. However, if this does not return any results, you can ask all servers in your serverlist, by doing a 'Global' search. This however takes a lot longer (0.75s per server).

Lastly, you can search on the 'Kademlia' network via the 'Kad' search-type. Note that on the 'Kad' network, results signify complete sources, unlike 'ED2K' searches, where the source-count contains both complete and incomplete sources.

=== The Download Queue ===
Click on the "Transfers" button to bring forth a list of files you have queued for download:

http://www.amule.org/dev-up/DownloadQueue.png

If you're lucky, the progress bar will turn a nice dark shade of blue, which means that a lot of people have that file (read [[FAQ_aMule#What_do_those_colors_in_the_progress_bar_mean?|this]] to know more about it). Beware of files that have parts marked in red, since it means that no-one has that part of the file and you most likely wont be able to complete the download.

If you double-click on any of the files, you can see the [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] you have found for that file.

==== Of Rows and Columns ====
These are the columns of the Download Queue:

; ''Filename'' : The name of the file.
; ''Size'' : The size of the file. The eDonkey2000 network supports files up to 4GB in size (read [[FAQ_eD2k-Kademlia#Are_there_any_limitations_on_the_ED2K_network?|more]] about this).
; ''Transferred'' : Shows the amount downloaded.
; ''Completed'' : This column displays how much of the file you have actually completed. Please note that this can differ from the Transferred column because of corruptions or gains made by the compression *Mule [[Client|clients]] use (read [[FAQ_aMule#What_is_the_difference_between_Transfered_and_Completed_in_the_Transfers_window?|more]] about this difference).
; ''Progress'' : This bar displays the current progress of the file, the colours signifying the following (alternative [[FAQ_aMule#What_do_those_colors_in_the_progress_bar_mean?|resource]]):
* Blue: How many sources provide this part, the darker the colour, the more sources provide it.
* Red: There are no known [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] that provide this part.
* Black: You have already downloaded this part.
* Yellow: You are currently downloading this part.
: The green bar on top of the larger bar gives an indication of the actual progress.
; ''Sources'' : There are 3 fields in this column, though mostly only 2 are shown (alternative [[FAQ_aMule#What_do_all_those_numbers_in_the_sources_column_in_the_transfers_window_mean?|resource]]):
: <Asked [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]>[/<All [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]>] [+ <[[FAQ_aMule#What_is_A4AF?|A4AF]] [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]> ] [(<Transferring [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]]>)]
: 'Asked [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]' are those that have been asked for the file.
: 'All [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]' are all [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] of that file, asked and unasked.
: '[[FAQ_aMule#What_is_A4AF?|A4AF (Asked For Another File)]] [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]' are [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] that provide that file, but have been asked for anther one.
: 'Transferring [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]]' are [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] which are uploading that file to you at this very moment.
; ''Priority'' : The priority of the file. Files are set to auto-priority by default, which means that [[aMule]] will manage it by itself. Priorities affect how [[aMule]] allocates [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] that are known to provide multiple files and thus means that high-priority files get more [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]]. Read [[FAQ_aMule#What_do_all_those_numbers_in_the_priority_column_in_the_extended_transfers_window_mean?|more]] about this.
; ''Status'' : The current status of the file. Waiting means that you are waiting for [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] to start uploading to you.
; ''Time Remaining'' : An guess at how fast the file will be completed. Only shows something when you are currently receiving the file.
; ''Last Seen Complete'' : This shows the last time you've seen the entire file provided by the [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] you've asked.
; ''Last Reception'' : This shows the last time you were downloading parts of this file.

=== The Upload Queue ===
The upload queue can be found just beneath the download queue, and shows who are downloading files from you (you might want to read [[FAQ_aMule#Why_are_there_two_transfer_rates_in_the_uploading_transfer_list?|this]]). In case you are wondering, no, you cannot stop uploads. If you click on the blue icon next to the "Uploads" label, you can see who are queued for downloading from you, rather than the people who are actually downloading from you right now.

=== Icons and What They Signify ===
These are the icons that can be found on the Transfers page.

* '''Source Status'''
** http://www.amule.org/dev-up/Source_1.png - [[Client]] is sending you either a file or a hashset.
** http://www.amule.org/dev-up/Source_2.png - You are either on this [[Client|clients]] queue or currently asking it for a file.
** http://www.amule.org/dev-up/Source_3.png - You are currently connecting to this [[Client|client]].
** http://www.amule.org/dev-up/Source_4.png - [[Client]] has been asked for another file, has no needed parts or is unable to connect because of a [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|Low ID]].
** http://www.amule.org/dev-up/Source_5.png - Status is unknown.

* '''eDonkey Clients'''
** http://www.amule.org/dev-up/Client_aMule.png - [[aMule]]
** http://www.amule.org/dev-up/Client_eDonkey.png - [[eDonkey2000]]
** http://www.amule.org/dev-up/Client_eMule.png - [[eMule]]
** http://www.amule.org/dev-up/Client_Friend.png - [[Client]] is a [[Friend]]
** http://www.amule.org/dev-up/Client_Lphant.png - [[lphant]]
** http://www.amule.org/dev-up/Client_MLDonkey.png - [[mlDonkey]]
** http://www.amule.org/dev-up/Client_Shareaza.png - [[Shareaza]]
** http://www.amule.org/dev-up/Client_Unknown.png - Unknown [[Client]]
** http://www.amule.org/dev-up/Client_xMule.png - [[xMule]]

* '''Modifiers'''
** http://www.amule.org/dev-up/Client_Mod_eMuleProt.png - [[Client]] supports the extended [[eMule]] protocols. Source-sharing and such.
** http://www.amule.org/dev-up/Client_Mod_GoodCredit.png - [[Client]] has a good [[FAQ_eD2k-Kademlia#What_is_all_this_talk_about_credits,_ratings_and_scoring_about?|credit-rating]].
** http://www.amule.org/dev-up/Client_Mod_NormCredit.png - [[Client]] has a normal [[FAQ_eD2k-Kademlia#What_is_all_this_talk_about_credits,_ratings_and_scoring_about?|credit-rating]].
** http://www.amule.org/dev-up/Client_Mod_SecId_Good.png - [[Client]] has been [[Secure_User_Identification|securely identified]].
** http://www.amule.org/dev-up/Client_Mod_SecId_Bad.png - [[Client]] has been identified for some reason as a [[bad guy]].

* '''File [[comment]]s''' icons are explained in the [[comment icon]]s article.

=== Categories for Downloads ===

It is possible to assign downloads to a category, which can have a unique color on the download listctrl, and can be saved to a different folder than the default one.

To add a new category, right-click (and hold) on the tab titled 'All', which is located next to the gree tick, just below the toolbar on the Transfers page. Then select 'Add Category' and fill in the desired details. A random color is selected by default, but this can be changed.

To add a file to a category, right-click on it in the download listctrl, and select the desired category in the "Assign to Category" submenu. The item 'Unassigned' will assign it to the default category.

When categories are added, a matching tab is added next to the original 'All' tab. Left-clicking on these will change the display to only display files assigned to this category. As a final note, the default view, the 'All' tab, allows for various forms of filtering. These can be accessed by right-cliking on the tab and selecting from the 'Select view filter' submenu.

=== Where Are The Files? ===
Once [[aMule]] starts downloading a file, it will create a number of files to keep track of that specific download. These files can be found in the subdir ''.aMule/Temp'' in your homedir (''~/.aMule/Temp''), but should not be touched in most cases.

If you have incompleted downloads from [[eMule]], you can simply place the temp files in the ''~/.aMule/Temp'' directory if you wish for [[aMule]] to continue downloading them.

However, once a file has been completed, it will be moved away from ''~/.aMule/Temp'' and to ''~/.aMule/Incoming'', where all completed files are placed by default. You can change both of these paths in the preferences should you wish to do so.

Also, please note that the ''.aMule'' directory is a hidden directory, so you might have to enable showing of hidden files in your file-mananger, should you use one such.

=== [[Share|Sharing]] [[File]]s ===
First off, note the [[FAQ_ed2k|eDonkey2000 network]] is not meant to [[share]] small [[file]]s such as audio clips, but instead is optimized for distribution of larger [[file]]s. Also note that its your own responsibility to ensure that you do not violate any local laws regarding material shared.

You can share files in two ways in [[aMule]]:

The first method is to place the [[file]]s in the "Incoming" directory (''~/.aMule/Incoming'' on [http://www.unix.org Unix] like systems). After this has been done, you must either restart [[aMule]] or press the "Reload" button on the SharedFiles page.

http://www.amule.org/reload_button.png

The second method is to explicitly add [[shared directory|shared directories]] in which [[aMule]] will look for [[file]]s to [[share]]. This is done by clicking on the "Preferences" button and selecting the "Directories" page.

http://www.amule.org/images/screenshots/prefs7.png

From there, you can browse to the directory you wish to [[share]] via the directory-tree. Double-clicking on the folder icon will [[share]] the given directory and right-clicking on the folder icon will [[share]] the directory recursively.

== Conclusion ==
Hopefully this brief introduction has given you an idea of how [[aMule]] works. If you feel that something is missing from this guide, please let us know or add it yourself.

HowTo compile on Win32 with MinGW

2006-01-29T21:25:47Z

Xaignar: =Compiling the libraries=

<center><h2>Originally by '''[[User:Madcat|Madcat]]'''</h2></center>

<center>
'''English''' | [[HowTo compile on Win32-de|Deutsch]]
</center>

This wiki page only covers the latest [[aMule_CVS|CVS]] version of [[aMule]], not releases in the 1.x.x or 2.x.x branches.

''For those of you that don't want to compile [[aMule]] from source, there is also the option of the [[Win32_binary|aMule Windows Installer]].''

== Requirements for compiling [[aMule]] ==

You will need the following packages:

*[http://www.microsoft.com/windows Windows] port of [http://gcc.gnu.org GNU C compiler], [http://www.mingw.org MinGW] -> [http://prdownloads.sourceforge.net/mingw/MinGW-4.1.1.exe?download Download (4.1.1)]
*Minimal [http://www.gnu.org GNU] shell for [http://www.microsoft.com/windows Windows], [http://www.mingw.org/msys.shtml MSys] -> [http://prdownloads.sf.net/mingw/MSYS-1.0.10.exe?download Download (1.0.10)]
*Developer toolkit for [http://www.mingw.org/msys.shtml MSys] (for [http://www.gnu.org/software/cvs CVS] & co) -> [http://prdownloads.sf.net/mingw/msysDTK-1.0.1.exe?download Download (1.0.1)]
*[http://www.gnu.org/software/libiconv LibIConv] (required by [http://www.gnu.org/software/gettext gettext]) -> [http://prdownloads.sf.net/mingw/libiconv-1.8.0-2003.02.01-1.exe?download Download (1.8)]
*[http://www.gnu.org/software/gettext GetText] (for [http://www.gnu.org/software/gettext po files], [http://www.gnu.org/software/automake/automake.html autogen.sh], etc) -> [http://prdownloads.sf.net/mingw/gettext-0.11.5-2003.02.01-1.exe?download Download (0.11.5)]
*[http://www.zlib.org zlib] compression library -> [http://www.zlib.net/zlib-1.2.3.tar.gz Download (1.2.3)]
*[http://www.microsoft.com/windows Windows] port of [[wxWidgets]] library (knows as [[wxWidgets|wxMSW]]) -> [http://prdownloads.sourceforge.net/wxwindows/wxMSW-2.6.1.zip Download (2.6.1)]
*[[aMule]]'s latest release sources or [[aMule CVS]] -> [http://dl.amule.org Download aMule]

Also, 800MB-1500MB free space on your hard disk (around 40MB to download the above packages and the rest for temporary compilation files and installations. The amount of space needed will largely depend on the configuration flags you use).

As a reference, the whole compilation process will take around 3 hours on a medium-high resourced computer.

== Installing the Minimal System ==

The first step is to create a [http://www.kernel.org Linux]-like environment, which is required in order to be able to perform the build. This can be done by following these steps '''in this order''':

#Install [http://www.mingw.org MinGW]. Select ''Compact installation'' unless you know what you are doing. When it prompts you for a folder, the default (''C:\mingw'') is slightly messy but the safer selection.
#Install [http://www.mingw.org/msys.shtml MSys]. When it prompts you for the [http://www.mingw.org MinGW] folder, it's very important to specify it correctly. Failure on this step will stop any compilation attempts. If for some reason you fail, install [http://www.mingw.org/msys.shtml MSys] again, or edit the file ''/etc/fstab'' in your [http://www.mingw.org/msys.shtml MSys] environment.
#Install the [http://www.mingw.org/msys.shtml MSys] developer toolkit.
#Install [http://www.gnu.org/software/libiconv LibIConv].
#Install [http://www.gnu.org/software/gettext GetText].

== Compiling the libraries ==

There are two libraries that [[aMule]] will need compiled: [http://www.zlib.org zlib] and [[wxWidgets]].

We will compile them from [http://www.mingw.org/msys.shtml MSys], so just run it. Once you are running [http://www.mingw.org/msys.shtml MSys], you'll be on your home folder. Copy the [http://www.zlib.org zlib] and [[wxWidgets]] files you downloaded above into this folder (something like ''C:\msys\1.0\home\'''user''''').

The steps for compiling them is:

#[http://www.zlib.org zlib]: Uncompress [http://www.zlib.org zlib], cd to the newly created directory and run ''./configure --prefix=/mingw && make && make install''
#[[wxWidgets]]: Uncompress [[wxWidgets]], cd to the newly created directory and run ''./configure --enable-unicode --disable-shared --without-checklistbox && make && make install''

If you want to help us developers, you can add ''--enable-debug'' flag to the [[wxWidgets]] configure command, right after ''--disable-shared'', but be warned it will result into an ''aMule.exe'' file bigger than 100MB.

== Compilation ==

Ok, we're all done with the compilation environment. Let's do the last step: compiling [[aMule]].

First of all, extract [[aMule]]'s sources and enter the newly created folder.

The compilation itself is actually just a matter of following the usual method: ''./configure && make''. Use your favorite flags on ''./configure'', for example, ''--disable-debug'' will remove debug info, but will also make it harder for us developers to understand the bugs you might find.

You might want to compile just the remote GUI: the flags would be ''--disable-monolithic --disable-ed2k --enable-amule-gui''

'''Beware:''' The following programs do not work yet on [http://www.microsoft.com/windows Windows]:
*[[aMuled|aMule Daemon]]: Doesn't even compile.
*[[CAS]]: Fails to find the [[signature]] file.

'''Note:''' To keep the size of the binnaries down, you can run ''strip'' from within [http://www.mingw.org/msys.shtml MSys].

== Running ==

To run the binnaries we've created you need ''mingwm10.dll''. This file can be found in ''C:\MinGW\bin\mingwm10.dll'' (or whatever path you used to install [http://www.mingw.org MinGW]).

You now have to place this file in some place so that the binnaries find it when they are executed. Here you have three options:

#Place it in the same folder where the binnaries are (if you have them spread in several different folders, copy this file once into each folder. Since it is a very small file, it is not much of a loss).
#Place it in ''C:\windows'' or some other any other path where [http://www.microsoft.com/windows Windows] might look for libraries (such as ''C:\Windows\System'' or ''C:\Windows\System32'').
#Add ''C:\MinGW\bin'' (or whatever path you used to install [http://www.mingw.org MinGW]) to your ''PATH'' environment variable.

Now... just run your binnaries and have fun with [[aMule]] on your [http://www.microsoft.com/windows Windows] box!

'''Note:''' By default, the binnaries are compiled to ''C:\MSys\1.0\home\'''user'''\amule-2.0.3\src\''.

== Having different languages ==

Now [[aMule]] will be successfully running, but you will not be able to use any other language but default english.

TO be able to choose between any of the lot of languages [[aMule]] is shipped with, from [http://www.mingw.org/msys.shtml MSys] go to [[aMule]]'s extracted folder and then into ''po/'' folder. Something like the following should do it:

cd
cd amule-2.0.3/po

Now install the languages:

make install-data-yes

This language files are now in ''C:\MSys\1.0\local\share\locale'', so exit [http://www.mingw.org/msys.shtml MSys], go to ''C:\msys\1.0\local\share\locale'' and copy that folder to the folder were you are keeping your compiled ''amule.exe'' and ''amulegui.exe'' files.

== Downloading precompiled win32 version ==

'''Keep in mind this is a user contributed build. Install it at your own risk'''

You can download aMuleGUI for win32 from CVS 22-09-2005 here: ed2k://|file|amulegui-win32-cvs22-09-2005(incl.dll+readme).zip|1990063|8553F619C878E3F0C916B7FBF82EB934|h=KFB3RUSI65EE2WMIBWQ2WHXIIUEA57VZ|/

or direct here: [http://s6.11mbit.de/7i5blmw6cmIxc8noy48nJ3deJgL01BLz1ogPvakPv1blHJx3dnJCLr6g/cf784ogC amulegui-win32-cvs22-09-2005(incl.dll+readme).zip] ([https://s6.11mbit.de/7i5blmw6cmIxc8noy48nJ3deJgL01BLz1ogPvakPv1blHJx3dnJCLr6g/cf784ogC SSL])

Comunication on an linux box with amuled and this gui works very good... maybe its a little bit slow, but, its working!

Feel free to contact me at: therealfox AT gmail DOT com, if you have problems.

AMuleWeb

2006-01-20T21:40:29Z

Xaignar: =aMuleWeb with aMule 2.0.0 or later=

== Description ==

aMuleWeb is a utility that listens for [http://www.w3.org/MarkUp HTTP] connections at port 4711 (by default, although it can be changed through '''Preferences''') and allows remote users to control [[aMule]] using just a web browser.

[[aMule]] itself doesn't support listening to [http://www.w3.org/MarkUp HTTP] connections, so the external utility aMuleWeb is used. This utility listens for remote connections, and once the link between aMuleWeb and the remote user is established, it connects to the [[aMule]] main program using the [[External Connections]] mechanism.

== Compiling aMuleWeb ==

[[Compile]] [[aMule]] normally, just add ''--enable-amuleweb'' when running ''configure''.

== Setting up aMuleWeb with [[aMule]] ==

=== aMuleWeb with [[aMule]] 2.0.0 or later ===

*For users running the monotlithic [[aMule]] application:
**Go to "Preferences"->"Remote Controls" (in [[aMule]]) and...
***Enable "Accept External Connections".
***Enable "Use TCP ports instead of unix local sockets" (This option doesn't exist since version 2.1.0)
***Enter a password for [[External Connections]]. If you don't do this, aMuleWeb will not communicate with [[aMule]].
::'''NOTE:''' When you change your aMuleWeb and [[External Connections]] ports here, make sure to restart [[aMule]].

*For users running the [[aMule|aMule daemon]]:
**Shutdown [[aMule|aMuled]] if it is still running.
**Run ''amuleweb -w'' to generate ''~/.aMule/remote.conf'' and edit it for these options. It previously were on ''~/.aMule/amule.conf'', but the lines are still on this file, so edit both if in doubt.
***''[ExternalConnect]'' <- Section header
***''AcceptExternalConnections=1'' <-- To enable [[aMule]] listening for [[External Connections]].
***''ECUseTCPPort=1'' <-- To use the [http://www.faqs.org/faqs/internet/tcp-ip/resource-list TCP] port. Very important since [http://www.unix.org Unix] sockets are disabled.
***''ECPassword=ca3c365274907c6fd527068788e14639'' <-- To find the MD5 string for your password, do:
:::''$ echo -n yourpasswordhere | md5sum | cut -d ' ' -f 1''
:::''ca3c365274907c6fd527068788e14639''
**If you get ''FATAL ERROR: Cannot find template: default'' it's because you didn't run ''make install''. If you don't want to install aMule, copy the ''src/webserver/default/'' directory into ''~/.aMule/webserver/'' (create it if needed). If you want any other template (probably ''php-default''), copy it too. Then go back to the previous step.
**Restart [[aMule|aMuled]]

'''NOTE:''' Every password must be md5sum,also webserver one/s. aMule embedded webserver works without remote.conf,you just need to edit ''amule.conf''. A good trick if you have somewhere an X server is to configure amule using the GUI and then copy the ''amule.conf'' configuration file where you want to run the daemon.

Thanks to [[User:Stefanero|Stefanero]], from who I shamelessly stole a lot from his tutorial.

'''NOTE:''' aMuleWeb uses cookies to hold session id. Make sure that cookies are enabled in your browser.

=== aMuleWeb with [[aMule]] pre-2.0.0 final ===

Please check [[Webserver-old|this page]] for archived instructions (educational purposes!).

== Connecting to aMuleWeb ==

To run aMuleWeb run '''''amuleweb''''' on a terminal.

Once aMuleWeb is running, open a web browser and connect to:

''http://host:port''

where ''host'' stands for your host's name (try with ''localhost'') and port stands for the aMuleWeb port ('''NOT''' the [[External Connections]] port).

For example: ''http://localhost:4711''

''Shakraw''

== Standard ports ==

The ports can be set to anything, but this are the most used (the standard ones):

*[[External Connections]]: 4712
*amuleweb: 4711

Make sure you do not confuse with what each of them is.

== Skin support ==

aMuleWeb now looks for its files in a number of places:
*In your home directory: ''$HOME/.aMule/webserver/''[skin name]''/''
*And at it's install location, in this order (by default, ''/usr/local/share/amule/webserver'' if you compiled [[aMule]], or ''/usr/share/amule/webserver'' if you installed it from a package).

Default skin (template) name is 'default'.

If, '''after installing''' [[aMule]], aMuleWeb refuses to run because of not being able to load template:
*Please report this situation to us, and then
*Create the directories ''webserver/default'' in the ''.aMule'' subdirectory of your home directory, and copy the contents of the ''src/webserver'' directory there from the [[aMule]] tarball (I mean to ''$HOME/.aMule/webserver/default'').

'''[[User:GonoszTopi|GonoszTopi]]'''

== How to start [[aMule Daemon|aMuled]] and aMuleWeb with your computer ==

The best way to start both the processes aMule Daemon and aMuleWeb with your server is to add a shell script ''/etc/init.d/amule'' like this:

PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
DAEMON=/usr/bin/amuled
WEB=/usr/bin/amuleweb
NAME=amuled
DESC=amuled
RUNAMULE=no
USER=youramuleuser

test -x $DAEMON || exit 0

# Include amule defaults if available
if [ -f /etc/default/amule ] ; then
. /etc/default/amule
fi

if [ "$RUNAMULE" != "yes" ];then
echo "Amule not to be started. Edit /etc/default/amule first."
exit 1
fi

set -e

case "$1" in
start)
echo -n "Starting $DESC: "
su $USER -c "$DAEMON -f"
sleep 20
su $USER -c "$WEB --quiet &"
echo "$NAME."
;;
stop)
echo -n "Stopping $DESC: "
killall --quiet --ignore-case $WEB
killall --quiet --ignore-case $DAEMON
echo "$NAME."
;;
restart|force-reload)
echo -n "Restarting $DESC: "
killall --quiet --ignore-case $WEB
killall --quiet --ignore-case $DAEMON
sleep 1
su $USER -c "$DAEMON -f"
sleep 20
su $USER -c "$WEB --quiet &"
echo "$NAME."
;;
*)
N=/etc/init.d/$NAME
echo "Usage: $N {start|stop|restart|force-reload}" >&2
exit 1
;;
esac

exit 0

Then just set that script to be run at start up. On [[Debian]] this would be doen with the following command:

update-rc.d amule defaults

Then, for the deamons to start you just have to create a file ''/etc/default/amule'' which contains a single line:

RUNAMULE=yes

That's it!

== Where to report problems and questions? ==

For Problems or Questions just report on http://forum.amule.org forum or join [[IRC]] channel [irc://irc.freenode.net/amule #amule] at [irc://irc.freenode.net irc.freenode.net]

== Other sources of information ==

Read the aMuleWeb man page, which is available in English, French, German, Hungarian and Spanish.

For further information read the [[FAQ_webserver|aMuleWeb FAQ]].

IRC rules

2006-01-06T14:09:49Z

Xaignar: =What you must do=

== Introduction ==

While you stay at our [[IRC]] channels, we expect you to follow these rules. You are expected to have read and understood this page. Ignorance of these rules is not an excuse.

The most basic of all rules is: '''Have manners.'''

Failure to comply with the rules can result in kicks, temporary bans and even permanent bans depending on the severity of the transgression.

== What you must do ==

* Speak English. For other languages, visit our [http://forum.amule.org forums].
* Since many people speak English as a second language, you should make sure that what you are writing is proper English, and understandable.
* Search before you ask. In many cases, your questions have already been answered before. Places to search include, the [http://forum.amule.org Forums], the [[Main Page|Wiki]] and [http://www.google.com Google].
* Private conversations should be conducted via a query (''/query <nick>'').

== What you must not do ==

* You must not violate any of your contry's laws nor any of the [http://europa.eu.int European Community] laws nor any of the [http://www.firstgov.gov USA] laws nor any of the international laws while staying at any of our channels. Sounds funny? Well, it's not.
* You must not talk about anything that doesn't regard '''directly''' (in the most strict way) to [[aMule]] as an application. Exceptionally, you may ask questions about the [[FAQ_ed2k|ed2k]] and [[Kademlia]] protocols, but an answer is not guaranteed.
* You must not talk, directly or indirectly, about any copyrighted non-free (in the ''beer way'') material.
* You must not provide any URL which's contents break any of our channels rules.
* You must not provide '''any''' [[ed2k link]].
* Do not flood. If you need to share large ammounts of text, use a pastebin service such as [http://www.pastebin.ca pastebin.ca].
* You must not use any bots in the channels unless some channel operator allows you to do so.
* Do not spam. That includes scripts, away-messages, advertising, repeatedly asking the same question, etc.

== Suggestions ==

* Have patience. If nobody is answering your question, it may be because nobody is around to read it, or nobody present knows the answer.
* Use the latest stable [[aMule]] release.
* Distro specific questions, should go the distro's channel or forums. Mostly because we won't know the answer.

== What if a rule is not clear? ==

These rules are made by the channels operators. If you are uncertain about some particular rule or other, you can either assume the worst or ask if you have understood them correctly.

However, since we have not yet merged into a Borg collective, different operators may interprent the rules differently. If an operator confronts you with doing something another operator told you was ok, let the second operator know (including who told you so).

IRC rules

2006-01-06T14:08:31Z

Xaignar: =What you must not do=

== Introduction ==

While you stay at our [[IRC]] channels, we expect you to follow these rules. You are expected to have read and understood this page. Ignorance of these rules is not an excuse.

The most basic of all rules is: '''Have manners.'''

Failure to comply with the rules can result in kicks, temporary bans and even permanent bans depending on the severity of the transgression.

== What you must do ==

* Please go to #macMule if you want to talk/ask about [[aMule]] on [http://macosx.apple.com MacOS X].
* Speak English. For other languages, visit our [http://forum.amule.org forums].
* Since many people speak English as a second language, you should make sure that what you are writing is proper English, and understandable.
* Search before you ask. In many cases, your questions have already been answered before. Places to search include, the [http://forum.amule.org Forums], the [[Main Page|Wiki]] and [http://www.google.com Google].
* Private conversations should be conducted via a query (''/query <nick>'').

== What you must not do ==

* You must not violate any of your contry's laws nor any of the [http://europa.eu.int European Community] laws nor any of the [http://www.firstgov.gov USA] laws nor any of the international laws while staying at any of our channels. Sounds funny? Well, it's not.
* You must not talk about anything that doesn't regard '''directly''' (in the most strict way) to [[aMule]] as an application. Exceptionally, you may ask questions about the [[FAQ_ed2k|ed2k]] and [[Kademlia]] protocols, but an answer is not guaranteed.
* You must not talk, directly or indirectly, about any copyrighted non-free (in the ''beer way'') material.
* You must not provide any URL which's contents break any of our channels rules.
* You must not provide '''any''' [[ed2k link]].
* Do not flood. If you need to share large ammounts of text, use a pastebin service such as [http://www.pastebin.ca pastebin.ca].
* You must not use any bots in the channels unless some channel operator allows you to do so.
* Do not spam. That includes scripts, away-messages, advertising, repeatedly asking the same question, etc.

== Suggestions ==

* Have patience. If nobody is answering your question, it may be because nobody is around to read it, or nobody present knows the answer.
* Use the latest stable [[aMule]] release.
* Distro specific questions, should go the distro's channel or forums. Mostly because we won't know the answer.

== What if a rule is not clear? ==

These rules are made by the channels operators. If you are uncertain about some particular rule or other, you can either assume the worst or ask if you have understood them correctly.

However, since we have not yet merged into a Borg collective, different operators may interprent the rules differently. If an operator confronts you with doing something another operator told you was ok, let the second operator know (including who told you so).

IRC rules

2006-01-06T14:06:42Z

Xaignar:

== Introduction ==

While you stay at our [[IRC]] channels, we expect you to follow these rules. You are expected to have read and understood this page. Ignorance of these rules is not an excuse.

The most basic of all rules is: '''Have manners.'''

Failure to comply with the rules can result in kicks, temporary bans and even permanent bans depending on the severity of the transgression.

== What you must do ==

* Please go to #macMule if you want to talk/ask about [[aMule]] on [http://macosx.apple.com MacOS X].
* Speak English. For other languages, visit our [http://forum.amule.org forums].
* Since many people speak English as a second language, you should make sure that what you are writing is proper English, and understandable.
* Search before you ask. In many cases, your questions have already been answered before. Places to search include, the [http://forum.amule.org Forums], the [[Main Page|Wiki]] and [http://www.google.com Google].
* Private conversations should be conducted via a query (''/query <nick>'').

== What you must not do ==

* You must not violate any of your contry's laws nor any of the [http://europa.eu.int European Community] laws nor any of the [http://www.firstgov.gov USA] laws nor any of the international laws while staying at any of our channels. Sounds funny? Well, it's not.
* You must not talk about anything that doesn't regard '''directly''' (in the most strict way) to [[aMule]] as an application. Exceptionally, you may ask questions about the [[FAQ_ed2k|ed2k]] and [[Kademlia]] protocols, but an answer is not guaranteed.
* You must not talk, directly or indirectly, about any copyrighted non-free (in the ''beer way'') material.
* You must not provide any URL which's contents break any of our channels rules.
* You must not provide '''any''' [[ed2k link]].
* Do not flood. If you need to share large ammounts of text, use a pastebin service such as [http://www.pastebin.ca pastebin.ca].
* You must not use any bots in the channels unless some channel operator allows you to do so.
* You must not insult, flame, blame, begin a war, fight, etc.
* Do not spam. That includes scripts, away-messages, advertising, repeatedly asking the same question, etc.

== Suggestions ==

* Have patience. If nobody is answering your question, it may be because nobody is around to read it, or nobody present knows the answer.
* Use the latest stable [[aMule]] release.
* Distro specific questions, should go the distro's channel or forums. Mostly because we won't know the answer.

== What if a rule is not clear? ==

These rules are made by the channels operators. If you are uncertain about some particular rule or other, you can either assume the worst or ask if you have understood them correctly.

However, since we have not yet merged into a Borg collective, different operators may interprent the rules differently. If an operator confronts you with doing something another operator told you was ok, let the second operator know (including who told you so).

IRC rules

2006-01-06T13:51:03Z

Xaignar: =What you must not do=

== Introduction ==

While you stay at our [[IRC]] channels, we expect you to follow these rules. You are expected to have read and understood this page. Ignorance of these rules is not an excuse.

The most basic of all rules is: '''Have manners.'''

== What you must do ==

* Please go to #macMule if you want to talk/ask about [[aMule]] on [http://macosx.apple.com MacOS X].
* Speak English. For other languages, visit our [http://forum.amule.org forums].
* Since many people speak English as a second language, you should make sure that what you are writing is proper English, and understandable.
* Search before you ask. In many cases, your questions have already been answered before. Places to search include, the [http://forum.amule.org Forums], the [[Main Page|Wiki]] and [http://www.google.com Google].
* Private conversations should be conducted via a query (''/query <nick>'').

== What you must not do ==

* You must not violate any of your contry's laws nor any of the [http://europa.eu.int European Community] laws nor any of the [http://www.firstgov.gov USA] laws nor any of the international laws while staying at any of our channels. Sounds funny? Well, it's not.
* You must not talk about anything that doesn't regard '''directly''' (in the most strict way) to [[aMule]] as an application. Exceptionally, you may ask questions about the [[FAQ_ed2k|ed2k]] and [[Kademlia]] protocols, but an answer is not guaranteed.
* You must not talk, directly or indirectly, about any copyrighted non-free (in the ''beer way'') material.
* You must not talk about any website which breaks any of our channels rules.
* You must not provide any URL which's contents break any of our channels rules.
* You must not provide '''any''' [[ed2k link]].
* You must not do any kind of publicity about anything unless some channel operator allows you to do so.
* Do not flood. If you need to share a large ammount of text, use a pastebin service such as [http://www.pastebin.ca pastebin.ca].
* You must not use any bots in the channels unless some channel operator allows you to do so.
* You must not insult, flame, blame, begin a war, fight, etc.
* Do not spam. That includes scripts, away-messages, advertising, repeatedly asking the same question, etc.

== What you can do ==

You can do anything you wish as long as it is not forbidden in any rule in this article. Anyway, we'd like to make emphasis in some things which you can do in our channels which are sometimes forbidden in many other channels around:

*You can talk to the [[aMule Team]]. They are the official channels, so the Team is hearing. Just wait some time till they read. And make no doubt they will read you.
*You can stay idle as long as you wish.
*You can answer questions to other people even if they weren't asking you, as long as you know what you are talking about and as long as what you answer is what you really believe to be true/right.

== Suggestions ==

*Try to always ask & answer in an objective way.
*If you ask a question, wait for a few hours for an answer. Most of the time people are idle (not in front of the computer), so it may take long till someone reads your question. Just don't leave that fast.
*If you get an answer don't become sceptic about what you are told. Otherwise just don't ask.
*Use the latest stable [[aMule]] release.
*Distro specific questions, even if regarding [[aMule]], should go the distro's channel or forums. Most surely we won't know the answer.
*Now here is '''The BIG Suggestion (c)''': Think, then act.

== What if a rule is not clear? ==

These rules are made by the channels operators.

The only people who know exactly what they mean are them. You must try to understand what operators think the rules mean. And in case of doubt, just stay silent or ask what is meant.

Channel operators may charge on you if they consider you to have broken some rule as interpretated by them. And the interpretation may vary depending on the mood, the phase of the moon, the colour of the clouds, the price of gas and pizza or the size of the bribe.

== Consequences ==

Failure to comply with these rules will result in being kicked from the channel.

Anyone who repeatedly breaks these rules, or who grossly violates the rules will face a ban. The length of the ban depends entirely on our mood.

IRC rules

2006-01-05T19:32:34Z

Xaignar: =What you must not do=

== Introduction ==

While you stay at our [[IRC]] channels, we expect you to follow these rules. You are expected to have read and understood this page. Ignorance of these rules is not an excuse.

The most basic of all rules is: '''Have manners.'''

== What you must do ==

* Please go to #macMule if you want to talk/ask about [[aMule]] on [http://macosx.apple.com MacOS X].
* Speak English. For other languages, visit our [http://forum.amule.org forums].
* Since many people speak English as a second language, you should make sure that what you are writing is proper English, and understandable.
* Search before you ask. In many cases, your questions have already been answered before. Places to search include, the [http://forum.amule.org Forums], the [[Main Page|Wiki]] and [http://www.google.com Google].
* Private conversations should be conducted via a query (''/query <nick>'').

== What you must not do ==

*You must not violate any of your contry's laws nor any of the [http://europa.eu.int European Community] laws nor any of the [http://www.firstgov.gov USA] laws nor any of the international laws while staying at any of our channels. Sounds funny? Well, it's not.
*You must not talk about anything that doesn't regard '''directly''' (in the most strict way) to [[aMule]] as an application. Exceptionally, you may ask questions about the [[FAQ_ed2k|ed2k]] and [[Kademlia]] protocols, but an answer is not guaranteed.
*You must not talk, directly or indirectly, about any copyrighted non-free (in the ''beer way'') material.
*You must not talk about any website which breaks any of our channels rules.
*You must not provide any URL which's contents break any of our channels rules.
*You must not provide '''any''' [[ed2k link]].
*You must not do any kind of publicity about anything unless some channel operator allows you to do so.
*Do not flood. If you need to share a large ammount of text, use a pastebin service such as [http://www.pastebin.ca pastebin.ca].
*Don't ask to ask. Just ask!
*You must not ask anything if you haven't at least tried a little to find out the answer on your own. Did I seay "try a little"? I mean "try as hard as you can".
*You must not use any bots in the channels unless some channel operator allows you to do so.
*You must not insult, flame, blame, begin a war, fight, etc.
* Do not spam. That includes scripts, away-messages, advertising, repeatedly asking the same question, etc.

== What you can do ==

You can do anything you wish as long as it is not forbidden in any rule in this article. Anyway, we'd like to make emphasis in some things which you can do in our channels which are sometimes forbidden in many other channels around:

*You can talk to the [[aMule Team]]. They are the official channels, so the Team is hearing. Just wait some time till they read. And make no doubt they will read you.
*You can stay idle as long as you wish.
*You can answer questions to other people even if they weren't asking you, as long as you know what you are talking about and as long as what you answer is what you really believe to be true/right.

== Suggestions ==

*Try to always ask & answer in an objective way.
*If you ask a question, wait for a few hours for an answer. Most of the time people are idle (not in front of the computer), so it may take long till someone reads your question. Just don't leave that fast.
*If you get an answer don't become sceptic about what you are told. Otherwise just don't ask.
*Use the latest stable [[aMule]] release.
*Distro specific questions, even if regarding [[aMule]], should go the distro's channel or forums. Most surely we won't know the answer.
*Now here is '''The BIG Suggestion (c)''': Think, then act.

== What if a rule is not clear? ==

These rules are made by the channels operators.

The only people who know exactly what they mean are them. You must try to understand what operators think the rules mean. And in case of doubt, just stay silent or ask what is meant.

Channel operators may charge on you if they consider you to have broken some rule as interpretated by them. And the interpretation may vary depending on the mood, the phase of the moon, the colour of the clouds, the price of gas and pizza or the size of the bribe.

== Consequences ==

Failure to comply with these rules will result in being kicked from the channel.

Anyone who repeatedly breaks these rules, or who grossly violates the rules will face a ban. The length of the ban depends entirely on our mood.

IRC rules

2006-01-05T19:28:54Z

Xaignar:

== Introduction ==

While you stay at our [[IRC]] channels, we expect you to follow these rules. You are expected to have read and understood this page. Ignorance of these rules is not an excuse.

The most basic of all rules is: '''Have manners.'''

== What you must do ==

* Please go to #macMule if you want to talk/ask about [[aMule]] on [http://macosx.apple.com MacOS X].
* Speak English. For other languages, visit our [http://forum.amule.org forums].
* Since many people speak English as a second language, you should make sure that what you are writing is proper English, and understandable.
* Search before you ask. In many cases, your questions have already been answered before. Places to search include, the [http://forum.amule.org Forums], the [[Main Page|Wiki]] and [http://www.google.com Google].
* Private conversations should be conducted via a query (''/query <nick>'').

== What you must not do ==

*You must not violate any of your contry's laws nor any of the [http://europa.eu.int European Community] laws nor any of the [http://www.firstgov.gov USA] laws nor any of the international laws while staying at any of our channels. Sounds funny? Well, it's not.
*You must not talk about anything that doesn't regard '''directly''' (in the most strict way) to [[aMule]] as an application. Exceptionally, you may ask questions about the [[FAQ_ed2k|ed2k]] and [[Kademlia]] protocols, but an answer is not guaranteed.
*You must not talk, directly or indirectly, about any copyrighted non-free (in the ''beer way'') material.
*You must not talk about any website which breaks any of our channels rules.
*You must not provide any URL which's contents break any of our channels rules.
*You must not provide '''any''' [[ed2k link]].
*You must not do any kind of publicity about anything unless some channel operator allows you to do so.
*Do not flood. Not even a little. More than three lines in a row will be enough to be considered flooding.
*Don't ask to ask. Just ask!
*You must not ask anything if you haven't at least tried a little to find out the answer on your own. Did I seay "try a little"? I mean "try as hard as you can".
*You must not ask repeatedly for a question. Wait at least an hour before asking again, even if you get answer. Asking the same question using different words won't make the trick either.
*You must not use any ''away message''.
*You must not use any bots in the channels unless some channel operator allows you to do so.
*Do not split whatever you want to say into several different short lines. This is not Instant Messaging. This is IRC. Get used to it.
*You must not use abreviated words or non-standard language.
*You must not type with capital letters nor use more than two exclamation marks in a single line (scream).
*You must not insult, flame, blame, begin a war, fight, etc.
*You may not enter and leave the channel as if you were hiding from someone. Decide whether you want to enter or leave the channel and then do so. Not the other way round.

== What you can do ==

You can do anything you wish as long as it is not forbidden in any rule in this article. Anyway, we'd like to make emphasis in some things which you can do in our channels which are sometimes forbidden in many other channels around:

*You can talk to the [[aMule Team]]. They are the official channels, so the Team is hearing. Just wait some time till they read. And make no doubt they will read you.
*You can stay idle as long as you wish.
*You can answer questions to other people even if they weren't asking you, as long as you know what you are talking about and as long as what you answer is what you really believe to be true/right.

== Suggestions ==

*Try to always ask & answer in an objective way.
*If you ask a question, wait for a few hours for an answer. Most of the time people are idle (not in front of the computer), so it may take long till someone reads your question. Just don't leave that fast.
*If you get an answer don't become sceptic about what you are told. Otherwise just don't ask.
*Use the latest stable [[aMule]] release.
*Distro specific questions, even if regarding [[aMule]], should go the distro's channel or forums. Most surely we won't know the answer.
*Now here is '''The BIG Suggestion (c)''': Think, then act.

== What if a rule is not clear? ==

These rules are made by the channels operators.

The only people who know exactly what they mean are them. You must try to understand what operators think the rules mean. And in case of doubt, just stay silent or ask what is meant.

Channel operators may charge on you if they consider you to have broken some rule as interpretated by them. And the interpretation may vary depending on the mood, the phase of the moon, the colour of the clouds, the price of gas and pizza or the size of the bribe.

== Consequences ==

Failure to comply with these rules will result in being kicked from the channel.

Anyone who repeatedly breaks these rules, or who grossly violates the rules will face a ban. The length of the ban depends entirely on our mood.

IRC rules

2006-01-05T19:26:39Z

Xaignar:

== Introduction ==

While you stay at our [[IRC]] channels, we expect you to follow these rules. You are expected to have read and understood this page. Ignorance of these rules is not an excuse.

The most basic of all rules is: Have manners.

Note that since many people speak English as a second language, you should make sure that what you are writing is proper English, and understandable.

== What you must do ==

*Please go to #macMule if you want to talk/ask about [[aMule]] on [http://macosx.apple.com MacOS X].
*Speak English. For other languages, visit our [http://forum.amule.org forums].
*Search before you ask. In many cases, your questions have already been answered before. Places to search include, the [http://forum.amule.org Forums], the [[Main Page|Wiki]] and [http://www.google.com Google].
* Private conversations should be conducted via a query (''/query <nick>'').

== What you must not do ==

*You must not violate any of your contry's laws nor any of the [http://europa.eu.int European Community] laws nor any of the [http://www.firstgov.gov USA] laws nor any of the international laws while staying at any of our channels. Sounds funny? Well, it's not.
*You must not talk about anything that doesn't regard '''directly''' (in the most strict way) to [[aMule]] as an application. Exceptionally, you may ask questions about the [[FAQ_ed2k|ed2k]] and [[Kademlia]] protocols, but an answer is not guaranteed.
*You must not talk, directly or indirectly, about any copyrighted non-free (in the ''beer way'') material.
*You must not talk about any website which breaks any of our channels rules.
*You must not provide any URL which's contents break any of our channels rules.
*You must not provide '''any''' [[ed2k link]].
*You must not do any kind of publicity about anything unless some channel operator allows you to do so.
*Do not flood. Not even a little. More than three lines in a row will be enough to be considered flooding.
*Don't ask to ask. Just ask!
*You must not ask anything if you haven't at least tried a little to find out the answer on your own. Did I seay "try a little"? I mean "try as hard as you can".
*You must not ask repeatedly for a question. Wait at least an hour before asking again, even if you get answer. Asking the same question using different words won't make the trick either.
*You must not use any ''away message''.
*You must not use any bots in the channels unless some channel operator allows you to do so.
*Do not split whatever you want to say into several different short lines. This is not Instant Messaging. This is IRC. Get used to it.
*You must not use abreviated words or non-standard language.
*You must not type with capital letters nor use more than two exclamation marks in a single line (scream).
*You must not insult, flame, blame, begin a war, fight, etc.
*You may not enter and leave the channel as if you were hiding from someone. Decide whether you want to enter or leave the channel and then do so. Not the other way round.

== What you can do ==

You can do anything you wish as long as it is not forbidden in any rule in this article. Anyway, we'd like to make emphasis in some things which you can do in our channels which are sometimes forbidden in many other channels around:

*You can talk to the [[aMule Team]]. They are the official channels, so the Team is hearing. Just wait some time till they read. And make no doubt they will read you.
*You can stay idle as long as you wish.
*You can answer questions to other people even if they weren't asking you, as long as you know what you are talking about and as long as what you answer is what you really believe to be true/right.

== Suggestions ==

*Try to always ask & answer in an objective way.
*If you ask a question, wait for a few hours for an answer. Most of the time people are idle (not in front of the computer), so it may take long till someone reads your question. Just don't leave that fast.
*If you get an answer don't become sceptic about what you are told. Otherwise just don't ask.
*Use the latest stable [[aMule]] release.
*Distro specific questions, even if regarding [[aMule]], should go the distro's channel or forums. Most surely we won't know the answer.
*Now here is '''The BIG Suggestion (c)''': Think, then act.

== What if a rule is not clear? ==

These rules are made by the channels operators.

The only people who know exactly what they mean are them. You must try to understand what operators think the rules mean. And in case of doubt, just stay silent or ask what is meant.

Channel operators may charge on you if they consider you to have broken some rule as interpretated by them. And the interpretation may vary depending on the mood, the phase of the moon, the colour of the clouds, the price of gas and pizza or the size of the bribe.

== Consequences ==

Failure to comply with these rules will result in being kicked from the channel.

Anyone who repeatedly breaks these rules, or who grossly violates the rules will face a ban. The length of the ban depends entirely on our mood.

IRC rules

2006-01-05T19:06:04Z

Xaignar: =Consequences=

== Introduction ==

While you stay at our [[IRC]] channels, you '''must''' follow some rules.

Most of them are basic ethic rules which, for some reason, some people fail to understand. Others are not so intuitive. There for, everybody '''must''' read this article '''before''' entering our IRC channel.

Just keep reading.

== What you must do ==

*You must read topic (''/topic #<channel>'') '''before''' saying anything.
*You must read this article from the beginning to the end '''before entering''' the channel. Did I say "read"? I meant "'''understand'''"!
*You must go to #macMule if you want to talk/ask about [[aMule]] on [http://macosx.apple.com MacOS X].
*You must go to #aMule if you want to talk/ask about [[aMule]] on any platform but on [http://macosx.apple.com MacOS X].
*You must speak english in our channels. They are english speaking channels.
*You must look for an answer in [http://forum.amule.org aMule's Forums] and in [[Main Page|this wiki]] before asking anything.
*You must read twice and, before talking, make sure you understand what other people write.
*You must read twice what you write before sending your message.
*You must stay in the channel for at least 30 minutes if you ask something. We hate people who just want their questoins to be answered right after they ask, in 0-time.
*If you want to talk specifically to someone, open a query (''/query <nick>''). Do not flood the channel with your private conversation unless you believe the conversation may make the knowledge of the rest of the people in the channel richer.

== What you must not do ==

*You must not violate any of your contry's laws nor any of the [http://europa.eu.int European Community] laws nor any of the [http://www.firstgov.gov USA] laws nor any of the international laws while staying at any of our channels. Sounds funny? Well, it's not.
*You must not talk about anything that doesn't regard '''directly''' (in the most strict way) to [[aMule]] as an application. Exceptionally, you may ask questions about the [[FAQ_ed2k|ed2k]] and [[Kademlia]] protocols, but an answer is not guaranteed.
*You must not talk, directly or indirectly, about any copyrighted non-free (in the ''beer way'') material.
*You must not talk about any website which breaks any of our channels rules.
*You must not provide any URL which's contents break any of our channels rules.
*You must not provide '''any''' [[ed2k link]].
*You must not do any kind of publicity about anything unless some channel operator allows you to do so.
*Do not flood. Not even a little. More than three lines in a row will be enough to be considered flooding.
*Don't ask to ask. Just ask!
*You must not ask anything if you haven't at least tried a little to find out the answer on your own. Did I seay "try a little"? I mean "try as hard as you can".
*You must not ask repeatedly for a question. Wait at least an hour before asking again, even if you get answer. Asking the same question using different words won't make the trick either.
*You must not use any ''away message''.
*You must not use any bots in the channels unless some channel operator allows you to do so.
*Do not split whatever you want to say into several different short lines. This is not Instant Messaging. This is IRC. Get used to it.
*You must not use abreviated words or non-standard language.
*You must not type with capital letters nor use more than two exclamation marks in a single line (scream).
*You must not insult, flame, blame, begin a war, fight, etc.
*You may not enter and leave the channel as if you were hiding from someone. Decide whether you want to enter or leave the channel and then do so. Not the other way round.

== What you can do ==

You can do anything you wish as long as it is not forbidden in any rule in this article. Anyway, we'd like to make emphasis in some things which you can do in our channels which are sometimes forbidden in many other channels around:

*You can talk to the [[aMule Team]]. They are the official channels, so the Team is hearing. Just wait some time till they read. And make no doubt they will read you.
*You can stay idle as long as you wish.
*You can answer questions to other people even if they weren't asking you, as long as you know what you are talking about and as long as what you answer is what you really believe to be true/right.

== Suggestions ==

*Try to always ask & answer in an objective way.
*If you ask a question, wait for a few hours for an answer. Most of the time people are idle (not in front of the computer), so it may take long till someone reads your question. Just don't leave that fast.
*If you get an answer don't become sceptic about what you are told. Otherwise just don't ask.
*Use the latest stable [[aMule]] release.
*Distro specific questions, even if regarding [[aMule]], should go the distro's channel or forums. Most surely we won't know the answer.
*Now here is '''The BIG Suggestion (c)''': Think, then act.

== What if a rule is not clear? ==

These rules are made by the channels operators.

The only people who know exactly what they mean are them. You must try to understand what operators think the rules mean. And in case of doubt, just stay silent or ask what is meant.

Channel operators may charge on you if they consider you to have broken some rule as interpretated by them. And the interpretation may vary depending on the mood, the phase of the moon, the colour of the clouds, the price of gas and pizza or the size of the bribe.

== Consequences ==

Failure to comply with these rules will result in being kicked from the channel.

Anyone who repeatedly breaks these rules, or who grossly violates the rules will face a ban. The length of the ban depends entirely on our mood.

IRC rules

2006-01-05T19:02:50Z

Xaignar: =What if a rule is not clear?=

== Introduction ==

While you stay at our [[IRC]] channels, you '''must''' follow some rules.

Most of them are basic ethic rules which, for some reason, some people fail to understand. Others are not so intuitive. There for, everybody '''must''' read this article '''before''' entering our IRC channel.

Just keep reading.

== What you must do ==

*You must read topic (''/topic #<channel>'') '''before''' saying anything.
*You must read this article from the beginning to the end '''before entering''' the channel. Did I say "read"? I meant "'''understand'''"!
*You must go to #macMule if you want to talk/ask about [[aMule]] on [http://macosx.apple.com MacOS X].
*You must go to #aMule if you want to talk/ask about [[aMule]] on any platform but on [http://macosx.apple.com MacOS X].
*You must speak english in our channels. They are english speaking channels.
*You must look for an answer in [http://forum.amule.org aMule's Forums] and in [[Main Page|this wiki]] before asking anything.
*You must read twice and, before talking, make sure you understand what other people write.
*You must read twice what you write before sending your message.
*You must stay in the channel for at least 30 minutes if you ask something. We hate people who just want their questoins to be answered right after they ask, in 0-time.
*If you want to talk specifically to someone, open a query (''/query <nick>''). Do not flood the channel with your private conversation unless you believe the conversation may make the knowledge of the rest of the people in the channel richer.

== What you must not do ==

*You must not violate any of your contry's laws nor any of the [http://europa.eu.int European Community] laws nor any of the [http://www.firstgov.gov USA] laws nor any of the international laws while staying at any of our channels. Sounds funny? Well, it's not.
*You must not talk about anything that doesn't regard '''directly''' (in the most strict way) to [[aMule]] as an application. Exceptionally, you may ask questions about the [[FAQ_ed2k|ed2k]] and [[Kademlia]] protocols, but an answer is not guaranteed.
*You must not talk, directly or indirectly, about any copyrighted non-free (in the ''beer way'') material.
*You must not talk about any website which breaks any of our channels rules.
*You must not provide any URL which's contents break any of our channels rules.
*You must not provide '''any''' [[ed2k link]].
*You must not do any kind of publicity about anything unless some channel operator allows you to do so.
*Do not flood. Not even a little. More than three lines in a row will be enough to be considered flooding.
*Don't ask to ask. Just ask!
*You must not ask anything if you haven't at least tried a little to find out the answer on your own. Did I seay "try a little"? I mean "try as hard as you can".
*You must not ask repeatedly for a question. Wait at least an hour before asking again, even if you get answer. Asking the same question using different words won't make the trick either.
*You must not use any ''away message''.
*You must not use any bots in the channels unless some channel operator allows you to do so.
*Do not split whatever you want to say into several different short lines. This is not Instant Messaging. This is IRC. Get used to it.
*You must not use abreviated words or non-standard language.
*You must not type with capital letters nor use more than two exclamation marks in a single line (scream).
*You must not insult, flame, blame, begin a war, fight, etc.
*You may not enter and leave the channel as if you were hiding from someone. Decide whether you want to enter or leave the channel and then do so. Not the other way round.

== What you can do ==

You can do anything you wish as long as it is not forbidden in any rule in this article. Anyway, we'd like to make emphasis in some things which you can do in our channels which are sometimes forbidden in many other channels around:

*You can talk to the [[aMule Team]]. They are the official channels, so the Team is hearing. Just wait some time till they read. And make no doubt they will read you.
*You can stay idle as long as you wish.
*You can answer questions to other people even if they weren't asking you, as long as you know what you are talking about and as long as what you answer is what you really believe to be true/right.

== Suggestions ==

*Try to always ask & answer in an objective way.
*If you ask a question, wait for a few hours for an answer. Most of the time people are idle (not in front of the computer), so it may take long till someone reads your question. Just don't leave that fast.
*If you get an answer don't become sceptic about what you are told. Otherwise just don't ask.
*Use the latest stable [[aMule]] release.
*Distro specific questions, even if regarding [[aMule]], should go the distro's channel or forums. Most surely we won't know the answer.
*Now here is '''The BIG Suggestion (c)''': Think, then act.

== What if a rule is not clear? ==

These rules are made by the channels operators.

The only people who know exactly what they mean are them. You must try to understand what operators think the rules mean. And in case of doubt, just stay silent or ask what is meant.

Channel operators may charge on you if they consider you to have broken some rule as interpretated by them. And the interpretation may vary depending on the mood, the phase of the moon, the colour of the clouds, the price of gas and pizza or the size of the bribe.

== Consequences ==

Anyone who doesn't follow one or more of the above rules will be kicked from the channel.

Anyone repeatedly breaking this rules will have to face a ban. There is no rule for ban periods: it depends on our mood in which we are :->

If someone severely breaks some rule, even if it isn't repeatedly, it could also be punished with a ban.

IRC rules

2006-01-05T19:02:16Z

Xaignar: =What if a rule is not clear?=

== Introduction ==

While you stay at our [[IRC]] channels, you '''must''' follow some rules.

Most of them are basic ethic rules which, for some reason, some people fail to understand. Others are not so intuitive. There for, everybody '''must''' read this article '''before''' entering our IRC channel.

Just keep reading.

== What you must do ==

*You must read topic (''/topic #<channel>'') '''before''' saying anything.
*You must read this article from the beginning to the end '''before entering''' the channel. Did I say "read"? I meant "'''understand'''"!
*You must go to #macMule if you want to talk/ask about [[aMule]] on [http://macosx.apple.com MacOS X].
*You must go to #aMule if you want to talk/ask about [[aMule]] on any platform but on [http://macosx.apple.com MacOS X].
*You must speak english in our channels. They are english speaking channels.
*You must look for an answer in [http://forum.amule.org aMule's Forums] and in [[Main Page|this wiki]] before asking anything.
*You must read twice and, before talking, make sure you understand what other people write.
*You must read twice what you write before sending your message.
*You must stay in the channel for at least 30 minutes if you ask something. We hate people who just want their questoins to be answered right after they ask, in 0-time.
*If you want to talk specifically to someone, open a query (''/query <nick>''). Do not flood the channel with your private conversation unless you believe the conversation may make the knowledge of the rest of the people in the channel richer.

== What you must not do ==

*You must not violate any of your contry's laws nor any of the [http://europa.eu.int European Community] laws nor any of the [http://www.firstgov.gov USA] laws nor any of the international laws while staying at any of our channels. Sounds funny? Well, it's not.
*You must not talk about anything that doesn't regard '''directly''' (in the most strict way) to [[aMule]] as an application. Exceptionally, you may ask questions about the [[FAQ_ed2k|ed2k]] and [[Kademlia]] protocols, but an answer is not guaranteed.
*You must not talk, directly or indirectly, about any copyrighted non-free (in the ''beer way'') material.
*You must not talk about any website which breaks any of our channels rules.
*You must not provide any URL which's contents break any of our channels rules.
*You must not provide '''any''' [[ed2k link]].
*You must not do any kind of publicity about anything unless some channel operator allows you to do so.
*Do not flood. Not even a little. More than three lines in a row will be enough to be considered flooding.
*Don't ask to ask. Just ask!
*You must not ask anything if you haven't at least tried a little to find out the answer on your own. Did I seay "try a little"? I mean "try as hard as you can".
*You must not ask repeatedly for a question. Wait at least an hour before asking again, even if you get answer. Asking the same question using different words won't make the trick either.
*You must not use any ''away message''.
*You must not use any bots in the channels unless some channel operator allows you to do so.
*Do not split whatever you want to say into several different short lines. This is not Instant Messaging. This is IRC. Get used to it.
*You must not use abreviated words or non-standard language.
*You must not type with capital letters nor use more than two exclamation marks in a single line (scream).
*You must not insult, flame, blame, begin a war, fight, etc.
*You may not enter and leave the channel as if you were hiding from someone. Decide whether you want to enter or leave the channel and then do so. Not the other way round.

== What you can do ==

You can do anything you wish as long as it is not forbidden in any rule in this article. Anyway, we'd like to make emphasis in some things which you can do in our channels which are sometimes forbidden in many other channels around:

*You can talk to the [[aMule Team]]. They are the official channels, so the Team is hearing. Just wait some time till they read. And make no doubt they will read you.
*You can stay idle as long as you wish.
*You can answer questions to other people even if they weren't asking you, as long as you know what you are talking about and as long as what you answer is what you really believe to be true/right.

== Suggestions ==

*Try to always ask & answer in an objective way.
*If you ask a question, wait for a few hours for an answer. Most of the time people are idle (not in front of the computer), so it may take long till someone reads your question. Just don't leave that fast.
*If you get an answer don't become sceptic about what you are told. Otherwise just don't ask.
*Use the latest stable [[aMule]] release.
*Distro specific questions, even if regarding [[aMule]], should go the distro's channel or forums. Most surely we won't know the answer.
*Now here is '''The BIG Suggestion (c)''': Think, then act.

== What if a rule is not clear? ==

These rules are made by the channels operators.

The only people who know exactly what they mean are them. You must try to understand what operators think the rules mean. And in case of doubt, just stay silent or ask what is meant.

Channel operators may charge on you if they consider you to have broken some rule as interpretated by them. And the interpretation may vary depending on the mood, the phase of the moon, the colour of the clouds or the price of gas and pizza or the size of the bribe.

== Consequences ==

Anyone who doesn't follow one or more of the above rules will be kicked from the channel.

Anyone repeatedly breaking this rules will have to face a ban. There is no rule for ban periods: it depends on our mood in which we are :->

If someone severely breaks some rule, even if it isn't repeatedly, it could also be punished with a ban.

HopeSeekr

2005-11-25T15:38:44Z

Xaignar:

The primary developer of the [[lMule]] fork, [[xMule]]. A.K.A Un-Thesis | unthesis.

Main Page

2005-11-15T21:16:20Z

Xaignar: "-rcX" to "Release Candidates"

{|
| align="center" | [[AMule_Project_FAQ:About|http://www.amule.org/images/logo.gif]]

<h1>Welcome to the [http://wiki.org/wiki.cgi?WhatIsWiki Wiki] of the [[AMule_Project_FAQ:About|aMule Project]]</h1>
{| align="center"
| align="center" | We hope you will find answers for your aMule questions and problems!
|-
| align="right" | ''-- The [[aMule_devs|aMule Team]] --''
|-
| align="center" | <h3>'''English''' | [[Main_Page-es|Español]] | [[Main_Page-nl|Nederlands]] | [[Main_Page-ko_KR|Korean]]</h3>
|}
|-
| align="left" |
{|
| valign="top" |
== Installation ==
* HOWTO [[Compilation Installation|Compile and install aMule from source]] ([[Compilation Installation-fr|French]]) ([[Compilation Installation-nl|Dutch]]) ([[Compilation Installation-br|Portuguese]])
* HOWTO [[Install-amule-freebsd|Compile aMule on FreeBSD]]
* HOWTO [[HowTo_compile_on_Mac|Compile aMule on Mac]]
* HOWTO [[HowTo_compile_on_Solaris|Compile aMule on Solaris]]
* HOWTO [[HowTo compile on Win32|Compile aMule on Windows]] ([[HowTo compile on Win32-de|German]])
* HOWTO [[HowTo_Compile_In_Debian|Compile aMule on Debian or Ubuntu]] ([[HowTo_Compile_In_Debian-es|Spanish]])
* HOWTO [[HowTo_Compile_In_Gentoo|Compile aMule on Gentoo]] ([[HowTo_Compile_In_Gentoo-es|Spanish]])
* HOWTO [[HowTo_Compile_In_Slackware|Compile aMule on Slackware]]
* HOWTO [[HowTo_Compile_In_RedHat-Fedora|Compile aMule on RedHat/Fedora]]
* HOWTO [[HowTo_Compile_In_FC3|Compile aMule on Fedora Core 3 and 4]]
* HOWTO [[HowTo_Compile_In_MDK|Install aMule on Mandrake 10]] ([[HowTo_Compile_In_MDK-es|Spanish]]) ([[MDK10_install-fr|French]])
* HOWTO [[SuSE_9.2_install_at_home|Compile aMule on SuSE 9.2 in your home directory]] ([[SuSE 9.2 install at home-es|Spanish]])
* HOWTO [[SuSE_9.3_install_at_home|Compile aMule on SuSE 9.3 in your home directory]]
* HOWTO [[HowTo_Compile_aMuled|Compile the aMule daemon (aMuled)]] ([[HowTo Compile aMuled-es|Spanish]])

== Other ==
* About [[AMule_Project_FAQ:About|aMule's features]] ([[aMule-hu|Hungarian]]) ([[aMule-es|Spanish]]) ([[aMule-de|German]])
* HOWTO [[How_to_launch_VNC_with_aMule_at_Linux_boot|Launch VNC with aMule at Linux boot]]
* HOWTO [[Check if wx is installed twice|Check if wxWidgets is installed twice]] ([[Check if wx is installed twice-br|Portuguese]]) ([[Check if wx is installed twice-es|Spanish]])
* HOWTO [[How_to_uninstall_wxWidgets|Uninstall wxWidgets]] ([[How to uninstall wxWidgets-es|Spanish]])
* Get [[wx-cvs|wxWidgets CVS]] ([[Wx-cvs-es|Spanish]])
* About [[webcache]]
* User [[geaiez]] ([[Geaiez-es|Spanish]])
* Some [[reviews]]
* Test [[test port|your ports]]
* Read [[current events]] ([[current events-es|Spanish]])
* Watch the [[Releases|release graphs]]
* Our [[IRC rules]]
* HOWTO [[aMule_Project_FAQ:Help|Edit a Wiki page]]

== Changelogs: ==
* [[Changelog_latest|Latest aMule release]]
* [[Changelog 2.0_series|aMule 2.0.X]]
** [[Changelog 2.0.3|aMule 2.0.3]]
** [[Changelog 2.0.2|aMule 2.0.2]]
** [[Changelog 2.0.1|aMule 2.0.1]]
** [[Changelog 2.0.0|aMule 2.0.0]]
* [[Changelog 2.0.0-rc_series|aMule 2.0.0 Release Candidates]]
* [[Changelog_1.2_series|aMule 1.2.X]]
* [[Changelog_1.1_series|aMule 1.1.X]]
* [[Changelog_1.0_series|aMule 1.0.X]]
| width="10px" | ||
| valign="top" |

== Usage ==
* Help [[Getting_Started|Getting Started With aMule]] ([[Getting_Started-fr|French]]) ([[Getting Started-nl|Dutch]]) ([[Getting Started-es|Spanish]]) ([[Getting Started-de|German]]) ([[Getting Started-hu|Hungarian]])
* Help [[aMule_problems|Common problems]] ([[aMule_problems-es|Spanish]]) ([[AMule_problems-nl|Dutch]]) ([[AMule_problems-hu|Hungarian]])
* Help [[aMule is slow]]? ([[AMule_is_slow-it|Italian]]) ([[AMule_is_slow-nl|Dutch]]) ([[aMule is slow-es|Spanish]]) ([[aMule is slow-hu|Hungarian]]) ([[aMule is slow-de|German]])
* Help [[aMule makes everything slow]]? ([[aMule_makes_everything_slow-nl|Dutch]]) ([[AMule makes everything slow-es|Spanish]]) ([[AMule makes everything slow-hu|Hungarian]])
* Info [[aMule files|aMule's files]] ([[AMule_files-nl|Dutch]]) ([[AMule_files-de|German]]) ([[AMule_files-hu|Hungarian]])
* HOWTO [[How_to_use_auxiliary_server_ports|use auxiliary server ports]] ([[How_to_use_auxiliary_server_ports-nl|Dutch]])

== FAQs: ==
* FAQ [[FAQ_aMule|on aMule]] ([[FAQ aMule-es|Spanish]]) ([[FAQ aMule-it|Italian]]) ([[FAQ_aMule-pt_BR|Portuguese]]) ([[FAQ aMule-fr|French]]) ([[FAQ aMule-de|German]]) ([[FAQ aMule-nl|Dutch]])
* FAQ [[FAQ_utils|on aMule's utilities]] ([[FAQ_utils-es|Spanish]])
* FAQ [[FAQ_ed2k|on ED2K-Kademlia]] ([[FAQ_ed2k-es|Spanish]]) ([[FAQ_ed2k-it|Italian]]) ([[FAQ_ed2k-de|German]]) ([[FAQ_ed2k-fr|French]]) ([[FAQ_eD2k-Kademlia-nl|Dutch]])
* FAQ on the [[FAQ_network|Transfer Rates on the eDonkey Network]]

== Setup tips ==
* HOWTO [[Migrate from eMule to aMule]]
* HOWTO [[Ed2k links handling|Handle ed2k:// links]]
* HOWTO [[Debian_fonts|Address font issue on Debian]] ([[Debian_fonts-es|Spanish]])
* HOWTO [[import-export files|Import and export files]]
* HOWTO [[Firewall|Setup firewall rules for aMule]] ([[Firewall-es|Spanish]])
* HOWTO [[aMuleWeb|Setup aMule's Webserver (aMuleWeb)]]

== Development ==
* Download the latest [[aMule CVS]] ([[AMule CVS-es|Spanish]])
* Download the latest [[Win32_binary|Windows aMule Installer]]
* About the [[aMule_devs|aMule Development Team]] and [[aMule_devs#Helping|joining it]]
* HOWTO [[Backtraces|Create useful backtraces]]
* HOWTO [[Using gdb and valgrind|Use GDB and Valgrind]]
* HOWTO [[Using_another_wxinstall|Use more than one wxWidgets]] ([[Using_another_wxinstall-de|German]]) ([[Using_another_wxinstall-es|Spanish]])
* Rules of [[coding style]]
* Running a [[testing field]]
* HOWTO [[Report a bug]]
* The [[GNU_FDL|GNU General Public License]]

== Translations ==
* HOWTO [[Translations|Translate aMule into your native language]] ([[Translations-pt|Portuguese]])
* HOWTO [[Translating Wiki|Translate this Wiki]] ([[Translating Wiki-pt_BR|Portuguese]]) ([[Translating Wiki-es|Spanish]]) ([[Translating Wiki-de|German]]) ([[Translating Wiki-fr|French]])
|}
|}

Ed2k link

2005-11-14T14:28:55Z

Xaignar: More clarification on links, added examples.

== [[FAQ_eD2k-Kademlia|eD2k]] links ==

[[FAQ_eD2k-Kademlia|eD2k]] links are links which refer to some file or server in the [[FAQ_eD2k-Kademlia|eD2k network]].

They have the follwing format:

''ed2k://|TYPE|REST-OF-FIELDS|/''

Note that each field is separated from the others by a pipe character (''|'').

This are the meanings of each field:

*''ed2k://'' -> This is the protocol handler. It shows that the link refers to an [[FAQ_eD2k-Kademlia|eD2k]] file.
*TYPE -> This indicates the kind of link it is. It's value might be ''file'' when it refers to a file, or ''server'' when it refers to a server.
*REST-OF-FIELDS -> This fields will depend on the type of link it is (describbed below).

== [[File]] links ==

This links add a file to your download list.

They have the follwing format:

''ed2k://|file|NAME|SIZE|[[MD4_hash|MD4-HASH]]|/''

*NAME -> This will contain the name of the file the link is refering to.
*SIZE -> This field contains the size of the file in bytes.
*[[MD4_hash|MD4-HASH]] -> This field contains the [[MD4_hash|MD4-Hash]] of the file.

Aditionally, some other fields can be added after the [[MD4_hash|MD4-HASH]] field. Here are some (this fields are extensible depending on the client you are using):
*PartHashes -> It will show the [[MD4_hash|MD4 hash]] of each [[FAQ_eD2k-Kademlia#What_is_a_chunk?|chunk]] in the file. It's format is ''p='''hash1''':'''hash2''':'''hash3''''' with as many hashes as the file needs.
*Sources -> It informs about possible known [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] of the file. It's format is "''sources,'''IP:Port''','''IP:Port''','''IP:Port'''''" with as many sources as desired. Note that a hostname may be specified instead of an IP address. Also note that that source fields differ from other types of fields, see the syntax in the example below.
*URLs -> It may happen that the file in the link can be downloaded from some URL. In such cases, it can be told in the link by putting a field like ''s=URL'' and if more than one URL must be written, each will be indicated in a separate field.
*Root Hash -> The [[Root Hash]] of the file (please read about [[AICH]] to know what a [[Root Hash]] is) may be specified in the link by putting a filed like ''h=RootHash''

Examples:
''ed2k://|file|NAME|SIZE|[[MD4_hash|MD4-HASH]]|p=HASH1:HASH2:...|/''
''ed2k://|file|NAME|SIZE|[[MD4_hash|MD4-HASH]]|h=HASH|/''
''ed2k://|file|NAME|SIZE|[[MD4_hash|MD4-HASH]]|/|sources,<IP:Port>,<IP:Port>,...|/''

== Server links ==

This links add a server (the specified server in the server link) to your serverlist.

They have the follwing format:

''ed2k://|server|IP|PORT|/''

*IP -> IP of the server to connect to.
*PORT -> Port where the server is listening for incomming [[FAQ_eD2k-Kademlia|eD2k]] connections

== Serverlist links ==

This links add a whole serverlist to your current serverlist if you had one. It will just be used as your serverlist if you had no preious serverlist.

They have the follwing format:

''ed2k://|serverlist|ADDRESS|/''

*ADDRESS -> Full address to the serverlist file (including the serverlist's filename).

Ed2k link

2005-11-14T13:53:26Z

Xaignar: Clarify the "sources" part of file links.

Ed2k link

2005-11-14T13:52:28Z

Xaignar: Reverted edit of Xaignar, changed back to last version by DeltaHF

Ed2k link

2005-11-14T13:51:12Z

Xaignar: =eD2k links=

== [[FAQ_eD2k-Kademlia|eD2k]] links ==

[[FAQ_eD2k-Kademlia|eD2k]] links are links which refer to some file or server in the [[FAQ_eD2k-Kademlia|eD2k network]].

They have the follwing format:

''ed2k://|TYPE|REST-OF-FIELDS|/''

Note that each field is separated from the others by a pipe character (''|'').

This are the meanings of each field:

*''ed2k://'' -> This is the protocol handler. It shows that the link refers to an [[FAQ_eD2k-Kademlia|eD2k]] file.
*TYPE -> This indicates the kind of link it is. It's value might be ''file'' when it refers to a file, or ''server'' when it refers to a server.
*REST-OF-FIELDS -> This fields will depend on the type of link it is (describbed below).

== [[FAQ_eD2k-Kademlia|eD2k]] links ==

[[FAQ_eD2k-Kademlia|eD2k]] links are links which refer to some file or server in the [[FAQ_eD2k-Kademlia|eD2k network]].

They have the follwing format:

''ed2k://|TYPE|REST-OF-FIELDS|/''

Note that each field is separated from the others by a pipe character (''|'').

This are the meanings of each field:

*''ed2k://'' -> This is the protocol handler. It shows that the link refers to an [[FAQ_eD2k-Kademlia|eD2k]] file.
*TYPE -> This indicates the kind of link it is. It's value might be ''file'' when it refers to a file, or ''server'' when it refers to a server.
*REST-OF-FIELDS -> This fields will depend on the type of link it is (describbed below).

== File links ==

This links add a file to your download list.

They have the follwing format:

''ed2k://|file|NAME|SIZE|[[MD4_hash|MD4-HASH]]|/''

*NAME -> This will contain the name of the file the link is refering to.
*SIZE -> This field contains the size of the file in bytes.
*[[MD4_hash|MD4-HASH]] -> This field contains the [[MD4_hash|MD4-Hash]] of the file.

Adittionally, some other fields can be added after the [[MD4_hash|MD4-HASH]] field. Here are some (this fields are extensible depending on the client you are using):
*PartHashes -> It will show the [[MD4_hash|MD4 hash]] of each [[FAQ_eD2k-Kademlia#What_is_a_chunk?|chunk]] in the file. It's format is ''p='''hash1''':'''hash2''':'''hash3''''' with as many hashes as the file needs.
*Sources -> It informs about possible known [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] of the file. It's format is ''sources,'''source1-IP''':'''source1-Port''','''source2-IP''':'''source2-Port''','''source3-IP''':'''source3-Port''''' with as many sources as desired.
*URLs -> It may happen that the file in the link can be downloaded from some URL. In such cases, it can be told in the link by putting a field like ''s=URL'' and if more than one URL must be written, each will be indicated in a separate field.
*Root Hash -> The [[Root Hash]] of the file (please read about [[AICH]] to know what a [[Root Hash]] is) may be specified in the link by putting a filed like ''h=RootHash''

== Server links ==

This links add a server (the specified server in the server link) to your serverlist.

They have the follwing format:

''ed2k://|server|IP|PORT|/''

*IP -> IP of the server to connect to.
*PORT -> Port where the server is listening for incomming [[FAQ_eD2k-Kademlia|eD2k]] connections

== Serverlist links ==

This links add a whole serverlist to your current serverlist if you had one. It will just be used as your serverlist if you had no preious serverlist.

They have the follwing format:

''ed2k://|serverlist|ADDRESS|/''

*ADDRESS -> Full address to the serverlist file (including the serverlist's filename).

== Server links ==

This links add a server (the specified server in the server link) to your serverlist.

They have the follwing format:

''ed2k://|server|IP|PORT|/''

*IP -> IP of the server to connect to.
*PORT -> Port where the server is listening for incomming [[FAQ_eD2k-Kademlia|eD2k]] connections

== Serverlist links ==

This links add a whole serverlist to your current serverlist if you had one. It will just be used as your serverlist if you had no preious serverlist.

They have the follwing format:

''ed2k://|serverlist|ADDRESS|/''

*ADDRESS -> Full address to the serverlist file (including the serverlist's filename).

Main Page

2005-10-28T12:03:11Z

Xaignar: Change alignment to left-sided, since center-alignment makes the page rather hard to read.

{|
| align="center" | [[AMule_Project_FAQ:About|http://www.amule.org/images/logo.gif]]

<h1>Welcome to the [http://wiki.org/wiki.cgi?WhatIsWiki Wiki] of the [[AMule_Project_FAQ:About|aMule Project]]</h1>
{| align="center"
| align="center" | We hope you will find answers for your aMule questions and problems!
|-
| align="right" | ''-- The [[aMule_devs|aMule Team]] --''
|-
| align="center" | <h3>'''English''' | [[Main_Page-es|Español]] | [[Main_Page-nl|Nederlands]]</h3>
|}
|-
| align="left" |
{|
| valign="top" |
== Installation ==
* HOWTO [[Compilation Installation|Compile and install aMule from source]] ([[Compilation Installation-fr|French]]) ([[Compilation Installation-nl|Dutch]]) ([[Compilation Installation-br|Portuguese]])
* HOWTO [[Install-amule-freebsd|Compile aMule on FreeBSD]]
* HOWTO [[HowTo_compile_on_Mac|Compile aMule on Mac]]
* HOWTO [[HowTo_compile_on_Solaris|Compile aMule on Solaris]]
* HOWTO [[HowTo compile on Win32|Compile aMule on Windows]] ([[HowTo compile on Win32-de|German]])
* HOWTO [[HowTo_Compile_In_Debian|Compile aMule on Debian or Ubuntu]] ([[HowTo_Compile_In_Debian-es|Spanish]])
* HOWTO [[HowTo_Compile_In_Gentoo|Compile aMule on Gentoo]] ([[HowTo_Compile_In_Gentoo-es|Spanish]])
* HOWTO [[HowTo_Compile_In_Slackware|Compile aMule on Slackware]]
* HOWTO [[HowTo_Compile_In_RedHat-Fedora|Compile aMule on RedHat/Fedora]]
* HOWTO [[HowTo_Compile_In_FC3|Compile aMule on Fedora Core 3 and 4]]
* HOWTO [[HowTo_Compile_In_MDK|Install aMule on Mandrake 10]] ([[HowTo_Compile_In_MDK-es|Spanish]]) ([[MDK10_install-fr|French]])
* HOWTO [[SuSE_9.2_install_at_home|Compile aMule on SuSE 9.2 in your home directory]] ([[SuSE 9.2 install at home-es|Spanish]])
* HOWTO [[SuSE_9.3_install_at_home|Compile aMule on SuSE 9.3 in your home directory]]
* HOWTO [[HowTo_Compile_aMuled|Compile the aMule daemon (aMuled)]] ([[HowTo Compile aMuled-es|Spanish]])

== Other ==
* About [[AMule_Project_FAQ:About|aMule's features]] ([[aMule-hu|Hungarian]]) ([[aMule-es|Spanish]]) ([[aMule-de|German]])
* HOWTO [[How_to_launch_VNC_with_aMule_at_Linux_boot|Launch VNC with aMule at Linux boot]]
* HOWTO [[Check if wx is installed twice|Check if wxWidgets is installed twice]] ([[Check if wx is installed twice-br|Portuguese]]) ([[Check if wx is installed twice-es|Spanish]])
* HOWTO [[How_to_uninstall_wxWidgets|Uninstall wxWidgets]] ([[How to uninstall wxWidgets-es|Spanish]])
* Get [[wx-cvs|wxWidgets CVS]] ([[Wx-cvs-es|Spanish]])
* About [[webcache]]
* User [[geaiez]] ([[Geaiez-es|Spanish]])
* Some [[reviews]]
* Test [[test port|your ports]]
* Read [[current events]] ([[current events-es|Spanish]])
* Watch the [[Releases|release graphs]]
* Our [[IRC rules]]
* HOWTO [[aMule_Project_FAQ:Help|Edit a Wiki page]]

== Changelogs: ==
* [[Changelog_latest|Latest aMule release]]
* [[Changelog 2.0_series|aMule 2.0.X]]
** [[Changelog 2.0.3|aMule 2.0.3]]
** [[Changelog 2.0.2|aMule 2.0.2]]
** [[Changelog 2.0.1|aMule 2.0.1]]
** [[Changelog 2.0.0|aMule 2.0.0]]
* [[Changelog 2.0.0-rc_series|aMule 2.0.0-rcX]]
* [[Changelog_1.2_series|aMule 1.2.X]]
* [[Changelog_1.1_series|aMule 1.1.X]]
* [[Changelog_1.0_series|aMule 1.0.X]]
| width="10px" | ||
| valign="top" |

== Usage ==
* Help [[Getting_Started|Getting Started With aMule]] ([[Getting_Started-fr|French]]) ([[Getting Started-nl|Dutch]]) ([[Getting Started-es|Spanish]]) ([[Getting Started-de|German]]) ([[Getting Started-hu|Hungarian]])
* Help [[aMule_problems|Common problems]] ([[aMule_problems-es|Spanish]]) ([[AMule_problems-nl|Dutch]]) ([[AMule_problems-hu|Hungarian]])
* Help [[aMule is slow]]? ([[AMule_is_slow-it|Italian]]) ([[AMule_is_slow-nl|Dutch]]) ([[aMule is slow-es|Spanish]]) ([[aMule is slow-hu|Hungarian]]) ([[aMule is slow-de|German]])
* Help [[aMule makes everything slow]]? ([[aMule_makes_everything_slow-nl|Dutch]]) ([[AMule makes everything slow-es|Spanish]]) ([[AMule makes everything slow-hu|Hungarian]])
* Info [[aMule files|aMule's files]] ([[AMule_files-nl|Dutch]]) ([[AMule_files-de|German]]) ([[AMule_files-hu|Hungarian]])
* HOWTO [[How_to_use_auxiliary_server_ports|use auxiliary server ports]] ([[How_to_use_auxiliary_server_ports-nl|Dutch]])

== FAQs: ==
* FAQ [[FAQ_aMule|on aMule]] ([[FAQ aMule-es|Spanish]]) ([[FAQ aMule-it|Italian]]) ([[FAQ_aMule-pt_BR|Portuguese]]) ([[FAQ aMule-fr|French]]) ([[FAQ aMule-de|German]]) ([[FAQ aMule-nl|Dutch]])
* FAQ [[FAQ_utils|on aMule's utilities]] ([[FAQ_utils-es|Spanish]])
* FAQ [[FAQ_ed2k|on ED2K-Kademlia]] ([[FAQ_ed2k-es|Spanish]]) ([[FAQ_ed2k-it|Italian]]) ([[FAQ_ed2k-de|German]]) ([[FAQ_ed2k-fr|French]]) ([[FAQ_eD2k-Kademlia-nl|Dutch]])
* FAQ on the [[FAQ_network|Transfer Rates on the eDonkey Network]]

== Setup tips ==
* HOWTO [[Migrate from eMule to aMule]]
* HOWTO [[Ed2k links handling|Handle ed2k:// links]]
* HOWTO [[Debian_fonts|Address font issue on Debian]] ([[Debian_fonts-es|Spanish]])
* HOWTO [[import-export files|Import and export files]]
* HOWTO [[Firewall|Setup firewall rules for aMule]] ([[Firewall-es|Spanish]])
* HOWTO [[Webserver|Setup aMule's Webserver]]

== Development ==
* Download the latest [[aMule CVS]] ([[AMule CVS-es|Spanish]])
* Download the latest [[Win32_binary|Windows aMule Installer]]
* About the [[aMule_devs|aMule Development Team]] and [[aMule_devs#Helping|joining it]]
* HOWTO [[Backtraces|Create useful backtraces]]
* HOWTO [[Using gdb and valgrind|Use GDB and Valgrind]]
* HOWTO [[Using_another_wxinstall|Use more than one wxWidgets]] ([[Using_another_wxinstall-de|German]]) ([[Using_another_wxinstall-es|Spanish]])
* Rules of [[coding style]]
* Running a [[testing field]]
* HOWTO [[Report a bug]]
* The [[GNU_FDL|GNU General Public License]]

== Translations ==
* HOWTO [[Translations|Translate aMule into your native language]] ([[Translations-pt|Portuguese]])
* HOWTO [[Translating Wiki|Translate this Wiki]] ([[Translating Wiki-pt_BR|Portuguese]]) ([[Translating Wiki-es|Spanish]]) ([[Translating Wiki-de|German]]) ([[Translating Wiki-fr|French]])
|}
|}

IRC rules

2005-08-28T09:20:26Z

Xaignar: =What if a rule is not clear?=

== Introduction ==

While you stay at our [[IRC]] channels, you '''must''' follow some rules.

Most of them are basic ethic rules which, for some reason, some people fail to understand. Others are not so intuitive. There for, everybody '''must''' read this article '''before''' entering our IRC channel.

Just keep reading.

== What you must do ==

*You must read topic (''/topic #<channel>'') '''before''' saying anything.
*You must read this article from the beginning to the end '''before entering''' the channel. Did I say "read"? I meant "'''understand'''"!
*You must go to #macMule if you want to talk/ask about [[aMule]] on [http://macosx.apple.com MacOS X].
*You must go to #aMule if you want to talk/ask about [[aMule]] on any platform but on [http://macosx.apple.com MacOS X].
*You must speak english in our channels. They are english speaking channels.
*You must look for an answer in [http://forum.amule.org aMule's Forums] and in [[Main Page|this wiki]] before asking anything.
*You must read twice and, before talking, make sure you understand what other people write.
*You must read twice what you write before sending your message.
*You must stay in the channel for at least 30 minutes if you ask something. We hate people who just want their questoins to be answered right after they ask, in 0-time.
*If you want to talk specifically to someone, open a query (''/query <nick>''). Do not flood the channel with your private conversation unless you believe the conversation may make the knowledge of the rest of the people in the channel richer.

== What you must not do ==

*You must not violate any of your contry's laws nor any of the [http://europa.eu.int European Community] laws nor any of the [http://www.firstgov.gov USA] laws nor any of the international laws while staying at any of our channels. Sounds funny? Well, it's not.
*You must not talk about anything that doesn't regard '''directly''' (in the most strict way) to [[aMule]] as an application. Exceptionally, you may ask questions about the [[FAQ_ed2k|ed2k]] and [[Kademlia]] protocols, but an answer is not guaranteed.
*You must not talk, directly or indirectly, about any copyrighted non-free (in the ''beer way'') material.
*You must not talk about any website which breaks any of our channels rules.
*You must not provide any URL which's contents break any of our channels rules.
*You must not provide '''any''' [[ed2k link]].
*You must not do any kind of publicity about anything unless some channel operator allows you to do so.
*Do not flood. Not even a little. More than tree lines in a row will be enough to be considered flooding.
*Don't ask to ask. Just ask!
*You must not ask anything if you haven't at least tried a little to find out the answer on your own. Did I seay "try a little"? I mean "try as hard as you can".
*You must not ask repeatedly for a question. Wait at least an hour before asking again, even if you get answer. Asking the same question using different words won't make the trick either.
*You must not use any ''away message''.
*You must not use any bots in the channels unless some channel operator allows you to do so.
*Do not split whatever you want to say into several different short lines. This is not Instant Messaging. This is IRC. Get used to it.
*You must not use abreviated words or non-standard language.
*You must not type with capital letters nor user more than two exclamation marks in a single line (scream).
*You must not insult, flame, blame, begin a war, fight, etc.
*You may not enter and leave the channel as if you were hiding from someone. Decide whether you want to enter or leave the channel and then do so. Not the other way round.

== What you can do ==

You can do anything you wish as long as it is not forbidden in any rule in this article. Anyway, we'd like to make emphasys in some things which you can do in our channels which are sometimes forbidden in many other channels around:

*You can talk to the [[aMule Team]]. They are the official channels, so the Team is hearing. Just wait some time till they read. And make no doubt they will read you.
*You can stay idle as long as you wish.
*You can answer questions to other people even if they weren't asking you, as long as you know what you are talking about and as long as what you answer is what you really believe to be true/right.

== Suggestions ==

*Try to always ask&answer in an objective way.
*If you ask a question, wait for a few hours for an answer. Most of the time people are idle (not in front of the computer), so it may take long till someone reads your question. Just don't leave that fast.
*If you get an answer don't become sceptic about what you are told. Otherwise just don't ask.
*Use the latest stable [[aMule]] release.
*Distro specific questions, even if regarding [[aMule]], should go the distro's channel or forums. Most surely we won't know the answer.
*Now here is '''The BIG Suggestion (c)''': Think, then act.

== What if a rule is not clear? ==

This rules are made by the channels operators.

The only people who know exactly what they mean are them. You must try to understand what operators think the rules means. And in case of doubt, just stay silent or ask what is meant.

Channel operators may charge on you if they consider you have broken some rule in the interpretation they, as channel operators, make of the rule. And the interpretation may vary depending on the mood, the phase of the moon, the colour of the clouds or the price of gas and pizza.

== Consequences ==

Anyone who doesn't follow one or more of the above rules will be kicked from the channel.

Anyone repeatedly breaking this rules will have to face a ban. There is no rule for ban periods: it depends on our mood in which we are :->

If someone severely breaks some rule, even if it isn't repeatedly, it could also be punished with a ban.

HowTo compile on Win32 with MinGW

2005-08-13T15:00:53Z

Xaignar:

<center><h2>Originally by '''Madcat'''</h2></center>

<center>
'''English''' | [[HowTo compile on Win32-de|Deutsch]]
</center>

This wiki page only covers the latest [[aMule_CVS|CVS]] version of [[aMule]], not releases in the 1.x.x or 2.x.x branches.

== Requirements for compiling [[aMule]] ==

'''Note:''' Some of these require manually moving includes and libraries into their correct directories.

*[http://www.microsoft.com/windows Windows] port of [http://gcc.gnu.org GNU C compiler], MinGW -> [http://prdownloads.sourceforge.net/mingw/MinGW-4.1.1.exe?download Download (4.1.1)]

*Minimal [http://www.gnu.org GNU] shell for [http://www.microsoft.com/windows Windows], MSys -> [http://prdownloads.sf.net/mingw/MSYS-1.0.10.exe?download Download (1.0.10)]

*Developer toolkit for [http://www.mingw.org/msys.shtml MSys] (for [http://www.gnu.org/software/cvs CVS] & co) -> [http://prdownloads.sf.net/mingw/msysDTK-1.0.1.exe?download Download (1.0.1)]

*[http://www.gnu.org/software/libiconv LibIConv] (required by [http://www.gnu.org/software/gettext gettext]) -> [http://prdownloads.sf.net/mingw/libiconv-1.8.0-2003.02.01-1.exe?download Download (1.8)]

*[http://www.gnu.org/software/gettext GetText] (for [http://www.gnu.org/software/gettext po files], [http://www.gnu.org/software/automake/automake.html autogen.sh], etc) -> [http://prdownloads.sf.net/mingw/gettext-0.11.5-2003.02.01-1.exe?download Download (0.11.5)]

*[http://www.zlib.org zlib] compression library -> [http://www.zlib.net/zlib-1.2.3.tar.gz Download (1.2.3)]

*[http://www.microsoft.com/windows Windows] port of [[wxWidgets]] library -> [http://prdownloads.sourceforge.net/wxwindows/wxMSW-2.6.1.zip Download (2.6.1)]

== Installing the Minimal System ==

The first step is to create a linux-like environment, which is required in order to be able to perform the build. This can be done by following these steps '''in this order''':

*Install MinGW. When it prompts you for a folder, the default is slightly messy but the safer selection.

*Install MSys. When it prompts you for the MinGW folder, it's very important to specify it correctly. Failure on this step will stop any compilation attempts. If for some reason you fail, install MSys again.

*Install the MSys developer toolkit.

*Install LibIConv.

*Install GetText.

== Compiling the libraries ==

There are two libraries that aMule will need compiled: zlib and wxWidgets.

We will compile them from MSys, so just run it. Once you are running MSys, you'll be on your home folder. Copy the zlib and wxWidgets files you downloaded above into this folder.

The steps for compiling them is:

*[http://www.zlib.org zlib]: Uncompress zlib, cd to the newly created directory and run ''./configure --prefix=/mingw && make && make install''

*[[wxWidgets]]: Uncompress wxWidgets, cd to the newly created directory and run ''./configure --disable-shared --without-checklistbox && make && make install''

If you want to help us developers, you can add ''--disable-debug'' flag to the wxWidgets configure command, right after ''--disable-shared'', but be warned it will result into a > 100Mb aMule.exe.

== Compilation ==

Ok, we're all done with the compilation environment. Let's do the last step: compiling aMule.

The compilation itself is actually just a matter of following the usual method: ''./configure && make''. Use your favorite flags on ./configure, for example, ''--disable-debug'' will remove debug info, but will also make it harder for us developers to understand the bugs you might find.

You might want to compile just the remote GUI: the flags would be ''--disable-monolithic --disable-ed2k --enable-amule-gui''

Getting Started

2005-08-02T21:38:11Z

Xaignar: =Where Are The Files?= (Initial writeup)

<center>
'''English''' | [[Getting_Started-fr|Français]] | [[Getting_Started-nl|Nederlands]] | [[Getting_Started-es|Español]] | [[Getting_Started-de|Deutsch]] | [[Getting_Started-hu|Magyar]]
</center>

== What is [[aMule]] ==

[[aMule]] is a [[P2P|p2p]], or peer-to-peer, client for the [[FAQ_eD2k-Kademlia|eD2k]] network, commonly known as [[FAQ_eD2k-Kademlia|eDonkey network]] or eD2k network ([[eDonkey2000]]). This guide does not require you to be familiar with these networks (but it does help), however it does require that you have [[aMule]] installed on your computer.
If you haven't installed [[aMule]] yet, please refer to the proper installation guide for your system. Links to these guides can be found on the [[Main_Page|main page]].

--[[User:Xaignar|Xaignar]] 01:12, 10 Jul 2004 (CEST)

== Running [[aMule]] for the first time ==
First, launch [[aMule]]. This can be done by executing the command ''amule'' in a console window or by whatever method might be provided by your distro and/or windows manager in terms of icons, etc.

Once started, if you are using the [http://www.gnu.org/software/cvs CVS] build, [[aMule]] will display a notification telling you that you are running it for the first time. Read this to learn what you are getting yourself into ;)

=== Configuring [[aMule]] ===
Before you begin file sharing, you will need to properly configure [[aMule]]. This includes connection speeds and limits, directories to be used, proxies, port settings and other settings.
You can access [[aMule]] preferences by clicking on the ''Preferences'' icon at the top of the [[aMule]] window.

==== Connection Speed ====
You should know that the eDonkey clients enforce upload. This means that in order to download, you'll have to share files yourself (don't worry if you don't have anything to share). This is enforced in two ways:
* Your download speed depends on how fast you upload. If your upload speed is set to anything below 10kb/s then your maximum download speed will be 3 or 4 times your uploadspeed (read [[FAQ_eD2k-Kademlia#Are_there_any_limitations_on_the_ED2K_network?|this]] to know more about it), so if you limit your upload speed to 5kb/s, you'll only be able to download with 20kb/s.
* Partially downloaded files are shared as well. You automatically start sharing a file after you've received at least one [[FAQ_eD2k-Kademlia#What_is_a_chunk?|chunk]] (a [[FAQ_eD2k-Kademlia#What_is_a_chunk?|chunk]] is a 9.28Mb piece of a file).

Note: If you ever enter the [http://forum.amule.org aMule forum] or [[IRC|IRC channel]] to complain about this or demand that we change the ratio, I will hunt you down and eat your spleen. -- [[User:Xaignar|Xaignar]]

When you first open the Preferences dialog, the page shown will be "General", which contains some general settings, like the [[nickname]] other people will see when they download from or upload to you.
To proceed, click on the tab named "Connection":

http://www.amule.org/dev-up/Limits.png

The only settings relevant to this guide are the settings under "Bandwidth Limits" marked "Upload" and "Download". You don't need to enter a max download speed, but it is recommended that you set the upload speed to around 80% of your actual speed, since it can cause slower downloads otherwise.

Once you have entered the proper values, you can explore the rest of the settings. To save the changes, simply click the "OK" button.

=== Connecting to a Server ===

You should now be looking at the servers dialog:

http://www.amule.org/dev-up/ServerDlg.png

The empty list normally contains the servers you know about, but since this is the first time you're running [[aMule]], you don't have any. To remedy this situation, simply click in the text-field containing the text ''http://www.srv1000.com/azz/server.met'' and press enter.
A dialog will pop up and close again once the download has completed.

You should now have a full list of servers, if not search google for ''server.met'' and place the file in the folder ''.aMule'' on your home dir. The list should look like this:

http://www.amule.org/dev-up/ServerList.png

Next you need to connect to a [[server]]. Normally it's a good idea to select one with as many users as possible, but for now, lets just click the large "Connect" button near the top-left of the window. This will connect you to a random server. Please wait while [[aMule]] contacts servers and tries to establish an connection. Once this happens, proceed on to the next section.

=== [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|High and Low ID]] ===
Because [[P2P|p2p]] networks work by [[Client|clients]] directly connecting to each other, being behind a firewalls, or routers that do not/cannot pass traffic on specific ports, can really cause problems. If you don't know whenever or not you are behind a firewall, simply look at the icon in the bottom-right of the window. If it is green, then you have [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|High ID]] and can proceed, but if it is yellow, then you need to take a look at the page on [[Firewall|Firewalls]] and/or [[AMule_problems#aMule_connects_to_server,_but_it_is_always_given_LowID._Why?_and,_can_I_do_something_about_it?|common problems]], since having a [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|Low ID]] greatly reduces [[P2P|p2p]] experiences.

== Basic Usage ==
This will cover some basic usage of [[aMule]].

=== Searching and Downloading ===
OK, this is what [[P2P|p2p]]'ing is about: Downloading files.
For the sake of this guide, I'll presume that you are really keen on downloading the latest [http://www.knoppix.org Knoppix] CD (who isn't?). To download this, first ensure that you are connected to a server and then click on the "Searches" button.

This will bring up the search dialog:

http://www.amule.org/dev-up/SearchDlg.png

Since we only care about CD images, we click on "Extended Options" and select the option "CD-Images" from the "Type" dropdown menu. Also select the "[[Search#Local_search|Local]] [[Search]]" setting, since we don't really need to search anything other than the currently connected [[server]]. Then we enter ''Knoppix'' in the top "Name" field and hit enter or the "Search" button. You should now have a listful of results:

http://www.amule.org/dev-up/SearchResults.png

Lets sort the list by [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]], by clicking twice on the field marked "Sources", this makes it easier to find popular files. The second one looks interesting, so we double-click on it (or click on it and then on the "Download" button). This will queue the file for download.

Results can be displayed in a number of colors, which signify the following:
* Blue represents the number of sources, the more sources the darker the blue.
* Red represents files that you are currently downloading.
* Green is for files you have downloaded or shared before, in other words files you already have.

=== The Download Queue ===
Click on the "Transfers" button to bring forth a list of files you have queued for download:

http://www.amule.org/dev-up/DownloadQueue.png

If you're lucky, the progress bar will turn a nice dark shade of blue, which means that a lot of people have that file (read [[FAQ_aMule#What_do_those_colors_in_the_progress_bar_mean?|this]] to know more about it). Beware of files that have parts marked in red, since it means that no-one has that part of the file and you most likely wont be able to complete the download.

If you double-click on any of the files, you can see the [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] you have found for that file.

==== Of Rows and Columns ====
These are the columns of the Download Queue:

; ''Filename'' : The name of the file.
; ''Size'' : The size of the file. The eDonkey2000 network supports files up to 4GB in size (read [[FAQ_eD2k-Kademlia#Are_there_any_limitations_on_the_ED2K_network?|more]] about this).
; ''Transferred'' : Shows the amount downloaded.
; ''Completed'' : This column displays how much of the file you have actually completed. Please note that this can differ from the Transferred column because of corruptions or gains made by the compression *Mule [[Client|clients]] use (read [[FAQ_aMule#What_is_the_difference_between_Transfered_and_Completed_in_the_Transfers_window?|more]] about this difference).
; ''Progress'' : This bar displays the current progress of the file, the colours signifying the following (alternative [[FAQ_aMule#What_do_those_colors_in_the_progress_bar_mean?|resource]]):
* Blue: How many sources provide this part, the darker the colour, the more sources provide it.
* Red: There are no known [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] that provide this part.
* Black: You have already downloaded this part.
* Yellow: You are currently downloading this part.
: The green bar on top of the larger bar gives an indication of the actual progress.
; ''Sources'' : There are 3 fields in this column, though mostly only 2 are shown (alternative [[FAQ_aMule#What_do_all_those_numbers_in_the_sources_column_in_the_transfers_window_mean?|resource]]):
: <Asked [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]>[/<All [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]>] [+ <[[FAQ_aMule#What_is_A4AF?|A4AF]] [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]> ] [(<Transferring [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]]>)]
: 'Asked [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]' are those that have been asked for the file.
: 'All [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]' are all [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] of that file, asked and unasked.
: '[[FAQ_aMule#What_is_A4AF?|A4AF (Asked For Another File)]] [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]' are [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] that provide that file, but have been asked for anther one.
: 'Transferring [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]]' are [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] which are uploading that file to you at this very moment.
; ''Priority'' : The priority of the file. Files are set to auto-priority by default, which means that [[aMule]] will manage it by itself. Priorities affect how [[aMule]] allocates [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] that are known to provide multiple files and thus means that high-priority files get more [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]]. Read [[FAQ_aMule#What_do_all_those_numbers_in_the_priority_column_in_the_extended_transfers_window_mean?|more]] about this.
; ''Status'' : The current status of the file. Waiting means that you are waiting for [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] to start uploading to you.
; ''Time Remaining'' : An guess at how fast the file will be completed. Only shows something when you are currently receiving the file.
; ''Last Seen Complete'' : This shows the last time you've seen the entire file provided by the [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] you've asked.
; ''Last Reception'' : This shows the last time you were downloading parts of this file.

=== The Upload Queue ===
The upload queue can be found just beneath the download queue, and shows who are downloading files from you (you might want to read [[FAQ_aMule#Why_are_there_two_transfer_rates_in_the_uploading_transfer_list?|this]]). In case you are wondering, no, you cannot stop uploads. If you click on the blue icon next to the "Uploads" label, you can see who are queued for downloading from you, rather than the people who are actually downloading from you right now.

=== Icons and What They Signify ===
These are the icons that can be found on the Transfers page.

* '''Source Status'''
** http://www.amule.org/dev-up/Source_1.png - [[Client]] is sending you either a file or a hashset.
** http://www.amule.org/dev-up/Source_2.png - You are either on this [[Client|clients]] queue or currently asking it for a file.
** http://www.amule.org/dev-up/Source_3.png - You are currently connecting to this [[Client|client]].
** http://www.amule.org/dev-up/Source_4.png - [[Client]] has been asked for another file, has no needed parts or is unable to connect because of a [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|Low ID]].
** http://www.amule.org/dev-up/Source_5.png - Status is unknown.

* '''eDonkey Clients'''
** http://www.amule.org/dev-up/Client_aMule.png - [[aMule]]
** http://www.amule.org/dev-up/Client_eDonkey.png - [[eDonkey2000]]
** http://www.amule.org/dev-up/Client_eMule.png - [[eMule]]
** http://www.amule.org/dev-up/Client_Friend.png - [[Client]] is a [[Friend]]
** http://www.amule.org/dev-up/Client_Lphant.png - [[lphant]]
** http://www.amule.org/dev-up/Client_MLDonkey.png - [[mlDonkey]]
** http://www.amule.org/dev-up/Client_Shareaza.png - [[Shareaza]]
** http://www.amule.org/dev-up/Client_Unknown.png - Unknown [[Client]]
** http://www.amule.org/dev-up/Client_xMule.png - [[xMule]]

* '''Modifiers'''
** http://www.amule.org/dev-up/Client_Mod_eMuleProt.png - [[Client]] supports the extended [[eMule]] protocols. Source-sharing and such.
** http://www.amule.org/dev-up/Client_Mod_GoodCredit.png - [[Client]] has a good [[FAQ_eD2k-Kademlia#What_is_all_this_talk_about_credits,_ratings_and_scoring_about?|credit-rating]].
** http://www.amule.org/dev-up/Client_Mod_NormCredit.png - [[Client]] has a normal [[FAQ_eD2k-Kademlia#What_is_all_this_talk_about_credits,_ratings_and_scoring_about?|credit-rating]].
** http://www.amule.org/dev-up/Client_Mod_SecId_Good.png - [[Client]] has been [[Secure_User_Identification|securely identified]].
** http://www.amule.org/dev-up/Client_Mod_SecId_Bad.png - [[Client]] has been for some reason been identified as a [[bad guy]].

* '''File [[comment]]s'''
** http://www.amule.org/dev-up/File_Comment.png - This file has either been rated or someone has added a [[comment]].
** http://www.amule.org/dev-up/File_Comment_Bad.png - This file has been rated as [[Fake]] by at least one person.

=== Where Are The Files? ===
Once [[aMule]] starts downloading a file, it will create a number of files to keep track of that specific download. These files can be found in the subdir ''.aMule/Temp'' in your homedir (''~/.aMule/Temp''), but should not be touched in most cases.

If you have incompleted downloads from [[eMule]], you can simply place the temp files in the ''~/.aMule/Temp'' directory if you wish for [[aMule]] to continue downloading them.

However, once a file has been completed, it will be moved away from ''~/.aMule/Temp'' and to ''~/.aMule/Incoming'', where all completed files are placed by default. You can change both of these paths in the preferences should you wish to do so.

Also, please note that the ''.aMule'' directory is a hidden directory, so you might have to enable showing of hidden files in your file-mananger, should you use one such.

=== Sharing Files ===
First off, note the eDonkey2000 network is not meant to share small files such as audioclips, but instead is optimized for distribution of larger files. Also note that it your own responsibility to ensure that you do not violate any local laws regarding material shared.

You can share files in two ways in aMule:

The first method is to place the files in the "Incomming" folder (~/.aMule/Incomming on Unix like systems). After this has been done, you must either restart aMule or press the "Reload" button on the SharedFiles page. (TODO: IMG)

The second method is to explicitly add shared directories in which aMule will look for files to share. This is done by clicking on the "Preferences" button and selecting the "Directories" page. (TODO IMG)
From there, you can browse to the directory you wish to share via the directory-tree. Double-clicking on the folder icon will share the given folder and right-clicking on the folder icon will share the folder recursively.

== Conclusion ==
Hopefully this brief introduction has given you an idea of how [[aMule]] works. If you feel that something is missing from this guide, please let us know or add it yourself.

HowTo Compile In RedHat-Fedora

2005-05-06T23:20:17Z

Xaignar: No Curl

<h1>aMule in RedHat/Fedora</h1> ''(rev 0.1 by [[User:bootstrap|bootstrap]])''

== What's this all about? ==

This mini-howto explains how to get a working [[aMule]] installation on [http://www.redhat.com RedHat]/[http://fedora.redhat.com Fedora] based installations.<br>
It covers installing by [http://www.rpm.org RPM] as well as building from source.<br>
Focus is to keep things easy so that probably everybody will be able to follow this instructions without learning to rebuild a complete system from scratch ;)

== Show me the way... ==

This Section is divided into 2 parts. Part (a)  will cover the easy way using [http://www.rpm.org RPM]s (which is quite easy, so I really don't like to write it down, but there have been questions, and I won't leave them unanswered...), while part (b)  covers the more complex way: using the sources to build your own [[aMule]].

=== Easy ===

I said it's easy and it really is. The one and only rule to get an [http://www.rpm.org RPM] based [[aMule]] installation up and running is:

: Get the right [http://www.rpm.org RPM]s. That means:

: 1. Get [[wxWidgets|wxGTK]] and [[wxWidgets|wxBase]] from http://www.wxwidgets.org (you don't need the -devel packages to get [[aMule]] running) and install  them. Whatever someone else may say or you might think, don't use any other [[WxWidgets|wx]] [http://www.rpm.org RPM].

: 2. Install some additional [http://www.rpm.org RPM]s. On a common [http://www.redhat.com RedHat]-ish system you will have most of them, but I've read some questions regarding libcrypto (not [[libcrypto]]++, that's next...), so it's better to say that you will need to have openssl installed. If you're installing aMule <= 2.0rc6 you will also need to install [[libcrypto]]++ (we're talking about [[libcrypto]]++ from [http://www.eskimo.com/~weidai/cryptlib.html http://www.eskimo.com/~weidai/cryptlib.html]). You can find [http://www.rpm.org RPM]s for [http://www.redhat.com RedHat]/[http://fedora.redhat.org Fedora] on http://www.hirnriss.net or links on the [http://www.amule.org/amule/download.php aMule download page]. That should probably be all you [http://www.rpm.org RPM]s you will need to install by hand (actually [http://www.openssl.org openssl] will be installed on most systems, but as I mentioned before, there have been questions about that, so here you are...). If you're still getting a dependency problem and can't figure it out on your own, contact us through [[IRC]] (come to irc.freenode.net and visit #amule). Somebody will surely help you. Some [http://www.rpm.org RPM]s you should probably check are [http://www.openssl.org OpenSSL] and [http://www.gnu.org/software/make/manual/make.html automake] >= 1.7.

: 3. Get [[aMule]] from http://www.amule.org/dl/index.php?category=22 and install  it.

That's it. If nothing went wrong you can drop your root privileges  and start [[aMule]]. That's as easy as typing ''amule &'' in your favourite shell. Have fun!

=== Not that easy ===

==== First notes ====

So you're one of that guys that don't like [http://www.rpm.org RPM]s? Well - you asked for it...

Preparation:

You will need to get some [[wxWidgets|wx]] stuff. If you'd like to build [[wxBase]] and [[wxWidgets|wxGTK]] yourself, you will have to look into another howto. Building [[wxWidgets|wx]] can be complex and takes some time, so I really recommend to use the http://www.wxwidgets.org [http://www.rpm.org RPM]s.

As you want to build [[aMule]] yourself, you will need some more [http://www.rpm.org RPM]s than other people. Install [[wxWidgets|wxGTK]], [[wxBase]], [[wxWidgets|wxGTK]]-devel and [[wxBase]]-devel.

If you're building [[aMule]] <= 2.0rc6 you will also need [[libcrypto]]pp and [[libcrypto]]pp-devel ([http://www.redhat.com RedHat]/[http://fedora.redhat.com Fedora] downloads at [http://www.hirnriss.net http://www.hirnriss.net]) to get [[aMule]] compiled. Skip this if you're building [[aMule]] => 2.0rc7.

Get the sources you want (probably a cvs tarball from http://amule.hirnriss.net ?) from http://www.amule.org and un[http://www.gnu.org/software/tar/tar.html tar] it (if you don't know about tarballs, use [http://www.rpm.org RPM]s. Please!) into a directory you'd like to work in.

Drop your root privileges  and proceed to the fun part...

==== Configuring your [[aMule]] build ====

The following is an example, but it will work on [http://www.redhat.com RedHat]/[http://fedora.redhat.com Fedora] systems and it's been used for quite some time when building the "official" [[aMule]] [http://www.rpm.org RPM]s. Anyway, your system or your opinion may be different, so feel free to change the options if you feel like changing them.

''Note: If you're building [[aMule]] => 2.0rc7 you will have an embedded [http://www.openssl.org/docs/crypto/crypto.html crypto] lib that makes [[libcrypto]]++ installation obsolete. It's enabled by default, so you don't need to change your configure options.''

Go to the directory you created, change into the [[aMule]] sources and type (check the [[configure|configure article]]): ''./configure --prefix=/usr --enable-optimize --enable-amulecmd --enable-amulecmdgui --enable-webserver --enable-webservergui --enable-utf8-systray --with-wx-config=/usr/bin/wxgtk-2.4-config --with-wxbase-config=/usr/bin/wxbase-2.4-config''

Now you should see a bunch of output, while your system tries to configure [[aMule]] for building. If you're '''NOT''' building a [http://www.gnu.org/software/cvs CVS] Version and you encounter problems, join the [[IRC|aMule IRC channel] at #amule on irc.freenode.net and prepare to paste some info. If your building a [http://www.gnu.org/software/cvs CVS] version you should probably wait a day and try again - it may just be some of those days where [http://www.gnu.org/software/cvs CVS] sources are not really working out for unexperienced users ;). If you're suspecting an interesting bug or just want to build that tarball whatever it takes, you're welcome to [[IRC]] in #amule as well, but bring some time because solving problems may not be as easy as installing [http://www.rpm.org RPM]s.

Once configure is done (should not take that long... 30 - 60 seconds on a modern system, a little more on older systems) type ''make'', sit down and relax. Depending on your systems speed this can take some time. Prepare for at least 5 minutes of strange output. If make stops check the last few lines of output for something that looks like an error message. If you can find something that looks like an error message, again, join [[IRC]], come to #amule and prepare for pasting or do a ''make clean'', try to change some of your configure options and restart ''make''. If it's still not working, ask someone at [[IRC]] in #amule on irc.freenode.net for help.

If your build completed without error you're nearly done.

Get root privileges and type ''make install'' to install your newly built [[aMule]]. Now drop your root privileges  and try to start [[aMule]] with ''amule &''. If your build was ok and you had a good day on [http://www.gnu.org/software/cvs CVS] versions you may have a great piece of software running by now. If your [[aMule]] instantly dies and produces a bunch of output containing words like "backtrace" - don't worry, Join [[IRC]] at #amule on irc.freenode.net and somebody might help you.

After building you can remove the directory you just built [[aMule]] in, as well as you can remove the installed -devel [http://www.rpm.org RPM]s. I suggest you leave the [http://www.rpm.org RPM]s in place in case you want to rebuild or build a new version some other day.

If nothing works and your home built [[aMule]] won't run, don't worry, try one of our [http://www.rpm.org RPM]s ;)

== Suggestions ==

This section is quite small (at the time of this writing) and contains some tips regarding [[aMule]] usage.

: * Drop your root privileges. Don't work/play/watch movies/drive a car/{you're favourite way to waste some time here} as root. Working as root can be dangerous. One mistake can lead to some interesting hours, restoring your system's health. If you know what you're doing: fine, but it's probably still better if you don't work as root.

: * Keep an eye on the [http://forum.amule.org aMule forum] and the [[Main_Page|aMule Project FAQ]] and probably use the search function: most questions have been answered before.

: * Don't drink and drive.

... to be continued ...

== Additional fun ==

This section covers additional ways to have fun with or around [[aMule]].

[http://www.uk.research.att.com/vnc VNC] Server. Did you ever think about using [[aMule]] on your server? If you don't like webservers and want to have more access to your system but a limited web GUI, this info is for you.

Using [[aMule]] in [http://www.uk.research.att.com/vnc VNC] is quite easy in [http://www.redhat.com RedHat]/[http://fedora.redhat.com Fedora], because you don't need more than a simple [http://www.rpm.com RPM] install  of vnc-server and a minor modification to a startup script.

Just install vnc-server ([http://www.rpm.org RPM] comes with your installation CDs) and drop your root privileges.
This howto assumes that your default user is named ''bob''.
As 'bob' do: ''vncserver -depth 16 :1''. If you never used [http://www.uk.research.att.com/vnc VNC] as 'bob' before, the [http://www.uk.research.att.com/vnc VNC] server should ask you for a password. This password is used to connect to your [http://www.uk.research.att.com/vnc VNC] session. It is ''not'' the password your user 'bob' has and it should not be set to the same password. Furthermore your [http://www.uk.research.att.com/vnc VNC] password can be only 8 letters/digits long, so you really should not set your users pw here.
The next step would be to test if your server is running as expected. Use you desktop or any other remote system to connect to your [http://www.uk.research.att.com/vnc VNC] session. To make sure you get the right port, use the following syntax: ''pizza:1'' or ''192.168.100.1'' assuming your server is named pizza and your [http://www.dns.net/dnsrd DNS] is running, or your server is running on the [http://www.faqs.org/rfcs/rfc791.html IP] 192.168.100.1 - if not, change the values to your needs.
Once your connection is up, you should be watching a very simple and nearly ugly desktop by now (i'm pretty sure the [http://www.plig.org/xwinman/vtwm.html twm] folks will kill me if they read this... sorry guys). This is because the default setting is to start only a little set of applications and a small window manager inside [http://www.uk.research.att.com/vnc VNC]. Go back to your shell and stop [http://www.uk.research.att.com/vnc VNC] using ''vncserver -kill :1'' as 'bob'. Now your [http://www.uk.research.att.com/vnc VNC] server should immediatly go offline. As next step edit ''/home/bob/.vnc/xstartup'' - uncomment the two lines below ''"Uncomment the following two lines for a normal desktop"'' and comment the rest. If you now start your [http://www.uk.research.att.com/vnc VNC] server again, you will have a fully functional [http://www.redhat.com RedHat]/[http://fedora.redhat.com Fedora] desktop. Now open a shell or use your window manager to start [[aMule]] and enjoy. One last hint: [http://www.uk.research.att.com/vnc VNC] uses encryption and timeouts to protect your password, but it's not perfectly secure. To get an even more secure system, I'd recommend using a screensaver on your newly created desktop. If you're using [http://www.kde.org KDE] you should have a nice button on your taskbar already. That should protect your system, even if your [http://www.uk.research.att.com/vnc VNC] password has been compromised.

== How to use [http://www.rpm.org RPM] ==

There are several how to's on [http://www.rpm.org RPM] available so I won't try to write a new one. Here are some short hints to help you out in case you're completely new to your system and just want to follow the [[aMule]] installation from part 2.

Install: ''rpm -i rpmname'' (use the complete filename of your [http://www.rpm.org RPM], like: ''openssl-0.9.7a-35.i386.rpm'')

Remove: ''rpm -e rpmname'' (don't use the complete filename here, just the package name. Like ''openssl'', but not ''openssl-0.9.7a-35'')

Update: ''rpm -U rpmname'' (use the complete filename of your rpm, like: ''openssl-0.9.7a-35.i386.rpm'')

If you need any further info on [http://www.rpm.org RPM], please consult the rpm howto or use ''[http://www.rpm.org/max-rpm/rpm.8.html man rpm]''.

ED2KLinks file

2005-04-14T13:48:35Z

Xaignar: =Example=

== File ==

'''Name:''' ''ED2KLinks''

'''Location:''' ''~/.aMule/''

== Description ==

The ''ED2KLinks'' file is an interface to communicate with [[aMule]]. Inspite of the [[External Connections]] interface, this interface is ''mono-directional''. and inspite of the [[Signature|Online Signature]] interface, this one is ''in-going''.

It consists of a regular text file in [[aMule]]'s directory (in *nix systems that is at ''~/.aMule/'') which contains the [[Ed2k_link|eD2k links]] [[aMule]] should download.

As soon as [[aMule]] detects that file's existence, it reads it, starts downloading the links in it, and deletes the file.

== Format ==

The links are listed one after the other separated with newlines. The file should end with a newline right after the last [[ed2k link]].

== Example ==

The following is the contents of a valid ''ED2KLinks'' file:

''ed2k://|file|Mandrake%20Linux%2010.0-Official-Powerpack-Cd1%20i586.iso|722343936|13048F2EC3B917E33BB9593D956E81AC|/''<br>
''ed2k://|file|Knoppix%20v3.6-2004-08-16-En.iso|733499392|E1A848648CF99A2295909799FA45F0A8|/''<br>
''ed2k://|file|debian-30r1-i386-binary-2.iso|676495360|557B59750976519476DA071BDF79A014|/''

== More ==

It might be of your interest to read [[FAQ_aMule#Is_there_a_way_to_open_a_text_file_and_load_all_the_ed2k_links_from_the_file?|this part]] in the [[FAQ_aMule|aMule FAQ]].

HowTo Compile In Gentoo

2005-04-08T15:28:25Z

Xaignar:

Compiling a recent version of [[aMule]] on [http://www.gentoo.org Gentoo] should be a breeze by just typing
''emerge -av amule''
but due to several facts it isn't quite that easy right now. So here's a little Step-by-Step explanation. Please read the whole document before doing anything as there are several ways you can use and each of them will have a different outcome.

'''Note:''' currently Diego "Flameeyes" Pettenò (non-official devel) is trying to make [[aMule]] merging simpler.
Please take a look at [http://bugs.gentoo.org/show_bug.cgi?id=71108 Gentoo Bug #71108] for further information. The new ebuild requires [[wxGTK]] 2.5, but there is another ebuild for [[wxGTK]] 2.5 (also from Diego) which should allow to safely unmask that version.

== Available eBuilds ==
An eBuild for aMule-2.0.0rc8 can be found here:
http://bugs.gentoo.org/show_bug.cgi?id=71108

An eBuild for aMule-CVS can be found here:
http://forum.amule.org/thread.php?sid=&postid=30548

== Stable aMule from portage ==

If you just ''emerge amule'' you will most likely get the latest package that is marked as stable in portage. This is amule-1.2.8 which is more than 12 months old, lacks several bugfixes and features which could seriously lower your download or make it impossible to connect to some servers. So that is not really an option.

== Unstable aMule from portage ==

[http://www.gentoo.org Gentoo] classifies amule2.0.0rc ebuilds as unstable because they are ReleaseCandidates. The latest one available is ''amule2.0.0rc7''. There is an (inofficial) ebuild for rc8, but as rc8 depends on ''wxGTK2.5.3'' to build the [[aMuled|aMule daemon]] and ''wxGTK2.5.3'' is hardmasked in portage.

However, if rc7 is "new enough" for you enter the following things as root into a console:

<code>mkdir /etc/portage</code> (this could give an error message if the directory already exists, just ignore that)<br>
<code>echo 'net-p2p/amule ~x86' >> /etc/portage/package.keywords<br>
emerge -av amule</code>

However rc7 is getting quite old now, so it is the best thing to use either rc8 or even a recent cvs tarball and compile amule manually.

== Recent aMule manual installation ==

Per default [http://www.gentoo.org Gentoo] uses ''gtk2'' in all recent profiles. When it comes to [[wxGTK]] (which is needed by [[aMule]]) this can be some trouble. The recent stable [[wxGTK]] in portage is ''wxGTK2.4.2'' which should never be linked against ''GTK2''. It causes random crashes, freezes, inpredictable behaviour and may even harm your pet dog!

So there are two possible ways to go: choose ''wxGTK2.4.2'' linked against ''GTK1.2'' (which should be fine for everybody who doesn't want to use [[aMuled]], the [[aMuled|aMule daemon]]) or choose ''wxGTK2.5.3'' linked either against ''GTK1.2'' or ''GTK2'' (for those who want to try [[aMuled]] as [[aMuled]] doesn't work with [[wxGTK]] prior to 2.5.3).

Another thing is unicode support: You can't enable unicode support when using ''GTK1.2'' and enabling unicode with ''GTK2'' causes huge memleaks (100MB and more in 24h). So I will just disable it in these examples.

== wxGTK2.4.2 ==

If you don't want to use [[aMuled]] then ''wxGTK2.4.2'' is just fine for. You only need to tell it that it should link against ''GTK1.2''. To do this grab a console and enter (as root):

<code>mkdir /etc/portage</code> (this may give you an error if the directory already exists, just ignore that)<br>
<code> echo 'x11-libs/wxGTK -gtk2 -unicode' >> /etc/portage/package.use<br>
emerge -av wxGTK</code>

This should (re-)emerge ''wxGTK2.4.2'' linked against ''GTK1.2''. Now you can go on to [[HowTo_Compile_In_Gentoo#compiling_amule|compiling aMule]].

== wxGTK2.5.3 ==

If you want to use amuled then you need at least ''wxGTK2.5.3''. This is currently hardmasked in portage due to problems when compiling with [http://www.opengl.org OpenGL] support. But as [[aMule]] is no 3D egoshooter we can safely disable [http://www.opengl.org OpenGL] support and use it anyway. To do so enter the following into a console as root:

<code>mkdir /etc/portage</code> (this may give you an error if the directory already exists, just ignore that)<br>
<code>echo '=x11-libs/wxGTK-2.5*' >> /etc/portage/package.unmask<br>
echo 'x11-libs/wxGTK ~x86' >> /etc/portage/package.keywords<br></code>

If you want to use ''GTK1.2'' (recommended):<br>
<code>echo 'x11-libs/wxGTK -gtk2 -unicode -opengl' >> /etc/portage/package.use<br></code>

If you want to use ''GTK2'' (not thoroughly tested yet):<br>
<code>echo 'x11-libs/wxGTK -unicode -opengl' >> /etc/portage/package.use<br></code>

<code>emerge -av wxGTK</code>

== Compiling [[aMule]] ==
Grab either ''amule2.0.0rc8'' from http://www.aMule.org or (specially if you want to use [[aMuled]]) a recent [[aMule CVS|CVS tarball]] from http://amule.hirnriss.net. Untar it by entering <code>tar -xvjf aMule-foo.tar.bz2</code> and go into the newly created directory.

Check <code>./configure --help</code> for a summary of all configure options. Pick the ones you want and run (as an example building the monolithic client and [[aMuleCMD]])<br>
<code>./configure --enable-amulecmd</code>

Check the configure output for errors and if everything seems fine type <code>make</code>. Once [[aMule]] is done compiling change to a root account and type <code>make install</code> to install [[aMule]]. Now you're done and can start enjoying your [[aMule]] experience.

HowTo Compile In Gentoo

2005-04-07T13:49:59Z

Xaignar:

Compiling a recent version of [[aMule]] on [http://www.gentoo.org Gentoo] should be a breeze by just typing
''emerge -av amule''
but due to several facts it isn't quite that easy right now. So here's a little Step-by-Step explanation. Please read the whole document before doing anything as there are several ways you can use and each of them will have a different outcome.

'''Note:''' currently Diego "Flameeyes" Pettenò (non-official devel) is trying to make [[aMule]] merging simpler.
Please take a look at [http://bugs.gentoo.org/show_bug.cgi?id=71108 Gentoo Bug #71108] for further information. The new ebuild requires [[wxGTK]] 2.5, but there is another ebuild for [[wxGTK]] 2.5 (also from Diego) which should allow to safely unmask that version.

An eBuild for aMule-CVS can be found here:
http://forum.amule.org/thread.php?sid=&postid=30548

== Stable aMule from portage ==

If you just ''emerge amule'' you will most likely get the latest package that is marked as stable in portage. This is amule-1.2.8 which is more than 12 months old, lacks several bugfixes and features which could seriously lower your download or make it impossible to connect to some servers. So that is not really an option.

== Unstable aMule from portage ==

[http://www.gentoo.org Gentoo] classifies amule2.0.0rc ebuilds as unstable because they are ReleaseCandidates. The latest one available is ''amule2.0.0rc7''. There is an (inofficial) ebuild for rc8, but as rc8 depends on ''wxGTK2.5.3'' to build the [[aMuled|aMule daemon]] and ''wxGTK2.5.3'' is hardmasked in portage.

However, if rc7 is "new enough" for you enter the following things as root into a console:

<code>mkdir /etc/portage</code> (this could give an error message if the directory already exists, just ignore that)<br>
<code>echo 'net-p2p/amule ~x86' >> /etc/portage/package.keywords<br>
emerge -av amule</code>

However rc7 is getting quite old now, so it is the best thing to use either rc8 or even a recent cvs tarball and compile amule manually.

== Recent aMule manual installation ==

Per default [http://www.gentoo.org Gentoo] uses ''gtk2'' in all recent profiles. When it comes to [[wxGTK]] (which is needed by [[aMule]]) this can be some trouble. The recent stable [[wxGTK]] in portage is ''wxGTK2.4.2'' which should never be linked against ''GTK2''. It causes random crashes, freezes, inpredictable behaviour and may even harm your pet dog!

So there are two possible ways to go: choose ''wxGTK2.4.2'' linked against ''GTK1.2'' (which should be fine for everybody who doesn't want to use [[aMuled]], the [[aMuled|aMule daemon]]) or choose ''wxGTK2.5.3'' linked either against ''GTK1.2'' or ''GTK2'' (for those who want to try [[aMuled]] as [[aMuled]] doesn't work with [[wxGTK]] prior to 2.5.3).

Another thing is unicode support: You can't enable unicode support when using ''GTK1.2'' and enabling unicode with ''GTK2'' causes huge memleaks (100MB and more in 24h). So I will just disable it in these examples.

== wxGTK2.4.2 ==

If you don't want to use [[aMuled]] then ''wxGTK2.4.2'' is just fine for. You only need to tell it that it should link against ''GTK1.2''. To do this grab a console and enter (as root):

<code>mkdir /etc/portage</code> (this may give you an error if the directory already exists, just ignore that)<br>
<code> echo 'x11-libs/wxGTK -gtk2 -unicode' >> /etc/portage/package.use<br>
emerge -av wxGTK</code>

This should (re-)emerge ''wxGTK2.4.2'' linked against ''GTK1.2''. Now you can go on to [[HowTo_Compile_In_Gentoo#compiling_amule|compiling aMule]].

== wxGTK2.5.3 ==

If you want to use amuled then you need at least ''wxGTK2.5.3''. This is currently hardmasked in portage due to problems when compiling with [http://www.opengl.org OpenGL] support. But as [[aMule]] is no 3D egoshooter we can safely disable [http://www.opengl.org OpenGL] support and use it anyway. To do so enter the following into a console as root:

<code>mkdir /etc/portage</code> (this may give you an error if the directory already exists, just ignore that)<br>
<code>echo '=x11-libs/wxGTK-2.5*' >> /etc/portage/package.unmask<br>
echo 'x11-libs/wxGTK ~x86' >> /etc/portage/package.keywords<br></code>

If you want to use ''GTK1.2'' (recommended):<br>
<code>echo 'x11-libs/wxGTK -gtk2 -unicode -opengl' >> /etc/portage/package.use<br></code>

If you want to use ''GTK2'' (not thoroughly tested yet):<br>
<code>echo 'x11-libs/wxGTK -unicode -opengl' >> /etc/portage/package.use<br></code>

<code>emerge -av wxGTK</code>

== Compiling [[aMule]] ==
Grab either ''amule2.0.0rc8'' from http://www.aMule.org or (specially if you want to use [[aMuled]]) a recent [[aMule CVS|CVS tarball]] from http://amule.hirnriss.net. Untar it by entering <code>tar -xvjf aMule-foo.tar.bz2</code> and go into the newly created directory.

Check <code>./configure --help</code> for a summary of all configure options. Pick the ones you want and run (as an example building the monolithic client and [[aMuleCMD]])<br>
<code>./configure --enable-amulecmd</code>

Check the configure output for errors and if everything seems fine type <code>make</code>. Once [[aMule]] is done compiling change to a root account and type <code>make install</code> to install [[aMule]]. Now you're done and can start enjoying your [[aMule]] experience.

Main Page

2005-02-27T21:30:13Z

Xaignar: =FAQs:=

{|
| align="center" | http://www.amule.org/images/logo.gif

<h1>Welcome to the [http://wiki.org/wiki.cgi?WhatIsWiki Wiki] of the [[AMule_Project_FAQ:About|aMule Project]]</h1>
{| align="center"
| align="center" | We hope you will find some answers for your questions and problems!
|-
| align="right" | ''-- The [[aMule_devs|aMule Team]] --''
|-
| align="center" | <h3>'''English''' | [[Main_Page-es|Español]] | [[Main_Page-nl|Nederlands]]</h3>
|}
|-
| align="center" |
{|
| valign="top" |
== Installation ==
* Howto [[Compilation Installation|compile/install aMule from scratch]] ([[Compilation Installation-fr|French]]) ([[Compilation Installation-nl|Dutch]])
* Howto [[Install-amule-freebsd|compile aMule on FreeBSD]]
* Howto [[HowTo_compile_on_Mac|compile aMule on Mac]]
* Howto [[HowTo compile on Win32|compile aMule on Windows]]
* Howto [[HowTo_Compile_In_Debian|compile aMule in Debian or Ubuntu]]
* Howto [[HowTo_Compile_In_Gentoo|compile aMule in Gentoo]]
* Howto [[HowTo_Compile_In_Slackware|compile aMule in Slackware]]
* Howto [[HowTo_Compile_In_RedHat-Fedora|compile aMule in RedHat/Fedora]]
* Howto [[HowTo_Compile_In_FC3|compile aMule in Fedora Core 3]]
* Howto [[HowTo_Compile_In_MDK|install aMule in Mandrake 10]] ([[HowTo_Compile_In_MDK-es|Spanish]]) ([[MDK10_install-fr|French]])
* Howto [[SuSE_9.2_install_at_home|compile aMule in SuSE in your home directory]]
* Howto [[HowTo_Compile_aMuled|compile the aMule daemon (aMuled)]]

== Other ==
* Howto [[How_to_launch_VNC_with_aMule_at_Linux_boot|launch VNC with aMule at Linux boot]]
* Howto [[Check if wx is installed twice|check if wxWidgets is installed twice]]
* Howto [[How_to_uninstall_wxWidgets|remove wxWidgets]]
* Get [[wx-cvs|wxWidgets CVS]]
* About [[webcache]]
* User [[geaiez]]
* Some [[reviews]]
* Howto [[aMule_Project_FAQ:Help|edit a Wiki page]]
* Read [[current events]]

== Changelogs: ==
* [[Changelog_latest|Latest aMule release]]
* [[Changelog 2.0_series|aMule 2.0.0]]
** [[Changelog_2.0.0-rc1|aMule 2.0.0-rc1]]
** [[Changelog_2.0.0-rc2|aMule 2.0.0-rc2]]
** [[Changelog_2.0.0-rc3|aMule 2.0.0-rc3]]
** [[Changelog_2.0.0-rc4|aMule 2.0.0-rc4]]
** [[Changelog_2.0.0-rc4a|aMule 2.0.0-rc4a]]
** [[Changelog_2.0.0-rc5|aMule 2.0.0-rc5]]
** [[Changelog_2.0.0-rc6|aMule 2.0.0-rc6]]
** [[Changelog_2.0.0-rc7|aMule 2.0.0-rc7]]
** [[Changelog_2.0.0-rc8|aMule 2.0.0-rc8]]
* [[Changelog_1.2_series|aMule 1.2.X]]
* [[Changelog_1.1_series|aMule 1.1.X]]
* [[Changelog_1.0_series|aMule 1.0.X]]
| width="15px" | ||
| valign="top" |
== Usage ==
* Help [[Getting_Started|Getting Started With aMule]] ([[Getting_Started-fr|French]])
* Help [[aMule_problems|Common problems]] ([[aMule_problems-es|Spanish]]) ([[AMule_problems-nl|Dutch]])
* Help [[aMule is slow]]? ([[AMule_is_slow-it|Italian]]) ([[AMule_is_slow-nl|Dutch]])
* Help [[aMule makes everything slow]]?
* Info [[aMule files|aMule's files]]

== FAQs: ==
* FAQ [[FAQ_aMule|on aMule]] ([[FAQ aMule-es|Spanish]]) ([[FAQ aMule-it|Italian]]) ([[FAQ_aMule-pt_BR|Portuguese]]) ([[FAQ aMule-fr|French]]) ([[FAQ aMule-de|German]])
* FAQ [[FAQ_utils|on aMule's utilities]] ([[FAQ_utils-es|Spanish]])
* FAQ [[FAQ_ed2k|on ED2K-Kademlia]] ([[FAQ_ed2k-es|Spanish]]) ([[FAQ_ed2k-it|Italian]]) ([[FAQ_ed2k-de|German]]) ([[FAQ_ed2k-fr|French]]) ([[FAQ_eD2k-Kademlia-nl|Dutch]])
* FAQ on the [[FAQ_network|Transfer Rates on the eDonkey Network]]

== Setup tips ==
* Howto [[Ed2k links handling|handle ed2k:// links]]
* Howto [[Debian_fonts|solve font problems on Debian]]
* Howto [[import-export files]]
* Howto [[Firewall|setup iptables for aMule]]
* Howto [[Webserver|setup aMule's Webserver]]

== Development ==
* Grab the latest [[aMule CVS]]
* About the [[aMule_devs|Development Team]] and [[aMule_devs#Helping|joining it]]
* Howto [[Backtraces|create useful backtraces]]
* Howto [[Using gdb and valgrind|use GDB and Valgrind]]
* Howto [[Using_another_wxinstall|use more than one wxWidgets]] ([[Using_another_wxinstall-de|German]])
* Rules of [[coding style]]
* Running a [[testing field]]
* The [[GNU_FDL|GNU General Public License]]

== Translations ==
* Howto [[Translations|translate aMule in you own language]]
* Howto [[Translating Wiki|translate this Wiki]]
|}
|}

Main Page

2005-02-23T23:08:21Z

Xaignar:

{|
| align="center" | http://www.amule.org/images/logo.gif

<h1>Welcome to the [http://wiki.org/wiki.cgi?WhatIsWiki Wiki] of the [[AMule_Project_FAQ:About|aMule Project]]</h1>
{| align="center"
| align="center" | We hope you will find some answers for your questions and problems!
|-
| align="right" | ''-- The [[aMule_devs|aMule Team]] --''
|-
| align="center" | <h3>'''English''' | [[Main_Page-es|Español]]</h3>
|}
|-
| align="center" |
{|
| valign="top" |
== Installation ==
* Howto [[Compilation Installation|compile/install aMule from scratch]] ([[Compilation Installation-fr|French]]) ([[FAQ_eD2k-Kademlia-nl|Dutch]])
* Howto [[Install-amule-freebsd|compile aMule on FreeBSD]]
* Howto [[HowTo_compile_on_Mac|compile aMule on Mac]]
* Howto [[HowTo compile on Win32|compile aMule on Windows]]
* Howto [[HowTo_Compile_In_Debian|compile aMule in Debian or Ubuntu]]
* Howto [[HowTo_Compile_In_Gentoo|compile aMule in Gentoo]]
* Howto [[HowTo_Compile_In_Slackware|compile aMule in Slackware]]
* Howto [[HowTo_Compile_In_RedHat-Fedora|compile aMule in RedHat/Fedora]]
* Howto [[HowTo_Compile_In_FC3|compile aMule in Fedora Core 3]]
* Howto [[HowTo_Compile_In_MDK|install aMule in Mandrake 10]] ([[HowTo_Compile_In_MDK-es|Spanish]]) ([[MDK10_install-fr|French]])
* Howto [[SuSE_9.2_install_at_home|compile aMule in SuSE in your home directory]]

== Other ==
* Howto [[How_to_launch_VNC_with_aMule_at_Linux_boot|launch VNC with aMule at Linux boot]]
* Howto [[Check if wx is installed twice|check if wxWidgets is installed twice]]
* Howto [[How_to_uninstall_wxWidgets|remove wxWidgets]]
* Get [[wx-cvs|wxWidgets CVS]]
* About [[webcache]]
* User [[geaiez]]
* Some [[reviews]]
* Howto [[aMule_Project_FAQ:Help|edit a Wiki page]]
* Read [[current events]]

== Changelogs: ==
* [[Changelog_latest|Latest aMule release]]
* [[Changelog 2.0_series|aMule 2.0.0]]
** [[Changelog_2.0.0-rc1|aMule 2.0.0-rc1]]
** [[Changelog_2.0.0-rc2|aMule 2.0.0-rc2]]
** [[Changelog_2.0.0-rc3|aMule 2.0.0-rc3]]
** [[Changelog_2.0.0-rc4|aMule 2.0.0-rc4]]
** [[Changelog_2.0.0-rc4a|aMule 2.0.0-rc4a]]
** [[Changelog_2.0.0-rc5|aMule 2.0.0-rc5]]
** [[Changelog_2.0.0-rc6|aMule 2.0.0-rc6]]
** [[Changelog_2.0.0-rc7|aMule 2.0.0-rc7]]
** [[Changelog_2.0.0-rc8|aMule 2.0.0-rc8]]
* [[Changelog_1.2_series|aMule 1.2.X]]
* [[Changelog_1.1_series|aMule 1.1.X]]
* [[Changelog_1.0_series|aMule 1.0.X]]
| width="15px" | ||
| valign="top" |
== Usage ==
* Help [[Getting_Started|Getting Started With aMule]] ([[Getting_Started-fr|French]])
* Help [[aMule_problems|Common problems]] ([[aMule_problems-es|Spanish]]) ([[AMule_problems-nl|Dutch]])
* Help [[aMule is slow]]? ([[AMule_is_slow-it|Italian]]) ([[AMule_is_slow-nl|Dutch]])
* Help [[aMule makes everything slow]]?
* Info [[aMule files|aMule's files]]

== FAQs: ==
* FAQ [[FAQ_aMule|on aMule]] ([[FAQ aMule-es|Spanish]]) ([[FAQ aMule-it|Italian]]) ([[FAQ_aMule-pt_BR|Portuguese]]) ([[FAQ aMule-fr|French]]) ([[FAQ aMule-de|German]])
* FAQ [[FAQ_utils|on aMule's utilities]] ([[FAQ_utils-es|Spanish]])
* FAQ [[FAQ_ed2k|on ED2K-Kademlia]] ([[FAQ_ed2k-es|Spanish]]) ([[FAQ_ed2k-it|Italian]]) ([[FAQ_ed2k-de|German]]) ([[FAQ_ed2k-fr|French]]) ([[FAQ_eD2k-Kademlia-nl|Dutch]])

== Setup tips ==
* Howto [[Ed2k links handling|handle ed2k:// links]]
* Howto [[Debian_fonts|solve font problems on Debian]]
* Howto [[import-export files]]
* Howto [[Firewall|setup iptables for aMule]]
* Howto [[Webserver|setup aMule's Webserver]]

== Development ==
* Grab the latest [[aMule CVS]]
* About the [[aMule_devs|Development Team]] and [[aMule_devs#Helping|joining it]]
* Howto [[Backtraces|create useful backtraces]]
* Howto [[Using gdb and valgrind|use GDB and Valgrind]]
* Howto [[Using_another_wxinstall|use more than one wxWidgets]] ([[Using_another_wxinstall-de|German]])
* Rules of [[coding style]]
* Running a [[testing field]]
* The [[GNU_FDL|GNU General Public License]]

== Translations ==
* Howto [[Translations|translate aMule in you own language]]
* Howto [[Translating Wiki|translate this Wiki]]
|}
|}

AMule Project FAQ:About

2005-01-16T11:17:06Z

Xaignar: =[http://www.amule.org aMule] specific features=

== [http://www.amule.org aMule]: The [http://www.amule.org all-platform Mule] ==

[[aMule]] stands for ''all-platform [[Mule]]''.

[http://www.amule.org aMule] is an [[eMule]]-like client for the [[FAQ_eD2k-Kademlia|ed2k network]], supporting multiple platforms.

Currently (officially) supported platforms include:
*[http://www.kernel.org Linux]
*[http://www.bsd.org *BSD]:
**[http://www.freebsd.org FreeBSD]
**[http://www.openbsd.org OpenBSD]
**[http://www.netbsd.org NetBSD]
*[http://www.sun.com/solaris Solaris]
*[http://www.apple.com/macosx MacOS X]
*[http://www.microsoft.com/xbox XBox]
*Other *nix platforms are known to be supported allthough unofficially

Work is underway to add support for [http://www.microsoft.com/windows Microsoft Windows].

[http://www.amule.org aMule] is entirely [http://www.gnu.org/philosophy/free-sw.html free], it's sourcecode released under the [[AMule_Project_FAQ:Copyrights|GPL]] just like [[eMule]], and includes no adware or spyware as is often found in propertary [[P2P]] applications.

[http://www.amule.org aMule] is built upon the [[wxWidgets]] (formely [[wxWidgets|wxWindows]]) toolkit, which enables it to support multiple platforms.

All [http://www.amule.org aMule] [[dependencies|requirements]] are listed [[dependencies|here]].

== History ==

[http://www.amule.org aMule] was forked from the [[xMule]] project (formely known as [[lMule]]) back in september 2003, though now has less and less resemblance with the [[client]] that sired it.

== Features ==

=== *[[Mule]] features ===

[http://www.amule.org aMule] has most features of the [[eMule]] [[Client|client]]. These include:

* [http://www.amule.org aMule] is currently availabe in 28 languages.
* Support for [[FAQ_eD2k-Kademlia#What_is_a_source?|Source]] Exchange in order to find sources for files more efficently.
* Large queues and the [[FAQ_eD2k-Kademlia#What_is_all_that_credits,_rate_and_score_stuff_about?|Credit system]] helps to ensure that everyone will get the file they want and rewards those who activly upload to other users.
* Support for the the compressed transfers and server communication (using [http://www.gzip.org/zlib zlib]), which means faster transfers for compressable files and less strain on [[Server|servers]].
* Support for [[Secure_User_Identification|Secure Identification]], which insures that your user hash can't be stolen in order to inpersonate your [[client]].
* Support for [[IPFilter|IP-Filters]] so that you can keep known bad IPs from connecting to you.
* You can have the traditional progress bar for transfers, percents completed or both.
* [http://www.amule.org aMule] supports systrays for both [http://www.gnome.org Gnome], [http://www.kde.org KDE] and other window managers.
* Supports [[Signature|Online Signatures]], so you can brag about using aMule.
* Checks against aggressive [[Client|clients]].
* Uses [[MD4 hash]]es to find [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] and ensure that the file macthes the original copies of the file, in order to avoid corruption.
* [[ICH|Intelligent Corruption Handler (ICH)]] and [[AICH]] helps to speed up the correction of corrupted parts.
* Auto priorities and source management allow you to start many downloads without having to monitor them.
* The Preview function allows you to look at your videos and archives before they are completed. For video previewing, [http://www.mplayerhq.hu MPlayer] or [http://xine.sourceforge.net Xine] are recommended but [http://www.videolan.org Video Lan Client] should work too.
* Support for categories so that you can organize your downloads.
* To find the files you want, [http://www.amule.org aMule] offers a lot of search possibilities, which are:
** [[Server]]s (local and global) and of course direct integration in your favourite browser for easy click-and-download (with [[ed2k link|ed2k:// links]]).
* Messaging and [[Friend|Friends]] system:
** You can send messages to other [[client]]s and add them as [[Friend|friends]].
* [http://www.amule.org aMule] supports updating the [[Server|server]] list from an URL during run-time or startup.
* [http://www.amule.org aMule] can also update it's [[server]] list as it connects to other [[client]]s.
* [[PowerShare]] function: better handling of your shared files (release).

=== [http://www.amule.org aMule] specific features ===
* Checks against aggressive clients.
* [[FAQ_aMule#What_is_slot_allocation?|Slot allocation]] allows you to specify how many you wish to upload to at once. For example, if you have 20 kb/s for your maximum upload, you can set [[FAQ_eD2k-Kademlia#What_is_a_slot?|slot]] allocation to 10 kb/s which means that you will upload to two users with 10 kb/s each.
** The [[aMuleCMD|amulecmd]] command line interface and [[aMuleCMD|amulecmdDLG]] and graphical command line interface, to connect to your running [http://www.amule.org aMule] and get status or send commands. Works locally and from remote [[client]]s. '''NOTE:''' [[aMuleCMD|amulecmd]] and [[aMuleCMD|amulecmdDLG]] also work in [http://www.microsoft.com/windows Windows]! You can control your [http://www.kernel.org Linux] box from your office's [http://www.microsoft.com/windows Windows] ;)
* Fast [[ed2k link|ED2K Links]] handler at the bottom of every page (can be disabled on Preferences).
* Save 5 [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] on rare files (<20 sources).
* Default file permissions for completed downloads.

=== Planned features ===
* [[FAQ_eD2k-Kademlia#What_is_Kademlia?|Kademlia]] support.
* Complete [[External Connections]], [[aMuleWeb|webserver]] and [[aMuleCMD]] rewrite (under heavy development at the moment, be patient please).
* Skins support.
* Remote GUI (for [[FAQ_amuled|aMuled]]).
* [[Proxy]] support.
* Boolean search (AND, OR, NOT) + with/without Unicode
* Disk allocation for incomplete files.
* and and and ..

Changelog 2.0 series

2005-01-15T21:00:33Z

Xaignar:

This are the aMule 2.0.x release changelogs available:

[[Changelog_2.0.0-rc1|aMule 2.0.0-rc1]]<br>
[[Changelog_2.0.0-rc2|aMule 2.0.0-rc2]]<br>
[[Changelog_2.0.0-rc3|aMule 2.0.0-rc3]]<br>
[[Changelog_2.0.0-rc4|aMule 2.0.0-rc4]]<br>
[[Changelog_2.0.0-rc4a|aMule 2.0.0-rc4a]]<br>
[[Changelog_2.0.0-rc5|aMule 2.0.0-rc5]]<br>
[[Changelog_2.0.0-rc6|aMule 2.0.0-rc6]]<br>
[[Changelog_2.0.0-rc7|aMule 2.0.0-rc7]]<br>
[[Changelog_2.0.0-rc8|aMule 2.0.0-rc8]]<br>

AMule devs

2005-01-14T12:50:01Z

Xaignar: =Becoming a Developer=

== The [[aMule]] Project ==
The aMule project is led by a bunch in people who toil away in front of their computers, so that you can enjoy a stable and featureful P2P client.
This page is about us.

== The Team ==
These are the people who work on aMule:

=== Developers ===

* [[User:deltaHF|deltaHF]]: Webmaster, Admin and from-time-to-time-coder ;)
* [[User:Jacobo221|Jacobo221]]: Our man-for-all
* [[User:Kry|Kry]]: Main developer and Admin
* [[User:lfroen|lfroen]]: Core/GUI dedicated guy.
* [[User:Phoenix|Phoenix]]: Code janitor junior.
* [[User:thepolish|thepolish]]: [[aMule]] [[FAQ_utils|tools]] coder.
* [[User:Unleashed|Unleashed]]: Sometimes around ;)
* [[User:Xaignar|Xaignar]]: Code janitor extraordinaire!
* [[User:GonoszTopi|GonoszTopi]]: [[External Connections]] developer.
* [[User:falso|falso]]: [[CAS]] coder.
* [[User:Hetfield|Hetfield]]: Admin, pretty-no-free-time coder.

=== Testers ===
* [[User:Citroklar|Citroklar]]: Tester, slave-work-coder (sometimes)
* ender`: Tester
* nachbarnebenan: Tester, and life-complicator by using large&strange nicks ;-P
* nich: Tester
* [[User:Stefanero|Stefanero]]: Supporter, Tester, and [[aMuleWeb]] Guru

=== Special Gold Guest Members ===
* [[User:Bigbob|Bigbob]]: Also known as ''[[User:Bigbob|Creteil]]''; [[aMule]] project creator.
* [[User:Madcat|Madcat]]: The one and only kitty dev.
* [[User:Tiku|Tiku]]: And God said: Let there be [[lMule]]!

=== Others ===
* [[User:Bootstrap|bootstrap]]: [[IRC]] bot (''bootbox'') and [[aMule CVS]] hoster
* [[User:uberpenguin|uberpenguin]]: uberpenguin is extremely difficult to classify... Let us call him the 'official bystander to *mule'.
* niet: [http://www.dns.net/dnsrd DNS] stuff, [[XAS]], tester.

=== Former Team-members ===
These are people who have worked on [[aMule]] in the past.
Please note that this list doesn't include the people from before [[aMule]] forked off from [[xMule]], nor does it include people from the [[LMule]] days. If you wish to learn more about those, please visit the websites of those projects.

==== Developers ====
* shakraw: [[aMuleWeb]] mantainer.

==== Testers ====

== Helping ==
We can always use another helping hand, and if you are interested, then I'd encourage you to contact us and see if you can help us. Currently, what we need the most is developers and testers, though also translators and others.

=== Becoming a Developer ===
To become a [[aMule]] Developer (tm), you'll need at the very least a working knowledge of C++, since that is the language in which [[aMule]] is written. You'll also need to learn about the GUI toolkit used by [[aMule]]: [[wxWidgets]].

However, we do not require that you are an expert, only that you are willing to help and willing to learn.

If you are interested, then simply drop by on [[IRC]] and let us know. Currently we use a private [http://www.gnu.org/software/cvs CVS] server, but after you've submitted a patch or two you can easily get r/w access to it. You can also post patches on the [http://www.amule-project.net/amule/board.php?boardid=47 Development] forum, however, virtually all discussions regarding development happens on [[IRC]], so learning about that is a good idea as well.

We can use your skills if you are using one of the platforms where we aim at being usable on: Unix, [http://www.sun.com/solaris Solaris], [http://www.apple.com Macs] and [http://www.microsoft.com/windows Windows].
And if your operating system of choice isn't on that list, then maybe you can help add it.

=== Becoming a Tester ===
We need people who are willing to create complete bug-reports, as the standard is pretty low regarding user reports. This is rather simple, but takes patience. Please contact us on [[IRC]] for more information and read [[Backtraces|this guide on creating useful backtraces]].

=== Becoming a Translator ===
[[aMule]] already includes translations for a number of languages, however, we'll always welcome more, and even if your language of choice has been done already, then perhaps you can help improve it. Please see the [http://forum.amule.org/board.php?boardid=40 Translations forum] for more information on current translations, or contact us on [[IRC]]. Also, take a deep look into the [[Translations|aMule translation howto]].

Of course, you can also work on [[Translating_Wiki|translating this wiki]]'s articles. There's still a lot of work to do!

Getting Started

2004-09-27T18:36:21Z

Xaignar: =Searching and Downloading=

== What is [[aMule]] ==
[[aMule]] is a client for the [[P2P|peer-to-peer]] [[FAQ_eD2k-Kademlia|eD2k]] network commonly called the [[FAQ_eD2k-Kademlia|eDonkey network]], or the ed2k network ([[eDonkey2000]]). This guide does not require that you are familiar with another network (but it helps), however it does require that you have gotten [[aMule]] installed on your computer.
If you haven't installed [[aMule]] yet, then please refer to the installation guide appropriate for your system. Links to these can be found on the [[Main_Page|main page]].

--[[User:Xaignar|Xaignar]] 01:12, 10 Jul 2004 (CEST)

== Running [[aMule]] for the first time ==
Start by running [[aMule]]. Usually this can be done by executing the command ''amule'' in a console window or by whatever method might be provided by your distro and windows manager.

Once started, if you are using a [http://www.gnu.org/software/cvs CVS] build, [[aMule]] will display a notification telling you that you are running it for the first time. Read this to learn what you are getting yourself into ;)

=== Configuring [[aMule]] ===
On the top of the [[aMule]] window, there is a row of labelled icons. Click the one marked preferences to enter the configuration dialog. Before you start downloading files, you'll need to properly set your connection speed and possibly other settings.

==== Connection Speed ====
You should know that the eDonkey clients enforce upload, which means that in order to download, you'll have to share files yourself (don't worry if you don't have anything to share). This is enforced in two ways:
* Your download speed depends on how fast you upload. If your upload speed is set to anything below 10kb/s, your maximum download speed will be 3 or 4 times your uploadspeed (read [[FAQ_eD2k-Kademlia#Are_there_any_limitations_on_the_ED2K_network?|this]] to know more about it), so if you limit your upload speed to 5kb/s, you'll only be able to download with 20kb/s.
* Partially downloaded files are shared as well. You automatically start sharing a file after you've received at least one [[FAQ_eD2k-Kademlia#What_is_a_chunk?|chunk]] (a [[FAQ_eD2k-Kademlia#What_is_a_chunk?|chunk]] is a 9.28Mb piece of a file).

Note: If you ever enter the [http://forum.amule.org aMule forum] or [[IRC|IRC channel]] to complain about this or demand that we change the ratio, then I will hunt you down and eat your spleen. -- [[User:Xaignar|Xaignar]]

When you first open the Preferences dialog, the page shown will be "General", which contains some general settings, like the [[nickname]] other people will see when they download from or upload to you.
To proceed, click on the tab named "Connection":
<br><center>http://www.amule.org/dev-up/Limits.png</center>

The only settings relevant to this guide are the settings under "Bandwidth Limits" marked "Upload" and "Download". You don't need to enter a max download speed, but it is recommended that you set the upload speed to around 80% of your actual speed, since it can cause slower downloads otherwise.

Once you have entered the proper values, you can explore the rest of the settings. To save the changes, simply click the "OK" button.

=== Connecting to a Server ===

You should now be looking at the servers dialog:
http://www.amule.org/dev-up/ServerDlg.png

The empty list normally contains the servers you know about, but since this is the first time you're running [[aMule]], you don't have any. To remedy this situation, simply click in the text-field containing the text ''http://www.srv1000.com/azz/server.met'' and press enter.
A dialog will pop up and close again once the download has completed.

You should now have a full list of servers, if not search google for ''server.met'' and place the file in the folder ''.aMule'' on your home dir. The list should look like this:
http://www.amule.org/dev-up/ServerList.png

Next you need to connect to a [[server]]. Normally it's a good idea to select one with as many users as possible, but for now, lets just click the large "Connect" button near the top-left of the window. This will connect you to a random server. Please wait while [[aMule]] contacts servers and tries to establish an connection. Once this happens, proceed on to the next section.

=== [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|High and Low ID]] ===
Because [[P2P|p2p]] networks works by [[Client|clients]] directly contact each other, being behind a firewall or router can really cause problems. If you don't know whenever or not you are behind a firewall, simply look at the icon in the bottom-right of the window. If it is green, then you have [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|High ID]] and can proceed, but if it is yellow, then you need to take a look at the page on [[Firewall|Firewalls]] and/or [[AMule_problems#aMule_connects_to_server,_but_it_is_always_given_LowID._Why?_and,_can_I_do_something_about_it?|common problems]], since having [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|Low ID]] means greatly reduced capabilities.

== Basic Usage ==
This will cover some basic usage of [[aMule]].

=== Searching and Downloading ===
OK, this is what [[P2P|p2p]]'ing is about: Downloading files.
For the sake of this guide, I'll presume that you are really keen on downloading the latest [http://www.knoppix.org Knoppix] CD (who isn't?). To download this, first ensure that you are connected to a server and then click on the "Searches" button.

This will bring up the search dialog:
http://www.amule.org/dev-up/SearchDlg.png

Since we only care about CD images, we select the option "CD-Images" from the "Type" dropdown menu. Also untick the "Global Search" setting, since we don't really need to search anything other than the currently connected [[server]]. Then we enter ''Knoppix'' in the top "Name" field and hit enter or the "Search" button. You should now have a listful of results:
http://www.amule.org/dev-up/SearchResults.png

Lets sort the list by [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]], by clicking twice on the field marked "Sources", this makes it easier to find popular files. The second one looks interesting, so we double-click on it (or click on it and then on the "Download" button). This will queue the file for download.

Results can be displayed in a number of colors, which signify the following:
* Blue represents the number of sources, the more sources the darker the blue.
* Red represents files that you are currently downloading.
* Green is for files you have downloaded or shared before, in other words files you already have.

=== The Download Queue ===
Click on the "Transfers" button to bring forth a list of files you have queued for download:
http://www.amule.org/dev-up/DownloadQueue.png

If you're lucky, the progress bar will turn a nice dark shade of blue, which means that a lot of people have that file (read [[FAQ_aMule#What_do_those_colors_in_the_progress_bar_mean?|this]] to know more about it). Beware of files that have parts marked in red, since it means that no-one has that part of the file and you most likely wont be able to complete the download.

If you double-click on any of the files, you can see the [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] you have found for that file.

==== Of Rows and Columns ====
These are the columns of the Download Queue:

; ''Filename'' : The name of the file.
; ''Size'' : The size of the file. The eDonkey2000 network supports files up to 4GB in size (read [[FAQ_eD2k-Kademlia#Are_there_any_limitations_on_the_ED2K_network?|more]] about this).
; ''Transferred'' : Shows the amount downloaded.
; ''Completed'' : This column displays how much of the file you have actually completed. Please note that this can differ from the Transferred column because of corruptions or gains made by the compression *Mule [[Client|clients]] use (read [[FAQ_aMule#What_is_the_difference_between_Transfered_and_Completed_in_the_Tranfers_window?|more]] about this difference).
; ''Progress'' : This bar displays the current progress of the file, the colours signifying the following (alternative [[FAQ_aMule#What_do_those_colors_in_the_progress_bar_mean?|resource]]):
* Blue: How many sources provide this part, the darker the colour, the more sources provide it.
* Red: There are no known [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] that provide this part.
* Black: You have already downloaded this part.
* Yellow: You are currently downloading this part.
: The green bar on top of the larger bar gives an indication of the actual progress.
; ''Sources'' : There are 3 fields in this column, though mostly only 2 are shown (alternative [[FAQ_aMule#What_do_all_those_numbers_in_the_sources_column_in_the_transfers_window_mean?|resource]]):
: <Asked [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]>[/<All [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]>] [+ <[[FAQ_aMule#What_is_A4AF?|A4AF]] [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]> ] [(<Transferring [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]]>)]
: 'Asked [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]' are those that have been asked for the file.
: 'All [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]' are all [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] of that file, asked and unasked.
: '[[FAQ_aMule#What_is_A4AF?|A4AF (Asked For Another File)]] [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]' are [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] that provide that file, but have been asked for anther one.
: 'Transferring [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]]' are [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] which are uploading that file to you at this very moment.
; ''Priority'' : The priority of the file. Files are set to auto-priority by default, which means that [[aMule]] will manage it by itself. Priorities affect how [[aMule]] allocates [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] that are known to provide multiple files and thus means that high-priority files get more [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]]. Read [[FAQ_aMule#What_do_all_those_numbers_in_the_priority_column_in_the_extended_transfers_window_mean?|more]] about this.
; ''Status'' : The current status of the file. Waiting means that you are waiting for sources to start uploading to you.
; ''Time Remaining'' : An guess at how fast the file will be completed. Only shows something when you are currently receiving the file.
; ''Last Seen Complete'' : This shows the last time you've seen the entire file provided by the [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] you've asked.
; ''Last Reception'' : This shows the last time you were downloading parts of this file.

=== The Upload Queue ===
The upload queue can be found just beneath the download queue, and shows who are downloading files from you (you might want to read [[FAQ_aMule#Why_are_there_two_transfer_rates_in_the_uploading_transfer_list?|this]]). In case you are wondering, no, you cannot stop uploads. If you click on the blue icon next to the "Uploads" label, you can see who are queued for downloading from you, rather than the people who are actually downloading from you right now.

=== Icons and What They Signify ===
These are the icons that can be found on the Transfers page.

* '''Source Status'''
** http://www.amule.org/dev-up/Source_1.png - [[Client]] is sending you either a file or a hashset.
** http://www.amule.org/dev-up/Source_2.png - You are either on this [[Client|clients]] queue or currently asking it for a file.
** http://www.amule.org/dev-up/Source_3.png - You are currently connecting to this [[Client|client]].
** http://www.amule.org/dev-up/Source_4.png - [[Client]] has been asked for another file, has no needed parts or is unable to connect because of a [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|Low ID]].
** http://www.amule.org/dev-up/Source_5.png - Status is unknown.

* '''eDonkey Clients'''
** http://www.amule.org/dev-up/Client_aMule.png - [[aMule]]
** http://www.amule.org/dev-up/Client_eDonkey.png - [[eDonkey2000]]
** http://www.amule.org/dev-up/Client_eMule.png - [[eMule]]
** http://www.amule.org/dev-up/Client_Friend.png - [[Client]] is a [[Friend]]
** http://www.amule.org/dev-up/Client_Lphant.png - [[lphant]]
** http://www.amule.org/dev-up/Client_MLDonkey.png - [[mlDonkey]]
** http://www.amule.org/dev-up/Client_Shareaza.png - [[Shareaza]]
** http://www.amule.org/dev-up/Client_Unknown.png - Unknown [[Client]]
** http://www.amule.org/dev-up/Client_xMule.png - [[xMule]]

* '''Modifiers'''
** http://www.amule.org/dev-up/Client_Mod_eMuleProt.png - [[Client]] supports the extended [[eMule]] protocols. Source-sharing and such.
** http://www.amule.org/dev-up/Client_Mod_GoodCredit.png - [[Client]] has a good [[FAQ_eD2k-Kademlia#What_is_all_that_credits,_rate_and_score_stuff_about?|credit-rating]].
** http://www.amule.org/dev-up/Client_Mod_NormCredit.png - [[Client]] has a normal [[FAQ_eD2k-Kademlia#What_is_all_that_credits,_rate_and_score_stuff_about?|credit-rating]].
** http://www.amule.org/dev-up/Client_Mod_SecId_Good.png - [[Client]] has been [[Secure_User_Identification|securely identified]].
** http://www.amule.org/dev-up/Client_Mod_SecId_Bad.png - [[Client]] has been for some reason been identified as a [[bad guy]].

* '''File [[comment]]s'''
** http://www.amule.org/dev-up/File_Comment.png - This file has either been rated or someone has added a [[comment]].
** http://www.amule.org/dev-up/File_Comment_Bad.png - This file has been rated as [[Fake]] by at least one person.

=== Where Are The Files? ===
Once [[aMule]] starts downloading a file, it will create a number of files to keep track of that specific download. These files can be found in the subdir ''.aMule/Temp'' in your homedir (''~/.aMule/Temp''), but should not be touched in most cases.

If you have incompleted downloads from [[eMule]], you can simply place the temp files in the ''~/.aMule/Temp'' directory if you wish for [[aMule]] to continue downloading them.

However, once a file has been completed, it will be moved away from ''~/.aMule/Temp'' and to ''~/.aMule/Incoming'', where all completed files are placed by default. You can change both of these paths in the preferences should you wish to do so.

Also, please note that the ''.aMule'' directory is a hidden directory, so you might have to enable showing of hidden files in your file-mananger, should you use one such.

== Conclusion ==
Hopefully this brief introduction has given you an idea of how [[aMule]] works. If you feel that something is missing from this guide, please let us know or add it yourself.

XMule

2004-09-15T16:39:44Z

Xaignar: xMule no longer bans e/a mule AFAIK

== [http://www.xmule.ws xMule] ==

[http://www.xmule.ws xMule] is a fork of [[LMule]], and was the defacto [[eMule]] [[Client|client]] for [http://www.kernel.org Linux] until [[aMule]] appeared and challenged that position. However, [http://www.xmule.ws xMule] is still under active development, primarily by [[HopeSeekr]], the person who originally forked [[LMule|lMule]]. Please refer to the [http://www.xmule.ws xMule website] for more information on its current progress.

[[aMule]] is a fork of [http://www.xmule.ws xMule], though both projects have moved further and further apart since then. Diplomatic relations between the two projects are sadly in a rather sorry state.

'''NOTE:''' [[aMule]] is a '''separate''' project and is '''not''' related to [http://www.xmule.ws xMule] in any way (apart from being originally a fork from it).

Getting Started

2004-08-16T13:24:39Z

Xaignar: Reverted edit of 81.182.126.120, changed back to last version by 81.11.176.162

== What is [[aMule]] ==
[[aMule]] is a client for the [[P2P|peer-to-peer]] networked commonly called the [[eDonkey2000|eDonkey network]], or the ed2k network ([[eDonkey2000]]). This guide does not require that you are familiar with another network (but it helps), however it does require that you have gotten [[aMule]] installed on your computer.
If you haven't installed [[aMule]] yet, then please refer to the installation guide appropriate for your system. Links to these can be found on the [[Main_Page|main page]].

--[[User:Xaignar|Xaignar]] 01:12, 10 Jul 2004 (CEST)

== Running [[aMule]] for the first time ==
Start by running [[aMule]]. Usually this can be done by executing the command ''amule'' in a console window or by whatever method might be provided by your distro and windows manager.

Once started, if you are using a [http://www.gnu.org/software/cvs CVS] build, [[aMule]] will display a notification telling you that you are running it for the first time. Read this to learn what you are getting yourself into ;)

=== Configuring [[aMule]] ===
On the top of the [[aMule]] window, there is a row of labelled icons. Click the one marked preferences to enter the configuration dialog. Before you start downloading files, you'll need to properly set your connection speed and possibly other settings.

==== Connection Speed ====
You should know that the eDonkey clients enforce upload, which means that in order to download, you'll have to share files yourself (don't worry if you don't have anything to share). This is enforced in two ways:
* Your download speed depends on how fast you upload. If your upload speed is set to anything below 10kb/s, your maximum download speed will be 3 or 4 times your uploadspeed (read [[FAQ_eD2k/Kademlia#Are_there_any_limitations_on_the_ED2K_network?|this]] to know more about it), so if you limit your upload speed to 5kb/s, you'll only be able to download with 20kb/s.
* Partially downloaded files are shared as well. You automatically start sharing a file after you've received at least one [[FAQ_eD2k/Kademlia#What_is_a_chunk?|chunk]] (a [[FAQ_eD2k/Kademlia#What_is_a_chunk?|chunk]] is a 9.28Mb piece of a file).

Note: If you ever enter the [http://forum.amule.org aMule forum] or [[IRC|IRC channel]] to complain about this or demand that we change the ratio, then I will hunt you down and eat your spleen. -- [[User:Xaignar|Xaignar]]

When you first open the Preferences dialog, the page shown will be "General", which contains some general settings, like the [[nickname]] other people will see when they download from or upload to you.
To proceed, click on the tab named "Connection":
<br><center>http://www.amule.org/dev-up/Limits.png</center>

The only settings relevant to this guide are the settings under "Bandwidth Limits" marked "Upload" and "Download". You don't need to enter a max download speed, but it is recommended that you set the upload speed to around 80% of your actual speed, since it can cause slower downloads otherwise.

Once you have entered the proper values, you can explore the rest of the settings. To save the changes, simply click the "OK" button.

=== Connecting to a Server ===

You should now be looking at the servers dialog:
http://www.amule.org/dev-up/ServerDlg.png

The empty list normally contains the servers you know about, but since this is the first time you're running [[aMule]], you don't have any. To remedy this situation, simply click in the text-field containing the text ''http://www.srv1000.com/azz/server.met'' and press enter.
A dialog will pop up and close again once the download has completed.

You should now have a full list of servers, if not search google for ''server.met'' and place the file in the folder ''.aMule'' on your home dir. The list should look like this:
http://www.amule.org/dev-up/ServerList.png

Next you need to connect to a [[server]]. Normally it's a good idea to select one with as many users as possible, but for now, lets just click the large "Connect" button near the top-left of the window. This will connect you to a random server. Please wait while [[aMule]] contacts servers and tries to establish an connection. Once this happens, proceed on to the next section.

=== [[FAQ_eD2k/Kademlia#What_is_LowID_and_HighID?|High and Low ID]] ===
Because [[P2P|p2p]] networks works by [[Client|clients]] directly contact each other, being behind a firewall or router can really cause problems. If you don't know whenever or not you are behind a firewall, simply look at the icon in the bottom-right of the window. If it is green, then you have [[FAQ_eD2k/Kademlia#What_is_LowID_and_HighID?|High ID]] and can proceed, but if it is yellow, then you need to take a look at the page on [[Firewall|Firewalls]] and/or [[AMule_problems#aMule_connects_to_server,_but_it_is_always_given_LowID._Why?_and,_can_I_do_something_about_it?|common problems]], since having [[FAQ_eD2k/Kademlia#What_is_LowID_and_HighID?|Low ID]] means greatly reduced capabilities.

== Basic Usage ==
This will cover some basic usage of [[aMule]].

=== Searching and Downloading ===
OK, this is what [[P2P|p2p]]'ing is about: Downloading files.
For the sake of this guide, I'll presume that you are really keen on downloading the latest [http://www.knoppix.org Knoppix] CD (who isn't?). To download this, first ensure that you are connected to a server and then click on the "Searches" button.

This will bring up the search dialog:
http://www.amule.org/dev-up/SearchDlg.png

Since we only care about CD images, we select the option "CD-Images" from the "Type" dropdown menu. Also untick the "Global Search" setting, since we don't really need to search anything other than the currently connected [[server]]. Then we enter ''Knoppix'' in the top "Name" field and hit enter or the "Search" button. You should now have a listful of results:
http://www.amule.org/dev-up/SearchResults.png

Lets sort the list by [[FAQ_eD2k/Kademlia#What_is_a_source?|sources]], by clicking twice on the field marked "Sources", this makes it easier to find popular files. The second one looks interesting, so we double-click on it (or click on it and then on the "Download" button). This will queue the file for download.

=== The Download Queue ===
Click on the "Transfers" button to bring forth a list of files you have queued for download:
http://www.amule.org/dev-up/DownloadQueue.png

If you're lucky, the progress bar will turn a nice dark shade of blue, which means that a lot of people have that file (read [[FAQ_aMule#What_do_those_colors_in_the_progress_bar_mean?|this]] to know more about it). Beware of files that have parts marked in red, since it means that no-one has that part of the file and you most likely wont be able to complete the download.

If you double-click on any of the files, you can see the [[FAQ_eD2k/Kademlia#What_is_a_source?|sources]] you have found for that file.

==== Of Rows and Columns ====
These are the columns of the Download Queue:

; ''Filename'' : The name of the file.
; ''Size'' : The size of the file. The eDonkey2000 network supports files up to 4GB in size (read [[FAQ_eD2k/Kademlia#Are_there_any_limitations_on_the_ED2K_network?|more]] about this).
; ''Transferred'' : Shows the amount downloaded.
; ''Completed'' : This column displays how much of the file you have actually completed. Please note that this can differ from the Transferred column because of corruptions or gains made by the compression *Mule [[Client|clients]] use (read [[FAQ_aMule#What_is_the_difference_between_Transfered_and_Completed_in_the_Tranfers_window?|more]] about this difference).
; ''Progress'' : This bar displays the current progress of the file, the colours signifying the following (alternative [[FAQ_aMule#What_do_those_colors_in_the_progress_bar_mean?|resource]]):
* Blue: How many sources provide this part, the darker the colour, the more sources provide it.
* Red: There are no known [[FAQ_eD2k/Kademlia#What_is_a_source?|sources]] that provide this part.
* Black: You have already downloaded this part.
* Yellow: You are currently downloading this part.
: The green bar on top of the larger bar gives an indication of the actual progress.
; ''Sources'' : There are 3 fields in this column, though mostly only 2 are shown (alternative [[FAQ_aMule#What_do_all_those_numbers_in_the_sources_column_in_the_transfers_window_mean?|resource]]):
: <Asked [[FAQ_eD2k/Kademlia#What_is_a_source?|Sources]]>[/<All [[FAQ_eD2k/Kademlia#What_is_a_source?|Sources]]>] [+ <[[FAQ_aMule#What_is_A4AF?|A4AF]] [[FAQ_eD2k/Kademlia#What_is_a_source?|Sources]]> ] [(<Transferring [[FAQ_eD2k/Kademlia#What_is_a_source?|sources]]>)]
: 'Asked [[FAQ_eD2k/Kademlia#What_is_a_source?|Sources]]' are those that have been asked for the file.
: 'All [[FAQ_eD2k/Kademlia#What_is_a_source?|Sources]]' are all [[FAQ_eD2k/Kademlia#What_is_a_source?|sources]] of that file, asked and unasked.
: '[[FAQ_aMule#What_is_A4AF?|A4AF (Asked For Another File)]] [[FAQ_eD2k/Kademlia#What_is_a_source?|Sources]]' are [[FAQ_eD2k/Kademlia#What_is_a_source?|sources]] that provide that file, but have been asked for anther one.
: 'Transferring [[FAQ_eD2k/Kademlia#What_is_a_source?|sources]]' are [[FAQ_eD2k/Kademlia#What_is_a_source?|sources]] which are uploading that file to you at this very moment.
; ''Priority'' : The priority of the file. Files are set to auto-priority by default, which means that [[aMule]] will manage it by itself. Priorities affect how [[aMule]] allocates [[FAQ_eD2k/Kademlia#What_is_a_source?|sources]] that are known to provide multiple files and thus means that high-priority files get more [[FAQ_eD2k/Kademlia#What_is_a_source?|sources]]. Read [[FAQ_aMule#What_do_all_those_numbers_in_the_priority_column_in_the_extended_transfers_window_mean?|more]] about this.
; ''Status'' : The current status of the file. Waiting means that you are waiting for sources to start uploading to you.
; ''Time Remaining'' : An guess at how fast the file will be completed. Only shows something when you are currently receiving the file.
; ''Last Seen Complete'' : This shows the last time you've seen the entire file provided by the [[FAQ_eD2k/Kademlia#What_is_a_source?|sources]] you've asked.
; ''Last Reception'' : This shows the last time you were downloading parts of this file.

=== The Upload Queue ===
The upload queue can be found just beneath the download queue, and shows who are downloading files from you (you might want to read [[FAQ_aMule#Why_are_there_two_transfer_rates_in_the_uploading_transfer_list?|this]]). In case you are wondering, no, you cannot stop uploads. If you click on the blue icon next to the "Uploads" label, you can see who are queued for downloading from you, rather than the people who are actually downloading from you right now.

=== Icons and What They Signify ===
These are the icons that can be found on the Transfers page.

* '''Source Status'''
** http://www.amule.org/dev-up/Source_1.png - [[Client]] is sending you either a file or a hashset.
** http://www.amule.org/dev-up/Source_2.png - You are either on this [[Client|clients]] queue or currently asking it for a file.
** http://www.amule.org/dev-up/Source_3.png - You are currently connecting to this [[Client|client]].
** http://www.amule.org/dev-up/Source_4.png - [[Client]] has been asked for another file, has no needed parts or is unable to connect because of a [[FAQ_eD2k/Kademlia#What_is_LowID_and_HighID?|Low ID]].
** http://www.amule.org/dev-up/Source_5.png - Status is unknown.

* '''eDonkey Clients'''
** http://www.amule.org/dev-up/Client_aMule.png - [[aMule]]
** http://www.amule.org/dev-up/Client_eDonkey.png - [[eDonkey2000]]
** http://www.amule.org/dev-up/Client_eMule.png - [[eMule]]
** http://www.amule.org/dev-up/Client_Friend.png - [[Client]] is a [[Friend]]
** http://www.amule.org/dev-up/Client_Lphant.png - [[lphant]]
** http://www.amule.org/dev-up/Client_MLDonkey.png - [[mlDonkey]]
** http://www.amule.org/dev-up/Client_Shareaza.png - [[Shareaza]]
** http://www.amule.org/dev-up/Client_Unknown.png - Unknown [[Client]]
** http://www.amule.org/dev-up/Client_xMule.png - [[xMule]]

* '''Modifiers'''
** http://www.amule.org/dev-up/Client_Mod_eMuleProt.png - [[Client]] supports the extended [[eMule]] protocols. Source-sharing and such.
** http://www.amule.org/dev-up/Client_Mod_GoodCredit.png - [[Client]] has a good [[FAQ_eD2k/Kademlia#What_is_all_that_credits,_rate_and_score_stuff_about?|credit-rating]].
** http://www.amule.org/dev-up/Client_Mod_NormCredit.png - [[Client]] has a normal [[FAQ_eD2k/Kademlia#What_is_all_that_credits,_rate_and_score_stuff_about?|credit-rating]].
** http://www.amule.org/dev-up/Client_Mod_SecId_Good.png - [[Client]] has been [[Secure_User_Identification|securely identified]].
** http://www.amule.org/dev-up/Client_Mod_SecId_Bad.png - [[Client]] has been for some reason been identified as a [[bad guy]].

* '''File [[comment]]s'''
** http://www.amule.org/dev-up/File_Comment.png - This file has either been rated or someone has added a [[comment]].
** http://www.amule.org/dev-up/File_Comment_Bad.png - This file has been rated as [[Fake]] by at least one person.

== Conclusion ==
Hopefully this brief introduction has given you an idea of how [[aMule]] works. If you feel that something is missing from this guide, please let us know or add it yourself.

HowTo Compile In Slackware

2004-07-29T09:57:33Z

Xaignar: =Installing aMule on [http://www.slackware.com Slackware]=

<center><h2>by ''Mike (servnov)''</h2></center>

== Installing [[aMule]] on [http://www.slackware.com Slackware] ==
----

1) Download [[wxBase]] and [[wxWidgets|wxGTK]] sources (.tar.gz packages) from [http://www.amule-project.net http://www.amule-project.net] or [http://www.amule.org http://www.amule.org]
:'''NOTE''': you will need root access or equivalent to complete [[aMule]] install.

2) INSTALL:
:''tar -xzvf wxBase*''
:''cd wxBase*''
:''./configure''
:''make''
:''make install''

:''tar -xzvf wxGTK*''
:''cd wxGTK*''
:''./configure''
:''make''
:''make install''

:Grab pre-built [http://www.slackware.com Slackware] package from [http://www.linuxpackages.net/search_view.php?by=name&name=amule&ver= linuxpackages.net].

:'''IMPORTANT:''' You need to have installed [http://www.slackfiles.net/documentation/en/books/slackware-basics/html/pkgtools.html pkgtools] with [http://www.slackware.com Slackware] (this is done by default).

:''installpkg aMule-2.0.0rc5-i686-2.tgz'' (or whatever current version is)

:That's all!

:Type ''amule'' in a shell to lauch or in [http://www.kde.org KDE] (similar in [http://www.gnome.org GNOME]) go to Kstart->Internet->aMule

3) UNINSTALL:
:''removepkg aMule'' (should work without version, etc.)

:Then if you want get a newer aMule*.tgz version as ''installpkg'' again.

Hope this helps.

Catch me on [[IRC]] at irc.freenode.com channel #amule nick '''servnov'''

== Final note ==
----

Building [[aMule]] itself from source (i.e. '''NOT''' from ''installpkg aMule*.tgz'') usually causes many problems in [http://www.slackware.com Slackware], [http://www.knoppix.org Knoppix] and a few other distros. Known possible problems:

*[http://www.gnu.org/software/autoconf configure] fails to build [http://www.gnu.org/software/make MakeFile] :(
*[[wxWidgets]] error or similar
*Package '[http://curl.haxx.se curl]' not found or version is outdated
*[[libcrypto|Crypto++]] and many make errors

Enjoy the hard work [[aMule]] [[AMule_devs|developers]] have done and continue to do!

Just remember you will need [[wxBase]] and [[wxWidgets|wxGTK]] installed even when using [http://www.slackware.com Slackware] package.

HowTo Compile In Slackware

2004-07-29T09:50:48Z

Xaignar: =Installing aMule on [http://www.slackware.com Slackware]=

<center><h2>by ''Mike (servnov)''</h2></center>

== Installing [[aMule]] on [http://www.slackware.com Slackware] ==
----

1) Download [[wxBase]] and [[wxWidgets|wxGTK]] sources (.tar.gz packages) from [http://www.amule-project.net http://www.amule-project.net] or [http://www.amule.org http://www.amule.org]
:'''NOTE''': you will need root access or equivalent to complete [[aMule]] install.

2) INSTALL:
:''tar -xzvf wxBase*''
:''cd wxBase*''
:''./configure''
:''make''
:''make install''

:''tar -xzvf wxGTK*''
:''cd wxGTK*''
:''./configure''
:''make''
:''make install''

:Grab pre-built [http://www.slackware.com Slackware] package from [http://www.linuxpackages.net/download.php?id=3589 linuxpackages.net] (choose a mirror)

:'''IMPORTANT:''' You need to have installed [http://www.slackfiles.net/documentation/en/books/slackware-basics/html/pkgtools.html pkgtools] with [http://www.slackware.com Slackware] (this is done by default).

:''installpkg aMule-2.0.0rc5-i686-2.tgz'' (or whatever current version is)

:That's all!

:Type ''amule'' in a shell to lauch or in [http://www.kde.org KDE] (similar in [http://www.gnome.org GNOME]) go to Kstart->Internet->aMule

3) UNINSTALL:
:''removepkg aMule'' (should work without version, etc.)

:Then if you want get a newer aMule*.tgz version as ''installpkg'' again.

Hope this helps.

Catch me on [[IRC]] at irc.freenode.com channel #amule nick '''servnov'''

== Final note ==
----

Building [[aMule]] itself from source (i.e. '''NOT''' from ''installpkg aMule*.tgz'') usually causes many problems in [http://www.slackware.com Slackware], [http://www.knoppix.org Knoppix] and a few other distros. Known possible problems:

*[http://www.gnu.org/software/autoconf configure] fails to build [http://www.gnu.org/software/make MakeFile] :(
*[[wxWidgets]] error or similar
*Package '[http://curl.haxx.se curl]' not found or version is outdated
*[[libcrypto|Crypto++]] and many make errors

Enjoy the hard work [[aMule]] [[AMule_devs|developers]] have done and continue to do!

Just remember you will need [[wxBase]] and [[wxWidgets|wxGTK]] installed even when using [http://www.slackware.com Slackware] package.

Compilation Installation

2004-07-25T09:28:59Z

Xaignar: =Step 3: Crypto++=

== Manual Installation ==

To install aMule you can either install it from scratch, as described in '''Compiling From Sources''' or use RPMs which will speed things up a lot, as described in the '''Installing using RPMs''' section.

'''NOTE:''' This HowTo uses [[wxWidgets]] 2.4.2 and [[libcrypto|Crypto++]] 5.1, as an example, however [[aMule]] can also be compiled using [[wxWidgets]] 2.5.x and versions of Crypto++ newer than 5.1.

=== Compiling From Sources ===
'''WARNING:''' Make sure you have '''no''' copies of [[wxWidgets]] installed. If you already have [[wxWidgets]] installed, check [[How to uninstall wxWidgets]] before starting a new installation. If you still have problems after this, then [[Check_if_wx_is_installed_twice|check if wx is installed twice]], since that's a common compilation and runtime problem.

'''NOTE:''' In [[wxWidgets]] 2.5.1 (and '''only''' in that version), [[wxBase]] is not distributed as a separate tarball. So if you are going to compile [[wxWidgets|wxGTK]] 2.5.1, skip the first step ([[wxBase]] compilation).

==== Step 1: [[wxBase]] ====
*download [[wxBase|wxBase]] ->
**[http://download.berlios.de/amule/wxBase-2.4.2.tar.gz wxBase-2.4.2.tar.gz]

* compile [[wxBase]] ->
**''tar -zxvf wxBase-2.4.2.tar.gz''
**''cd wxBase-2.4.2''
**''./configure --prefix=/usr && make''

*as '''root''':
**''make install''
**<font color="blue">''ln -sf /usr/bin/wxgtk-2.4-config /usr/bin/wx-config''
**''ln -sf /usr/bin/wxbase-2.4-config /usr/bin/wxbase-config''</font>
**''ldconfig''

==== Step 2: [[wxWidgets|wxGTK]] ====
*download [[wxWidgets|wxGTK]] ->
**[http://download.berlios.de/amule/wxGTK-2.4.2.tar.gz wxGTK-2.4.2.tar.gz]

* compile [[wxWidgets|wxGTK]] ->
**''tar -zxvf wxGTK-2.4.2.tar.gz''
***''cd wxGTK-2.4.2''
***''./configure --prefix=/usr --disable-gtk2 --with-gtk && make''

*as '''root''':
**''make install''
**''ldconfig''

==== Step 3: [[libcrypto|Crypto++]] ====
*download [[libcrypto]] ->
**[http://download.berlios.de/amule/crypto-5.1.tar.bz2 crypto-5.1.tar.bz2]

*compile [[libcrypto]] ->
**''tar xvjf crypto-5.1.tar.bz2''
**''cd crypto-5.1''
**''make''
::If you have problems compiling with older [http://gcc.gnu.org gcc] versions, it can be due to stray [http://www.freedos.org DOS] newlines in some files. Invoke
::: ''file * | grep CRLF | while read file rest; do dos2unix ${file%:}; done''
::to convert them to UNIX newlines ([http://www.gnu.org/software/bash/bash.html bash] syntax).

*as '''root''':
**''cp libcryptopp.a /usr/lib/''
**''mkdir /usr/include/cryptopp''
**''cp *.h /usr/include/cryptopp/''
**''ldconfig''

==== Step 4: [[aMule]] ====
*download latest [[aMule]] version ->
**[https://developer.berlios.de/project/showfiles.php?group_id=1296 latest aMule]
**(mirror) [http://mirror.amule.org latest aMule]

* compile [[aMule]] ->
**''tar -zxvf aMule-X.X.X.tar.gz'' (replace X with the right version number..)
**''cd aMule-X.X.X''
**''./configure --disable-debug --enable-optimize && make''

*as '''root''':
**''make install''

*run [[aMule]] as user from your console by typing -> ''amule''

=== Installing using RPMs ===

==== Step 1: [[wxBase]] ====
*download [[wxBase]] ->
**[http://download.berlios.de/amule/wxBase-2.4.2-1.i586.rpm wxBase-2.4.2-1.i586.rpm]

*install [[wxBase]] ->
**as '''root''':
***''rpm -Uvh wxBase-2.4.2-1.i586.rpm''
***<font color="blue">''ln -sf /usr/bin/wxgtk-2.4-config /usr/bin/wx-config''
***''ln -sf /usr/bin/wxbase-2.4-config /usr/bin/wxbase-config''</font>
***''ldconfig''

==== Step 2: [[wxWidgets|wxGTK]] ====
*download [[wxWidgets|wxGTK]] and [[wxWidgets|wxGTK]]-devel ->
**[http://download.berlios.de/amule/wxGTK-2.4.2-1.i386.rpm wxGTK-2.4.2-1.i386.rpm]   [http://download.berlios.de/amule/wxGTK-devel-2.4.2-1.i386.rpm wxGTK-devel-2.4.2-1.i386.rpm]

* install [[wxWidgets|wxGTK]] ->
**as '''root''':
***''rpm -Uvh wxGTK-2.4.2-1.i386.rpm wxGTK-devel-2.4.2-1.i386.rpm''
***''ldconfig''

==== Step 3. [[Crypto++]] ====
*download [[libcrypto]] ->
**[[http://www.redhat.com RedHat]] & [http://www.suse.com SuSE]: [http://download.berlios.de/amule/libcryptopp-5.1-4_rh9-suse.i686.rpm libcryptopp-5.1-4_rh9-suse.i686.rpm] and [http://download.berlios.de/amule/libcryptopp-devel-5.1-4_rh9-suse.i686.rpm libcryptopp-devel-5.1-4_rh9-suse.i686.rpm]
**FC1: [http://download.berlios.de/amule/libcryptopp-5.1-4_fc1.i686.rpm libcryptopp-5.1-4_fc1.i686.rpm] and [http://download.berlios.de/amule/libcryptopp-devel-5.1-4_fc1.i686.rpm libcryptopp-devel-5.1-4_fc1.i686.rpm]
**MDK: [http://download.berlios.de/amule/libcryptopp5-5.1-2mdk.i586.rpm libcryptopp5-5.1-2mdk.i586.rpm] and [http://download.berlios.de/amule/libcryptopp5-devel-5.1-2mdk.i586.rpm libcryptopp5-devel-5.1-2mdk.i586.rpm]
*as '''root''':
**''rpm -Uvh the-above-downloaded-package.rpm''

==== Step 4: [[aMule]] ====
*download latest [[aMule]] version ->
**[https://developer.berlios.de/project/showfiles.php?group_id=1296 latest aMule]
**(mirror) [http://mirror.amule.org latest aMule]

* install [[aMule]] ->
**as '''root''':
***''rpm -Uvh aMule-X.X.X-1.iX86-X.rpm'' (replace X with the right version number..)

* run [[aMule]] as user from your console by typing -> ''amule''

Compilation Installation

2004-07-24T00:20:26Z

Xaignar:

== Manual Installation ==

To install aMule you can either install it from scratch, as described in '''Compiling From Sources''' or use RPMs which will speed things up a lot, as described in the '''Installing using RPMs''' section.

'''NOTE:''' This HowTo uses [[wxWidgets]] 2.4.2 and [[libcrypto|Crypto++]] 5.1, as an example, however [[aMule]] can also be compiled using [[wxWidgets]] 2.5.x and versions of Crypto++ newer than 5.1.

=== Compiling From Sources ===
'''WARNING:''' Make sure you have '''no''' copies of [[wxWidgets]] installed. If you already have [[wxWidgets]] installed, check [[How to uninstall wxWidgets]] before starting a new installation. If you still have problems after this, then [[Check_if_wx_is_installed_twice|check if wx is installed twice]], since that's a common compilation and runtime problem.

'''NOTE:''' In [[wxWidgets]] 2.5.1 (and '''only''' in that version), [[wxBase]] is not distributed as a separate tarball. So if you are going to compile [[wxWidgets|wxGTK]] 2.5.1, skip the first step ([[wxBase]] compilation).

==== Step 1: [[wxBase]] ====
* [http://prdownloads.sourceforge.net/wxwindows/wxGTK-2.4.2.tar.bz2 Download wxBase].

* compile [[wxBase]] ->
**''tar -zxvf wxBase-2.4.2.tar.gz''
**''cd wxBase-2.4.2''
**''./configure --prefix=/usr && make''

*as '''root''':
**''make install''
**<font color="blue">''ln -sf /usr/bin/wxgtk-2.4-config /usr/bin/wx-config''
**''ln -sf /usr/bin/wxbase-2.4-config /usr/bin/wxbase-config''</font>
**''ldconfig''

==== Step 2: [[wxWidgets|wxGTK]] ====
*download [[wxWidgets|wxGTK]] ->
**[http://download.berlios.de/amule/wxGTK-2.4.2.tar.gz wxGTK-2.4.2.tar.gz]

* compile [[wxWidgets|wxGTK]] ->
**''tar -zxvf wxGTK-2.4.2.tar.gz''
***''cd wxGTK-2.4.2''
***''./configure --prefix=/usr --disable-gtk2 --with-gtk && make''

*as '''root''':
**''make install''
**''ldconfig''

==== Step 3: [[libcrypto|Crypto++]] ====
*download [[libcrypto]] ->
**[http://download.berlios.de/amule/crypto-5.1.tar.bz2 crypto-5.1.tar.bz2]

*compile [[libcrypto]] ->
**''tar xvjf crypto-5.1.tar.bz2''
**''cd crypto-5.1''
**''make''
::If you have problems compiling with older [http://gcc.gnu.org gcc] versions, it can be due to stray [http://www.freedos.org DOS] newlines in some files. Invoke
::: ''file * | grep CRLF | while read file rest; do dos2unix ${file%:}; done''
::to convert them to UNIX newlines ([http://www.gnu.org/software/bash/bash.html bash] syntax).

*as '''root''':
**''cp libcryptopp.a /usr/lib/''
**''mkdir /usr/include/cryptopp''
**''cp *.h /usr/include/cyrptopp/''
**''ldconfig''

==== Step 4: [[aMule]] ====
*download latest [[aMule]] version ->
**[https://developer.berlios.de/project/showfiles.php?group_id=1296 latest aMule]
**(mirror) [http://mirror.amule.org latest aMule]

* compile [[aMule]] ->
**''tar -zxvf aMule-X.X.X.tar.gz'' (replace X with the right version number..)
**''cd aMule-X.X.X''
**''./configure --disable-debug --enable-optimize && make''

*as '''root''':
**''make install''

*run [[aMule]] as user from your console by typing -> ''amule''

=== Installing using RPMs ===

==== Step 1: [[wxBase]] ====
*download [[wxBase]] ->
**[http://download.berlios.de/amule/wxBase-2.4.2-1.i586.rpm wxBase-2.4.2-1.i586.rpm]

*install [[wxBase]] ->
**as '''root''':
***''rpm -Uvh wxBase-2.4.2-1.i586.rpm''
***<font color="blue">''ln -sf /usr/bin/wxgtk-2.4-config /usr/bin/wx-config''
***''ln -sf /usr/bin/wxbase-2.4-config /usr/bin/wxbase-config''</font>
***''ldconfig''

==== Step 2: [[wxWidgets|wxGTK]] ====
*download [[wxWidgets|wxGTK]] and [[wxWidgets|wxGTK]]-devel ->
**[http://download.berlios.de/amule/wxGTK-2.4.2-1.i386.rpm wxGTK-2.4.2-1.i386.rpm]   [http://download.berlios.de/amule/wxGTK-devel-2.4.2-1.i386.rpm wxGTK-devel-2.4.2-1.i386.rpm]

* install [[wxWidgets|wxGTK]] ->
**as '''root''':
***''rpm -Uvh wxGTK-2.4.2-1.i386.rpm wxGTK-devel-2.4.2-1.i386.rpm''
***''ldconfig''

==== Step 3. [[Crypto++]] ====
*download [[libcrypto]] ->
**[[http://www.redhat.com RedHat]] & [http://www.suse.com SuSE]: [http://download.berlios.de/amule/libcryptopp-5.1-4_rh9-suse.i686.rpm libcryptopp-5.1-4_rh9-suse.i686.rpm] and [http://download.berlios.de/amule/libcryptopp-devel-5.1-4_rh9-suse.i686.rpm libcryptopp-devel-5.1-4_rh9-suse.i686.rpm]
**FC1: [http://download.berlios.de/amule/libcryptopp-5.1-4_fc1.i686.rpm libcryptopp-5.1-4_fc1.i686.rpm] and [http://download.berlios.de/amule/libcryptopp-devel-5.1-4_fc1.i686.rpm libcryptopp-devel-5.1-4_fc1.i686.rpm]
**MDK: [http://download.berlios.de/amule/libcryptopp5-5.1-2mdk.i586.rpm libcryptopp5-5.1-2mdk.i586.rpm] and [http://download.berlios.de/amule/libcryptopp5-devel-5.1-2mdk.i586.rpm libcryptopp5-devel-5.1-2mdk.i586.rpm]
*as '''root''':
**''rpm -Uvh the-above-downloaded-package.rpm''

==== Step 4: [[aMule]] ====
*download latest [[aMule]] version ->
**[https://developer.berlios.de/project/showfiles.php?group_id=1296 latest aMule]
**(mirror) [http://mirror.amule.org latest aMule]

* install [[aMule]] ->
**as '''root''':
***''rpm -Uvh aMule-X.X.X-1.iX86-X.rpm'' (replace X with the right version number..)

* run [[aMule]] as user from your console by typing -> ''amule''

Compilation Installation

2004-07-24T00:18:35Z

Xaignar: =Manual Compilation=

To install aMule you can either install it from scratch, as described in '''Manual Compilation''' or use RPMs which will speed things up a lot, as described in the '''Installing using RPMs''' section.

== Manual Installation ==

'''NOTE:''' This HowTo uses [[wxWidgets]] 2.4.2 and [[libcrypto|Crypto++]] 5.1, as an example, however [[aMule]] can also be compiled using [[wxWidgets]] 2.5.x and versions of Crypto++ newer than 5.1.

=== Compiling from sources ===
'''WARNING:''' Make sure you have '''no''' copies of [[wxWidgets]] installed. If you already have [[wxWidgets]] installed, check [[How to uninstall wxWidgets]] before starting a new installation. If you still have problems after this, then [[Check_if_wx_is_installed_twice|check if wx is installed twice]], since that's a common compilation and runtime problem.

'''NOTE:''' In [[wxWidgets]] 2.5.1 (and '''only''' in that version), [[wxBase]] is not distributed as a separate tarball. So if you are going to compile [[wxWidgets|wxGTK]] 2.5.1, skip the first step ([[wxBase]] compilation).

==== Step 1: [[wxBase]] ====
* [http://prdownloads.sourceforge.net/wxwindows/wxGTK-2.4.2.tar.bz2 Download wxBase].

* compile [[wxBase]] ->
**''tar -zxvf wxBase-2.4.2.tar.gz''
**''cd wxBase-2.4.2''
**''./configure --prefix=/usr && make''

*as '''root''':
**''make install''
**<font color="blue">''ln -sf /usr/bin/wxgtk-2.4-config /usr/bin/wx-config''
**''ln -sf /usr/bin/wxbase-2.4-config /usr/bin/wxbase-config''</font>
**''ldconfig''

==== Step 2: [[wxWidgets|wxGTK]] ====
*download [[wxWidgets|wxGTK]] ->
**[http://download.berlios.de/amule/wxGTK-2.4.2.tar.gz wxGTK-2.4.2.tar.gz]

* compile [[wxWidgets|wxGTK]] ->
**''tar -zxvf wxGTK-2.4.2.tar.gz''
***''cd wxGTK-2.4.2''
***''./configure --prefix=/usr --disable-gtk2 --with-gtk && make''

*as '''root''':
**''make install''
**''ldconfig''

==== Step 3: [[libcrypto|Crypto++]] ====
*download [[libcrypto]] ->
**[http://download.berlios.de/amule/crypto-5.1.tar.bz2 crypto-5.1.tar.bz2]

*compile [[libcrypto]] ->
**''tar xvjf crypto-5.1.tar.bz2''
**''cd crypto-5.1''
**''make''
::If you have problems compiling with older [http://gcc.gnu.org gcc] versions, it can be due to stray [http://www.freedos.org DOS] newlines in some files. Invoke
::: ''file * | grep CRLF | while read file rest; do dos2unix ${file%:}; done''
::to convert them to UNIX newlines ([http://www.gnu.org/software/bash/bash.html bash] syntax).

*as '''root''':
**''cp libcryptopp.a /usr/lib/''
**''mkdir /usr/include/cryptopp''
**''cp *.h /usr/include/cyrptopp/''
**''ldconfig''

==== Step 4: [[aMule]] ====
*download latest [[aMule]] version ->
**[https://developer.berlios.de/project/showfiles.php?group_id=1296 latest aMule]
**(mirror) [http://mirror.amule.org latest aMule]

* compile [[aMule]] ->
**''tar -zxvf aMule-X.X.X.tar.gz'' (replace X with the right version number..)
**''cd aMule-X.X.X''
**''./configure --disable-debug --enable-optimize && make''

*as '''root''':
**''make install''

*run [[aMule]] as user from your console by typing -> ''amule''

=== Installing using RPMs ===

==== Step 1: [[wxBase]] ====
*download [[wxBase]] ->
**[http://download.berlios.de/amule/wxBase-2.4.2-1.i586.rpm wxBase-2.4.2-1.i586.rpm]

*install [[wxBase]] ->
**as '''root''':
***''rpm -Uvh wxBase-2.4.2-1.i586.rpm''
***<font color="blue">''ln -sf /usr/bin/wxgtk-2.4-config /usr/bin/wx-config''
***''ln -sf /usr/bin/wxbase-2.4-config /usr/bin/wxbase-config''</font>
***''ldconfig''

==== Step 2: [[wxWidgets|wxGTK]] ====
*download [[wxWidgets|wxGTK]] and [[wxWidgets|wxGTK]]-devel ->
**[http://download.berlios.de/amule/wxGTK-2.4.2-1.i386.rpm wxGTK-2.4.2-1.i386.rpm]   [http://download.berlios.de/amule/wxGTK-devel-2.4.2-1.i386.rpm wxGTK-devel-2.4.2-1.i386.rpm]

* install [[wxWidgets|wxGTK]] ->
**as '''root''':
***''rpm -Uvh wxGTK-2.4.2-1.i386.rpm wxGTK-devel-2.4.2-1.i386.rpm''
***''ldconfig''

==== Step 3. [[Crypto++]] ====
*download [[libcrypto]] ->
**[[http://www.redhat.com RedHat]] & [http://www.suse.com SuSE]: [http://download.berlios.de/amule/libcryptopp-5.1-4_rh9-suse.i686.rpm libcryptopp-5.1-4_rh9-suse.i686.rpm] and [http://download.berlios.de/amule/libcryptopp-devel-5.1-4_rh9-suse.i686.rpm libcryptopp-devel-5.1-4_rh9-suse.i686.rpm]
**FC1: [http://download.berlios.de/amule/libcryptopp-5.1-4_fc1.i686.rpm libcryptopp-5.1-4_fc1.i686.rpm] and [http://download.berlios.de/amule/libcryptopp-devel-5.1-4_fc1.i686.rpm libcryptopp-devel-5.1-4_fc1.i686.rpm]
**MDK: [http://download.berlios.de/amule/libcryptopp5-5.1-2mdk.i586.rpm libcryptopp5-5.1-2mdk.i586.rpm] and [http://download.berlios.de/amule/libcryptopp5-devel-5.1-2mdk.i586.rpm libcryptopp5-devel-5.1-2mdk.i586.rpm]
*as '''root''':
**''rpm -Uvh the-above-downloaded-package.rpm''

==== Step 4: [[aMule]] ====
*download latest [[aMule]] version ->
**[https://developer.berlios.de/project/showfiles.php?group_id=1296 latest aMule]
**(mirror) [http://mirror.amule.org latest aMule]

* install [[aMule]] ->
**as '''root''':
***''rpm -Uvh aMule-X.X.X-1.iX86-X.rpm'' (replace X with the right version number..)

* run [[aMule]] as user from your console by typing -> ''amule''

Compilation Installation

2004-07-24T00:18:04Z

Xaignar: =Step 3. libcrypto=

To install aMule you can either install it from scratch, as described in '''Manual Compilation''' or use RPMs which will speed things up a lot, as described in the '''Installing using RPMs''' section.

== Manual Compilation ==

'''NOTE:''' This HowTo uses [[wxWidgets]] 2.4.2 and [[libcrypto|Crypto++]] 5.1, as an example, however [[aMule]] can also be compiled using [[wxWidgets]] 2.5.x and versions of Crypto++ newer than 5.1.

=== Compiling from sources ===
'''WARNING:''' Make sure you have '''no''' copies of [[wxWidgets]] installed. If you already have [[wxWidgets]] installed, check [[How to uninstall wxWidgets]] before starting a new installation. If you still have problems after this, then [[Check_if_wx_is_installed_twice|check if wx is installed twice]], since that's a common compilation and runtime problem.

'''NOTE:''' In [[wxWidgets]] 2.5.1 (and '''only''' in that version), [[wxBase]] is not distributed as a separate tarball. So if you are going to compile [[wxWidgets|wxGTK]] 2.5.1, skip the first step ([[wxBase]] compilation).

==== Step 1: [[wxBase]] ====
* [http://prdownloads.sourceforge.net/wxwindows/wxGTK-2.4.2.tar.bz2 Download wxBase].

* compile [[wxBase]] ->
**''tar -zxvf wxBase-2.4.2.tar.gz''
**''cd wxBase-2.4.2''
**''./configure --prefix=/usr && make''

*as '''root''':
**''make install''
**<font color="blue">''ln -sf /usr/bin/wxgtk-2.4-config /usr/bin/wx-config''
**''ln -sf /usr/bin/wxbase-2.4-config /usr/bin/wxbase-config''</font>
**''ldconfig''

==== Step 2: [[wxWidgets|wxGTK]] ====
*download [[wxWidgets|wxGTK]] ->
**[http://download.berlios.de/amule/wxGTK-2.4.2.tar.gz wxGTK-2.4.2.tar.gz]

* compile [[wxWidgets|wxGTK]] ->
**''tar -zxvf wxGTK-2.4.2.tar.gz''
***''cd wxGTK-2.4.2''
***''./configure --prefix=/usr --disable-gtk2 --with-gtk && make''

*as '''root''':
**''make install''
**''ldconfig''

==== Step 3: [[libcrypto|Crypto++]] ====
*download [[libcrypto]] ->
**[http://download.berlios.de/amule/crypto-5.1.tar.bz2 crypto-5.1.tar.bz2]

*compile [[libcrypto]] ->
**''tar xvjf crypto-5.1.tar.bz2''
**''cd crypto-5.1''
**''make''
::If you have problems compiling with older [http://gcc.gnu.org gcc] versions, it can be due to stray [http://www.freedos.org DOS] newlines in some files. Invoke
::: ''file * | grep CRLF | while read file rest; do dos2unix ${file%:}; done''
::to convert them to UNIX newlines ([http://www.gnu.org/software/bash/bash.html bash] syntax).

*as '''root''':
**''cp libcryptopp.a /usr/lib/''
**''mkdir /usr/include/cryptopp''
**''cp *.h /usr/include/cyrptopp/''
**''ldconfig''

==== Step 4: [[aMule]] ====
*download latest [[aMule]] version ->
**[https://developer.berlios.de/project/showfiles.php?group_id=1296 latest aMule]
**(mirror) [http://mirror.amule.org latest aMule]

* compile [[aMule]] ->
**''tar -zxvf aMule-X.X.X.tar.gz'' (replace X with the right version number..)
**''cd aMule-X.X.X''
**''./configure --disable-debug --enable-optimize && make''

*as '''root''':
**''make install''

*run [[aMule]] as user from your console by typing -> ''amule''

=== Installing using RPMs ===

==== Step 1: [[wxBase]] ====
*download [[wxBase]] ->
**[http://download.berlios.de/amule/wxBase-2.4.2-1.i586.rpm wxBase-2.4.2-1.i586.rpm]

*install [[wxBase]] ->
**as '''root''':
***''rpm -Uvh wxBase-2.4.2-1.i586.rpm''
***<font color="blue">''ln -sf /usr/bin/wxgtk-2.4-config /usr/bin/wx-config''
***''ln -sf /usr/bin/wxbase-2.4-config /usr/bin/wxbase-config''</font>
***''ldconfig''

==== Step 2: [[wxWidgets|wxGTK]] ====
*download [[wxWidgets|wxGTK]] and [[wxWidgets|wxGTK]]-devel ->
**[http://download.berlios.de/amule/wxGTK-2.4.2-1.i386.rpm wxGTK-2.4.2-1.i386.rpm]   [http://download.berlios.de/amule/wxGTK-devel-2.4.2-1.i386.rpm wxGTK-devel-2.4.2-1.i386.rpm]

* install [[wxWidgets|wxGTK]] ->
**as '''root''':
***''rpm -Uvh wxGTK-2.4.2-1.i386.rpm wxGTK-devel-2.4.2-1.i386.rpm''
***''ldconfig''

==== Step 3. [[Crypto++]] ====
*download [[libcrypto]] ->
**[[http://www.redhat.com RedHat]] & [http://www.suse.com SuSE]: [http://download.berlios.de/amule/libcryptopp-5.1-4_rh9-suse.i686.rpm libcryptopp-5.1-4_rh9-suse.i686.rpm] and [http://download.berlios.de/amule/libcryptopp-devel-5.1-4_rh9-suse.i686.rpm libcryptopp-devel-5.1-4_rh9-suse.i686.rpm]
**FC1: [http://download.berlios.de/amule/libcryptopp-5.1-4_fc1.i686.rpm libcryptopp-5.1-4_fc1.i686.rpm] and [http://download.berlios.de/amule/libcryptopp-devel-5.1-4_fc1.i686.rpm libcryptopp-devel-5.1-4_fc1.i686.rpm]
**MDK: [http://download.berlios.de/amule/libcryptopp5-5.1-2mdk.i586.rpm libcryptopp5-5.1-2mdk.i586.rpm] and [http://download.berlios.de/amule/libcryptopp5-devel-5.1-2mdk.i586.rpm libcryptopp5-devel-5.1-2mdk.i586.rpm]
*as '''root''':
**''rpm -Uvh the-above-downloaded-package.rpm''

==== Step 4: [[aMule]] ====
*download latest [[aMule]] version ->
**[https://developer.berlios.de/project/showfiles.php?group_id=1296 latest aMule]
**(mirror) [http://mirror.amule.org latest aMule]

* install [[aMule]] ->
**as '''root''':
***''rpm -Uvh aMule-X.X.X-1.iX86-X.rpm'' (replace X with the right version number..)

* run [[aMule]] as user from your console by typing -> ''amule''

Compilation Installation

2004-07-24T00:17:40Z

Xaignar:

To install aMule you can either install it from scratch, as described in '''Manual Compilation''' or use RPMs which will speed things up a lot, as described in the '''Installing using RPMs''' section.

== Manual Compilation ==

'''NOTE:''' This HowTo uses [[wxWidgets]] 2.4.2 and [[libcrypto|Crypto++]] 5.1, as an example, however [[aMule]] can also be compiled using [[wxWidgets]] 2.5.x and versions of Crypto++ newer than 5.1.

=== Compiling from sources ===
'''WARNING:''' Make sure you have '''no''' copies of [[wxWidgets]] installed. If you already have [[wxWidgets]] installed, check [[How to uninstall wxWidgets]] before starting a new installation. If you still have problems after this, then [[Check_if_wx_is_installed_twice|check if wx is installed twice]], since that's a common compilation and runtime problem.

'''NOTE:''' In [[wxWidgets]] 2.5.1 (and '''only''' in that version), [[wxBase]] is not distributed as a separate tarball. So if you are going to compile [[wxWidgets|wxGTK]] 2.5.1, skip the first step ([[wxBase]] compilation).

==== Step 1: [[wxBase]] ====
* [http://prdownloads.sourceforge.net/wxwindows/wxGTK-2.4.2.tar.bz2 Download wxBase].

* compile [[wxBase]] ->
**''tar -zxvf wxBase-2.4.2.tar.gz''
**''cd wxBase-2.4.2''
**''./configure --prefix=/usr && make''

*as '''root''':
**''make install''
**<font color="blue">''ln -sf /usr/bin/wxgtk-2.4-config /usr/bin/wx-config''
**''ln -sf /usr/bin/wxbase-2.4-config /usr/bin/wxbase-config''</font>
**''ldconfig''

==== Step 2: [[wxWidgets|wxGTK]] ====
*download [[wxWidgets|wxGTK]] ->
**[http://download.berlios.de/amule/wxGTK-2.4.2.tar.gz wxGTK-2.4.2.tar.gz]

* compile [[wxWidgets|wxGTK]] ->
**''tar -zxvf wxGTK-2.4.2.tar.gz''
***''cd wxGTK-2.4.2''
***''./configure --prefix=/usr --disable-gtk2 --with-gtk && make''

*as '''root''':
**''make install''
**''ldconfig''

==== Step 3: [[libcrypto|Crypto++]] ====
*download [[libcrypto]] ->
**[http://download.berlios.de/amule/crypto-5.1.tar.bz2 crypto-5.1.tar.bz2]

*compile [[libcrypto]] ->
**''tar xvjf crypto-5.1.tar.bz2''
**''cd crypto-5.1''
**''make''
::If you have problems compiling with older [http://gcc.gnu.org gcc] versions, it can be due to stray [http://www.freedos.org DOS] newlines in some files. Invoke
::: ''file * | grep CRLF | while read file rest; do dos2unix ${file%:}; done''
::to convert them to UNIX newlines ([http://www.gnu.org/software/bash/bash.html bash] syntax).

*as '''root''':
**''cp libcryptopp.a /usr/lib/''
**''mkdir /usr/include/cryptopp''
**''cp *.h /usr/include/cyrptopp/''
**''ldconfig''

==== Step 4: [[aMule]] ====
*download latest [[aMule]] version ->
**[https://developer.berlios.de/project/showfiles.php?group_id=1296 latest aMule]
**(mirror) [http://mirror.amule.org latest aMule]

* compile [[aMule]] ->
**''tar -zxvf aMule-X.X.X.tar.gz'' (replace X with the right version number..)
**''cd aMule-X.X.X''
**''./configure --disable-debug --enable-optimize && make''

*as '''root''':
**''make install''

*run [[aMule]] as user from your console by typing -> ''amule''

=== Installing using RPMs ===

==== Step 1: [[wxBase]] ====
*download [[wxBase]] ->
**[http://download.berlios.de/amule/wxBase-2.4.2-1.i586.rpm wxBase-2.4.2-1.i586.rpm]

*install [[wxBase]] ->
**as '''root''':
***''rpm -Uvh wxBase-2.4.2-1.i586.rpm''
***<font color="blue">''ln -sf /usr/bin/wxgtk-2.4-config /usr/bin/wx-config''
***''ln -sf /usr/bin/wxbase-2.4-config /usr/bin/wxbase-config''</font>
***''ldconfig''

==== Step 2: [[wxWidgets|wxGTK]] ====
*download [[wxWidgets|wxGTK]] and [[wxWidgets|wxGTK]]-devel ->
**[http://download.berlios.de/amule/wxGTK-2.4.2-1.i386.rpm wxGTK-2.4.2-1.i386.rpm]   [http://download.berlios.de/amule/wxGTK-devel-2.4.2-1.i386.rpm wxGTK-devel-2.4.2-1.i386.rpm]

* install [[wxWidgets|wxGTK]] ->
**as '''root''':
***''rpm -Uvh wxGTK-2.4.2-1.i386.rpm wxGTK-devel-2.4.2-1.i386.rpm''
***''ldconfig''

==== Step 3. [[libcrypto]] ====
*download [[libcrypto]] ->
**[[http://www.redhat.com RedHat]] & [http://www.suse.com SuSE]: [http://download.berlios.de/amule/libcryptopp-5.1-4_rh9-suse.i686.rpm libcryptopp-5.1-4_rh9-suse.i686.rpm] and [http://download.berlios.de/amule/libcryptopp-devel-5.1-4_rh9-suse.i686.rpm libcryptopp-devel-5.1-4_rh9-suse.i686.rpm]
**FC1: [http://download.berlios.de/amule/libcryptopp-5.1-4_fc1.i686.rpm libcryptopp-5.1-4_fc1.i686.rpm] and [http://download.berlios.de/amule/libcryptopp-devel-5.1-4_fc1.i686.rpm libcryptopp-devel-5.1-4_fc1.i686.rpm]
**MDK: [http://download.berlios.de/amule/libcryptopp5-5.1-2mdk.i586.rpm libcryptopp5-5.1-2mdk.i586.rpm] and [http://download.berlios.de/amule/libcryptopp5-devel-5.1-2mdk.i586.rpm libcryptopp5-devel-5.1-2mdk.i586.rpm]
*as '''root''':
**''rpm -Uvh the-above-downloaded-package.rpm''

==== Step 4: [[aMule]] ====
*download latest [[aMule]] version ->
**[https://developer.berlios.de/project/showfiles.php?group_id=1296 latest aMule]
**(mirror) [http://mirror.amule.org latest aMule]

* install [[aMule]] ->
**as '''root''':
***''rpm -Uvh aMule-X.X.X-1.iX86-X.rpm'' (replace X with the right version number..)

* run [[aMule]] as user from your console by typing -> ''amule''

AMule Project FAQ:About

2004-07-23T13:30:45Z

Xaignar: =aMule -- The [http://www.amule.org all-platform Mule]=

== aMule -- The [http://www.amule.org all-platform Mule] ==
aMule is an [[eMule]]-like client for the [[FAQ_eD2k/Kademlia|ed2k network]], supporting [http://www.kernel.org Linux], [http://www.bsd.org BSD] platforms, and [http://www.sun.com/solaris Solaris].
Work is underway to add support for [http://www.apple.com/macosx MacOSX], [http://www.microsoft.com/windows Win32] and [http://www.microsoft.com/xbox Xbox].

aMule was forked from [[xMule]] (formely known as [[lMule]]) project back in september 2003, though now has less and less resemblance with the client that sired it.

aMule is built upon the [[wxWidgets]] (formely [[wxWidgets|wxWindows]]) toolkit, which enables it to support multiple platforms.

aMule is entirely free, its sourcecode released under the GPL just like eMule, and includes no adware or spyware as is often found in propertary p2p applications.

=== *Mule features ===

[http://www.amule.org aMule] has most features of the [[eMule]] [[Client|client]]. These include:

* [http://www.amule.org aMule] is currently availabe in 25 languages.
* Support for Source Exchange in order to find sources for files more efficently.
* Large queues and the Credit system helps to ensure that everyone will get the file they want and rewards those who activly upload to other users.
* Support for the the compressed transfers and server communication (using [http://www.gzip.org/zlib zlib]), which means faster transfers for compressable files and less strain on servers.
* Support for [[Secure_User_Identification|Secure Identification]], which insures that your user hash cant be stolen in order to inpersonate your client.
* Support for [[IPFilter|IP-Filters]] so that you can keep known bad IPs from connecting to you.
* You can have the traditional progress bar for transfers, percents completed or both.
* aMule supports systrays for both Gnome, KDE and other window managers.
* Supports [[Signature|Online Signatures]], so you can brag about using aMule.
* Checks against aggressive clients.
* Uses MD4 hashes to find sources and ensure that the file macthes the original copies of the file, in order to avoid corruption.
* [[ICH|Intelligent Corruption Handler (ICH)]] helps to speed up the correction of corrupted parts.
* Auto priorities and source management allow you to start many downloads without having to monitor them.
* The Preview function allows you to look at your videos and archives before they are completed. For video previewing, [http://www.mplayerhq.hu MPlayer] or [http://xine.sourceforge.net Xine] is recommanded but [http://www.videolan.org Video Lan Client] should work too.
* Support for categories so that you can organize your downloads.
* To find the files you want, [http://www.amule.org aMule] offers a lot of search possibilities, which are:
** [[Servers]] (local and global) and of course direct integration in your favourite browser for easy klick-and-download (with [[ed2k links|ed2k:// links]]).
* Messaging and [[Friend|Friends]] system:
** You can send messages to other [[clients]] and add them as [[Friend|friends]].
* [http://www.amule.org aMule] supports updating the [[Server|server]] list from an URL during run-time or startup.
* aMule can also update its server list as it connects to other clients.
* PowerShare function: better handling of your shared files (release).

=== aMule specific features ===
* Checks against known leecher and other bad clients clients. These are banned. This feature is thanks to the [www.BlackRat.fr.tc BlackRat eMule mod].
* [[FAQ_aMule#What_is_slot_allocation?|Slot allocation]] allows you to specify how many you wish to upload to at once.For example, if you have 20 kb/s for your maximum upload, you can set slot allocation to 10 kb/s which means that you will upload to two users with 10 kb/s each.
** The [[aMuleCMD|amulecmd]] command line interface and [[aMuleCMD|amulecmdDLG]] and graphical command line interface, to connect to your running [http://www.amule.org aMule] and get status or send commands. Works locally and from remote clients. '''NOTE:''' [[aMuleCMD|amulecmd]] and [[aMuleCMD|amulecmdDLG]] also work in [http://www.microsoft.com/windows Windows]! You can control your [http://www.kernel.org Linux] box from your office's [http://www.microsoft.com/windows Windows] ;)
* Fast [[ed2k links|ED2K Link]] handler at the bottom of every page (can be isabled on Preferences).
* Save 5 [[FAQ_eD2k/Kademlia#What_is_a_source?|sources]] on rare files (<20 sources).

=== Planned Features ===
* Complete [[aMuleWeb|webserver]] rewrite (under heavy developement at the moment, be patient please).
* [[FAQ_eD2k/Kademlia#What_is_Kademlia?|Kademlia]] support.
* and and and ..

AMule Project FAQ:About

2004-07-23T13:29:49Z

Xaignar: =aMule -- The [http://www.amule.org all-platform Mule]=

== aMule -- The [http://www.amule.org all-platform Mule] ==
aMule is an [[eMule]]-like client for the [[FAQ_eD2k/Kademlia|ed2k network]], supporting [http://www.kernel.org Linux], [http://www.bsd.org BSD] platforms, and [http://www.sun.com/solaris Solaris].
Work is underway to add support for [http://www.apple.com/macosx MacOSX], [http://www.microsoft.com/windows Win32] and [http://www.microsoft.com/xbox Xbox].

aMule was forked from [[xMule]] (formely known as [[lMule]]) project back in september 2003, though now has less and less resemblance with the client that sired it.

aMule is built upon the [[wxWidgets]] (formely [[wxWidgets|wxWindows]]) toolkit, which enables it to support multiple platforms.

aMule is entirely free, its sourcecode released under the GPL just just eMule, and includes no adware or spyware as is often found in propertary p2p applications.

=== *Mule features ===

[http://www.amule.org aMule] has most features of the [[eMule]] [[Client|client]]. These include:

* [http://www.amule.org aMule] is currently availabe in 25 languages.
* Support for Source Exchange in order to find sources for files more efficently.
* Large queues and the Credit system helps to ensure that everyone will get the file they want and rewards those who activly upload to other users.
* Support for the the compressed transfers and server communication (using [http://www.gzip.org/zlib zlib]), which means faster transfers for compressable files and less strain on servers.
* Support for [[Secure_User_Identification|Secure Identification]], which insures that your user hash cant be stolen in order to inpersonate your client.
* Support for [[IPFilter|IP-Filters]] so that you can keep known bad IPs from connecting to you.
* You can have the traditional progress bar for transfers, percents completed or both.
* aMule supports systrays for both Gnome, KDE and other window managers.
* Supports [[Signature|Online Signatures]], so you can brag about using aMule.
* Checks against aggressive clients.
* Uses MD4 hashes to find sources and ensure that the file macthes the original copies of the file, in order to avoid corruption.
* [[ICH|Intelligent Corruption Handler (ICH)]] helps to speed up the correction of corrupted parts.
* Auto priorities and source management allow you to start many downloads without having to monitor them.
* The Preview function allows you to look at your videos and archives before they are completed. For video previewing, [http://www.mplayerhq.hu MPlayer] or [http://xine.sourceforge.net Xine] is recommanded but [http://www.videolan.org Video Lan Client] should work too.
* Support for categories so that you can organize your downloads.
* To find the files you want, [http://www.amule.org aMule] offers a lot of search possibilities, which are:
** [[Servers]] (local and global) and of course direct integration in your favourite browser for easy klick-and-download (with [[ed2k links|ed2k:// links]]).
* Messaging and [[Friend|Friends]] system:
** You can send messages to other [[clients]] and add them as [[Friend|friends]].
* [http://www.amule.org aMule] supports updating the [[Server|server]] list from an URL during run-time or startup.
* aMule can also update its server list as it connects to other clients.
* PowerShare function: better handling of your shared files (release).

=== aMule specific features ===
* Checks against known leecher and other bad clients clients. These are banned. This feature is thanks to the [www.BlackRat.fr.tc BlackRat eMule mod].
* [[FAQ_aMule#What_is_slot_allocation?|Slot allocation]] allows you to specify how many you wish to upload to at once.For example, if you have 20 kb/s for your maximum upload, you can set slot allocation to 10 kb/s which means that you will upload to two users with 10 kb/s each.
** The [[aMuleCMD|amulecmd]] command line interface and [[aMuleCMD|amulecmdDLG]] and graphical command line interface, to connect to your running [http://www.amule.org aMule] and get status or send commands. Works locally and from remote clients. '''NOTE:''' [[aMuleCMD|amulecmd]] and [[aMuleCMD|amulecmdDLG]] also work in [http://www.microsoft.com/windows Windows]! You can control your [http://www.kernel.org Linux] box from your office's [http://www.microsoft.com/windows Windows] ;)
* Fast [[ed2k links|ED2K Link]] handler at the bottom of every page (can be isabled on Preferences).
* Save 5 [[FAQ_eD2k/Kademlia#What_is_a_source?|sources]] on rare files (<20 sources).

=== Planned Features ===
* Complete [[aMuleWeb|webserver]] rewrite (under heavy developement at the moment, be patient please).
* [[FAQ_eD2k/Kademlia#What_is_Kademlia?|Kademlia]] support.
* and and and ..

AMule Project FAQ:About

2004-07-23T13:29:05Z

Xaignar: =aMule specific features=

== aMule -- The [http://www.amule.org all-platform Mule] ==
aMule is an [[eMule]]-like client for the [[FAQ_eD2k/Kademlia|ed2k network]], supporting [http://www.kernel.org Linux], [http://www.bsd.org BSD] platforms, and [http://www.sun.com/solaris Solaris].
Work is underway to add support for [http://www.apple.com/macosx MacOSX], [http://www.microsoft.com/windows Win32] and [http://www.microsoft.com/xbox Xbox].

aMule was forked from [[xMule]] (formely known as [[lMule]]) project back in september 2003, though now has less and less resemblance with the client thsat sired it.

aMule is built upon the [[wxWidgets]] (formely [[wxWidgets|wxWindows]]) toolkit, which enables it to support multiple platforms.

aMule is entirely free, its sourcecode released under the GPL just just eMule, and includes no adware or spyware as is often found in propertary p2p applications.

=== *Mule features ===

[http://www.amule.org aMule] has most features of the [[eMule]] [[Client|client]]. These include:

* [http://www.amule.org aMule] is currently availabe in 25 languages.
* Support for Source Exchange in order to find sources for files more efficently.
* Large queues and the Credit system helps to ensure that everyone will get the file they want and rewards those who activly upload to other users.
* Support for the the compressed transfers and server communication (using [http://www.gzip.org/zlib zlib]), which means faster transfers for compressable files and less strain on servers.
* Support for [[Secure_User_Identification|Secure Identification]], which insures that your user hash cant be stolen in order to inpersonate your client.
* Support for [[IPFilter|IP-Filters]] so that you can keep known bad IPs from connecting to you.
* You can have the traditional progress bar for transfers, percents completed or both.
* aMule supports systrays for both Gnome, KDE and other window managers.
* Supports [[Signature|Online Signatures]], so you can brag about using aMule.
* Checks against aggressive clients.
* Uses MD4 hashes to find sources and ensure that the file macthes the original copies of the file, in order to avoid corruption.
* [[ICH|Intelligent Corruption Handler (ICH)]] helps to speed up the correction of corrupted parts.
* Auto priorities and source management allow you to start many downloads without having to monitor them.
* The Preview function allows you to look at your videos and archives before they are completed. For video previewing, [http://www.mplayerhq.hu MPlayer] or [http://xine.sourceforge.net Xine] is recommanded but [http://www.videolan.org Video Lan Client] should work too.
* Support for categories so that you can organize your downloads.
* To find the files you want, [http://www.amule.org aMule] offers a lot of search possibilities, which are:
** [[Servers]] (local and global) and of course direct integration in your favourite browser for easy klick-and-download (with [[ed2k links|ed2k:// links]]).
* Messaging and [[Friend|Friends]] system:
** You can send messages to other [[clients]] and add them as [[Friend|friends]].
* [http://www.amule.org aMule] supports updating the [[Server|server]] list from an URL during run-time or startup.
* aMule can also update its server list as it connects to other clients.
* PowerShare function: better handling of your shared files (release).

=== aMule specific features ===
* Checks against known leecher and other bad clients clients. These are banned. This feature is thanks to the [www.BlackRat.fr.tc BlackRat eMule mod].
* [[FAQ_aMule#What_is_slot_allocation?|Slot allocation]] allows you to specify how many you wish to upload to at once.For example, if you have 20 kb/s for your maximum upload, you can set slot allocation to 10 kb/s which means that you will upload to two users with 10 kb/s each.
** The [[aMuleCMD|amulecmd]] command line interface and [[aMuleCMD|amulecmdDLG]] and graphical command line interface, to connect to your running [http://www.amule.org aMule] and get status or send commands. Works locally and from remote clients. '''NOTE:''' [[aMuleCMD|amulecmd]] and [[aMuleCMD|amulecmdDLG]] also work in [http://www.microsoft.com/windows Windows]! You can control your [http://www.kernel.org Linux] box from your office's [http://www.microsoft.com/windows Windows] ;)
* Fast [[ed2k links|ED2K Link]] handler at the bottom of every page (can be isabled on Preferences).
* Save 5 [[FAQ_eD2k/Kademlia#What_is_a_source?|sources]] on rare files (<20 sources).

=== Planned Features ===
* Complete [[aMuleWeb|webserver]] rewrite (under heavy developement at the moment, be patient please).
* [[FAQ_eD2k/Kademlia#What_is_Kademlia?|Kademlia]] support.
* and and and ..

AMule Project FAQ:About

2004-07-23T13:28:04Z

Xaignar: =Planned Features=

== aMule -- The [http://www.amule.org all-platform Mule] ==
aMule is an [[eMule]]-like client for the [[FAQ_eD2k/Kademlia|ed2k network]], supporting [http://www.kernel.org Linux], [http://www.bsd.org BSD] platforms, and [http://www.sun.com/solaris Solaris].
Work is underway to add support for [http://www.apple.com/macosx MacOSX], [http://www.microsoft.com/windows Win32] and [http://www.microsoft.com/xbox Xbox].

aMule was forked from [[xMule]] (formely known as [[lMule]]) project back in september 2003, though now has less and less resemblance with the client thsat sired it.

aMule is built upon the [[wxWidgets]] (formely [[wxWidgets|wxWindows]]) toolkit, which enables it to support multiple platforms.

aMule is entirely free, its sourcecode released under the GPL just just eMule, and includes no adware or spyware as is often found in propertary p2p applications.

=== *Mule features ===

[http://www.amule.org aMule] has most features of the [[eMule]] [[Client|client]]. These include:

* [http://www.amule.org aMule] is currently availabe in 25 languages.
* Support for Source Exchange in order to find sources for files more efficently.
* Large queues and the Credit system helps to ensure that everyone will get the file they want and rewards those who activly upload to other users.
* Support for the the compressed transfers and server communication (using [http://www.gzip.org/zlib zlib]), which means faster transfers for compressable files and less strain on servers.
* Support for [[Secure_User_Identification|Secure Identification]], which insures that your user hash cant be stolen in order to inpersonate your client.
* Support for [[IPFilter|IP-Filters]] so that you can keep known bad IPs from connecting to you.
* You can have the traditional progress bar for transfers, percents completed or both.
* aMule supports systrays for both Gnome, KDE and other window managers.
* Supports [[Signature|Online Signatures]], so you can brag about using aMule.
* Checks against aggressive clients.
* Uses MD4 hashes to find sources and ensure that the file macthes the original copies of the file, in order to avoid corruption.
* [[ICH|Intelligent Corruption Handler (ICH)]] helps to speed up the correction of corrupted parts.
* Auto priorities and source management allow you to start many downloads without having to monitor them.
* The Preview function allows you to look at your videos and archives before they are completed. For video previewing, [http://www.mplayerhq.hu MPlayer] or [http://xine.sourceforge.net Xine] is recommanded but [http://www.videolan.org Video Lan Client] should work too.
* Support for categories so that you can organize your downloads.
* To find the files you want, [http://www.amule.org aMule] offers a lot of search possibilities, which are:
** [[Servers]] (local and global) and of course direct integration in your favourite browser for easy klick-and-download (with [[ed2k links|ed2k:// links]]).
* Messaging and [[Friend|Friends]] system:
** You can send messages to other [[clients]] and add them as [[Friend|friends]].
* [http://www.amule.org aMule] supports updating the [[Server|server]] list from an URL during run-time or startup.
* aMule can also update its server list as it connects to other clients.
* PowerShare function: better handling of your shared files (release).

=== aMule specific features ===
* Checks against known leecher and other bad clients clients. These are banned. This feature is thanks to the [http://blackrat.inoteb.net/ BlackRat eMule mod].
* [[FAQ_aMule#What_is_slot_allocation?|Slot allocation]] allows you to specify how many you wish to upload to at once.For example, if you have 20 kb/s for your maximum upload, you can set slot allocation to 10 kb/s which means that you will upload to two users with 10 kb/s each.
** The [[aMuleCMD|amulecmd]] command line interface and [[aMuleCMD|amulecmdDLG]] and graphical command line interface, to connect to your running [http://www.amule.org aMule] and get status or send commands. Works locally and from remote clients. '''NOTE:''' [[aMuleCMD|amulecmd]] and [[aMuleCMD|amulecmdDLG]] also work in [http://www.microsoft.com/windows Windows]! You can control your [http://www.kernel.org Linux] box from your office's [http://www.microsoft.com/windows Windows] ;)
* Fast [[ed2k links|ED2K Link]] handler at the bottom of every page (can be isabled on Preferences).
* Save 5 [[FAQ_eD2k/Kademlia#What_is_a_source?|sources]] on rare files (<20 sources).

=== Planned Features ===
* Complete [[aMuleWeb|webserver]] rewrite (under heavy developement at the moment, be patient please).
* [[FAQ_eD2k/Kademlia#What_is_Kademlia?|Kademlia]] support.
* and and and ..