AMule Project FAQ - User contributions [en]

MlDonkey

2005-05-14T22:58:28Z

80.58.35.107:

== What is [http://mldonkey.berlios.de mlDonkey] ? ==

[http://mldonkey.berlios.de mlDonkey] was the first (partially) open-source client for the [[FAQ_eD2k-Kademlia|ed2k network]], and the source of much controversy due to features that others considered harmful to the [[FAQ_eD2k-Kademlia|ed2k network]]. The core network code was originally kept closed-sources in order to prevent [[Leech|leecher-mods]], however, this was changed after [[eMule]] arrived with a fully open-source client.

Unlike the Mule [[Client]]s, [http://mldonkey.berlios.de mlDonkey] was created as a [[Server|server]]/[[Client|client]] system from the beginning, which means that it runs as a daemon, without the need for a GUI, though many separate GUIs are available. This makes it the client of choice for people who wish to run it on a router or such.

[http://mldonkey.berlios.de mlDonkey] also boasts of supporting other networks than the [[FAQ_eD2k-Kademlia|ed2k network]], such as
* [[Overnet]]
* [[DirectConnect]] (alpha)
* [[Gnutella]] and [[Gnutella2_(G2)|Gnutella2]]
* [[OpenNapster]] (alpha)
* [[SoulSeek]] (beta)
* [[BitTorrent]]
* [[FastTrack]]
* [[AudioGalaxy]] (defunct)
* HTTP, FTP and SSH through FileTP

The newest version of [http://mldonkey.berlios.de mlDonkey] (2.6.30-x) supports a feature know as ''swarming''. With this, it is possible download a file from [[kazaa|Fastrack]], [[BitTorrent]] and [[FAQ_eD2k-Kademlia|ed2k]] networks at same time.

'''NOTE:''' [[aMule]] is a '''separate''' project and is '''not''' related to
[http://mldonkey.berlios.de mlDonkey] in any way.

HowTo Compile aMuled

2005-05-14T22:58:15Z

80.58.35.107:

<center> '''English''' | [[HowTo_Compile_aMuled-es|Español]] </center>

== 1st ==

'''NOTE:''' If you have already installed [[wxWidgets|wxGTK]] 2.5.4 or higher, jump directly into the [[#2nd|second step]], since [[wxGTK]] 2.5.4 includes [[wxBase]] 2.5.4. Note that [[aMuled]] will not compile with earlier versions of [[wxWidgets]], such as version 2.4.2!

Download [[wxBase]] 2.5.4 or higher from http://www.wxWidgets.org
unpack it, and do as user
*''./configure --prefix=/usr/''
'''NOTE:''' If you want [http://www.unicode.org Unicode] support you need to give the ''--enable-unicode'' flag to the configure script.
*''make''
as root
*''make install''
*''ldconfig''

== 2nd ==

*Download [[aMule CVS|amule-cvs]] from http://amule.hirnriss.net
Don't use version 2.0.0-rc8, there was a severe bug in it concerning [[aMuled]]!

Unpack it, and do as user
*''./configure --enable-amulecmd --enable-webserver --disable-monolithic --enable-amule-daemon''
*''make''
as root
*''make install''

That's it. You now have a working [[aMuled|aMule-daemon]] in ''/usr/local/bin'' 
Now you need to configure it. To create the ''~/.aMule/amule.conf'' file, which is the preferences file, run [[aMuled]] once. 
The ''~/.aMule'' directory and the ''~/.aMule/amule.conf'' file will be created in the home directory of the user that ran [[aMuled]]. 
::'''NOTE:''' In [[aMule]] versions previous to 2.0.0 the ''~/.aMule/amule.conf'' file was ''~/.eMule''. 
You probably want [[aMuleWeb]] to control your [[aMuled|daemon]]. To be able to use that you need to enable [[External Connections]]. Check [[Webserver-1.2.x|this article]]. 
I know it's for 1.2.x but since you dont have a GUI to setup everything this is what you want. 
Also read the [[FAQ_amuled|aMuled FAQ]], since some setup things are metioned there.

== Where to report problems and questions? ==

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

[[User:Stefanero|Stefanero]]

If you're compiling on a [[Debian]] installation, and configure can't find ''wx-config'', make sure to install packages ''libwxgtk2.5-dev'', and ''libwxgtk2.5.3''.

YSWPS

2005-05-07T19:32:59Z

80.58.35.107:

This is the recomended distro for using aMule. Its name (Yellow Socks With Pink Spots) is a joke on "Red Hat" and you have just been pwned, in [[User:Xaignar | Xaignar]]'s words.

''<Kry> you know, I never liked that name''

''<Kry> "Red Hat"''

''<Kry> it's like, I'm going to do a distro named "Yellow socks with pink spots"''

''<Kry> now THAT would rock.''

''<Kry> What do you use? "Yellow socks with pink spots"''

''<Citroklar> let's start YSWPS''

''<Kry> how's that for a cool pwn?''

''<Kry> hum.''

''<deltaHF_> LTR''

''<deltaHF_> thats a name''

''<deltaHF_> Linux That Rocks''

''<deltaHF_> ;p''

''<nich> O.o''

''<Citroklar> YSWPS to be the first distribution to feature aMule-2.0.0 on the installation cd.''

''<Citroklar> now how would THAT be?? :-D''

''<Kry> well, false''

''<Kry> as Kanottix does :P''

''<deltaHF_> let us just create a distri called aMule that includes aMule ;P''

''<Citroklar> ups''

''<nich> bleh... still better than the generic "<Platform> OS" or "<company>'s <main gui feature>" we see out there''

''* deltaHF_ wonders what the users thinks about us now ;p''

''* nich doesn't''

'''(extract from [irc://irc.freenode.net/amule #amule] on [irc://irc.freenode.net irc.freenode.net])'''

Install-amule-freebsd

2005-05-07T17:56:34Z

80.58.35.107:

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

The official port is ''/usr/ports/net/amule''

This is the stable version [[aMule]] 1.2.6

We wanna stay current? help testing / debugging: read how to install/compile aMule on your won in this article! Read below.

== 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''

If you are installing any [[aMule]] version between 2.0.0-rc1 and 2.0.0-rc5 (inclusive), you will also need ''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 ;-)

FAQ aMule

2005-05-07T17:40:23Z

80.58.35.107:

<center>
<h4>F.A.Q on [[aMule_Project_FAQ:About|aMule]]</h4>

<h2>by ''[[User:Jacobo221|Jacobo221]]''</h2>

'''English''' | [[FAQ_aMule-es|Español]] | [[FAQ_aMule-it|Italiano]] | [[FAQ_aMule-pt_BR|Português]] | [[FAQ_aMule-fr|Français]] | [[FAQ_aMule-de|Deutsche]] | [[FAQ_aMule-nl|Nederlands]]
</center>

== What is [[aMule_Project_FAQ:About|aMule]]? ==
'''''[[aMule]] is a multi-platform client for the [[FAQ_eD2k-Kademlia|ED2K file sharing network]] based on the windows client [[eMule]].''''' 
aMule started in August 2003 as a fork of [[xMule]], which is a fork of [[lMule]].

It currently supports Linux, FreeBSD, OpenBSD, Windows, MacOS X and X-Box on both 32 bits and 64 bits computers. It should be noted that the Windows port isn't ready for general usage yet.

[[aMule]] is intended to be as user-friendly and feature-plenty as [[eMule]] and to remain faithful to the look of [[eMule]], so users familiar with either [[aMule_Project_FAQ:About|aMule]] or [[eMule]] will be able switch between the two easily.

Since [[aMule_Project_FAQ:About|aMule]] is based upon the [[eMule]] codebase, new features in [[eMule]] tend to find their way to [[aMule]] soon after their inclusion in [[eMule]], so users of [[aMule_Project_FAQ:About|aMule]] can expect to ride the cutting-edge of [[FAQ_eD2k-Kademlia|ED2k]] clients.

The best part is, that it's developed by a great team which is even more user-friendly than [[aMule_Project_FAQ:About|aMule]] itself (if possible), so please join #amule on irc.freenode.net or visit the [http://www.amule.org/amule forums], if you have any suggestions, questions, problems, bugs, patches or what else you might think of.

If you are interested in joining the development team, please contact us either through the [http://www.amule.org/amule forums] or in the IRC channel.

== How do I view a client's credits? ==
You can see any client's credits (the credits you owe him) by right clicking on it's name and selecting Show Details. There is no specific value shown so you can either view the total amount of data that client has sent you or the Credits Modifier (which is called DL/UL Modifier). On that same dialog window, if that client is on your upload queue, you'll be able to view it's rate and score on you.

== What do those colors in the progress bar mean? ==
On the downloading transfers list: 
Red: Chunks in red are chunks with no sources on current session found. 
Blue: Chunks in blue are chunks with at least one available source. The more solid blue it is, the more sources available have been found. 
Yellow: Chunks in yellow are chunks which are being downloaded at this very moment. 
Black: Chunks in black are chunks which have been already downloaded and verified. 
Green: When a file is in green it means that it's been completely downloaded and successfully verified (so, it'll be in the Incoming folder). 
On the expanded transfers list (can be viewed by double-clicking a transfer): 
Black: Chunks which that client has and you don't have. 
White: Chunks which that client doesn't have. 
Green: Chunks which that client has and you have, too. 
Yellow:Chunks which that client is currently uploading to you. 
On the uploading transfers list: 
Black: That client has completed and verified that chunk. 
Grey: That client doesn't have that chunk. 
Have in mind that not all clients support telling other clients which parts they have already completed when uploading, so some clients might have no bar at all. 
On the shared files window: 
Red: When there's no source found to have that same chunk (apart from you, of course). 
Blue: The more solid the blue is, the more spread that chunk is. 
On the search windows: 
Black: Files in black are those which only a client has been found to have. 
Blue: Files in blue are those which two or more clients have been found to have. The more solid the blue is, the more clients have been found to have it. 
Red: Files in red are those which are already in the downloading queue. 
Green: Files in green are those which you are already sharing (you completely downloaded it).

== What are all these icons? ==
See section "Icons and what they signify" in the [[Getting_Started#Icons_and_What_They_Signify|Getting Started]] guide.

== What do those numbers in brackets in the sources column of the searches window mean? ==
Those are the clients who are known to have the complete file. Even if the number in brackets is 0, it doesn't mean that no one has the complete file, it juts means that no client has marked the shared file as "completed" (lots of clients don't do so). So, it's a way to have an idea of how many people have the complete file, but not the definitive way.

== What do all those numbers in the sources column in the transfers window mean? ==
The sources format is XX/YY + ZZ (WW) where 
XX stands for the amount of available sources (the amount of sources found you can download from). 
YY stands for the amount of found sources (the total amount of sources found) 
ZZ stands for the number of "Asked for another file" sources 
WW stands for the amount of sources from who you are currently downloading some chunk of that file.

== What do all those numbers in the priority column in the extended transfers window mean? ==
That's the queue position you have on that client for that specific file. Not all clients provide such information, so in some cases, nothing is displayed. 
The number in brackets is the amount of positions you have "moved" through that client's upload queue. '''Negative''' numbers stand for positions you have '''won''' in the queue since you were added while '''positive''' numbers mean positions you've '''lost''' since since you were added. Notice that when that number is negative, it is displayed blue, while when it's positive, it's displayed red.

== Why are there two transfer rates in the uploading transfer list? ==
When you are uploading some file to some client, the uploading transfer list will show the transfer rate (speed in KBps) in which you are uploading to that client. If, at the same time, that client is uploading to you some file (or files), then the transfer rate's format will change to XX/YY where XX stands for the speed at which you are uploading to that client and YY will stand for the speed at which that client is uploading to you. If you search in the downloading transfers list you'll find that client. 
This is useful if you are trying to get a rare file, since you can see which file that client is uploading to you and, if it's the rare file, you can set him a friend slot so that you upload to that client faster and gain more credits on that client (and consequently, download faster from the client).

== What is A4AF? ==
A4AF stands for ''Ask For Another File''. It is a way to optimize the resources on a specific download. 
When you try to download a file, aMule gets a list of clients who are sharing that file. Some of these clients might also share some other file which you are also trying to download and, so, you might have that client in two separate download queues. 
A4AF tries to avoid this situations. Why? Because you can't download two chunks at the same time from the same client. So, by setting A4AF in a specific download, you are telling aMule to search for any client in that file's download queue who is also in some other file's download queue and remove it from that other download queue. This way, you'll get more sources on that file. 
You can also set a specific download to apply A4AF in the opposite way, that is, to give sources to the other downloads. This should be done on downloads which are not to be downloaded with too much hurry or which should be downloaded after some other similar file has been downloaded (in a series of files, for example). 
This also can be seen as a way of establishing preferences in downloads.

When the request swapping is done, the Queue Rank will be maintained.

'''NOTE:''' A source with a QR lower than 50 in the download with the higher priority will never be swapped. This is done this way to ensure it starts downloading from it.

== What is the difference between Transfered and Completed in the Transfers window? ==
Transfered shows the amount of data you have received concerning that file. This data is downloaded in a compressed format. Once the data gets to your machine, aMule processes it and decompresses it. The total useful data that can be taken from that received data (that is, the parts of that data which are actually real parts of the file you are trying to download and not headers or such stuff) is the amount that can be viewed in the Completed column.

== What is the difference between pausing and stopping a transfer? ==
When a transfer is paused, all connections related to the paused transfer are broken with the other clients so that no data is transfered, but sources aren't dropped, so that when the transfer is resumed, [[aMule_Project_FAQ:About|aMule]] will try to connect to those sources it was transferring from.
Instead, when a transfer is stopped, all sources are dropped so, when it's resumed, [[aMule_Project_FAQ:About|aMule]] will start searching for clients who are sharing that file.

== What are all those files [[aMule_Project_FAQ:About|aMule]] creates the first time it is run? ==

Most them are the same as [[eMule|eMule]]'s.

Detailed information about each and a list of all of [[aMule]]'s files can be found [[aMule files|here]].

== Can I use [[eMule|eMule]]'s files and settings and vice-versa? ==
Most of them yes. The only ones you can't share between [[aMule_Project_FAQ:About|aMule]] and [[eMule]] are the program configuration (that is, preferences.ini in [[eMule]] and ''~/.eMule'' in [[aMule_Project_FAQ:About|aMule]]). All the [[FAQ_eD2k-Kademlia|ED2K network]] related files can be successfully shared between the two applications with no more effort than copying the files in ''~/.aMule'' to the [[eMule]]'s directory and vice-versa. But have in mind that some files in ''~/.aMule'' are [[aMule_Project_FAQ:About|aMule]] specific, such as ''amulesig.dat'' or ''aMule.tmpl'', so it's better to only move those files that are in both the [[aMule_Project_FAQ:About|aMule]] and the [[eMule]] directory.

Moving half downloaded files is easy: just move them from your [[eMule]] temp directory (by default ''C:\Program files\eMule\Temp'') into ''~/.aMule/Temp'' or whatever your temp directory is in your [[aMule]] configuration.

== What is all that stuff in amulesig.dat and onlinesig.dat? ==

I guess you already read what [[amulesig.dat_file|''amulesig.dat'']] and [[onlinesig.dat_file|''onlinesig.dat'']] are for [[FAQ_aMule#What_are_all_those_files_aMule_creates_the_first_time_it_is_run?|above]].

So, this files contain the current [[signature]] (the current [[aMule]] status, if enabled, of course).

Detailed information about each of thee files can be found in the [[amulesig.dat_file|''amulesig.dat'' article]] and the [[onlinesig.dat_file|''onlinesig.dat'' article]].

== I just installed [[aMule_Project_FAQ:About|aMule]] for the first time. How do I set it up? ==
Setting up aMule properly is just a matter of tastes and depends on many factors. If you just wish a quick startup configuration, then continue reading. 
Open [[aMule_Project_FAQ:About|aMule]] and click on the Preferences button. Set a nickname and the language in which you wish to have [[aMule_Project_FAQ:About|aMule]]. Then switch to the Connection tab and input your Line Capacities. Then input the Bandwidth Limits according to the maximum amount of bandwidth you want [[aMule_Project_FAQ:About|aMule]] to use. Then switch to the Directories tab and set a directory for both the temporary files (where files will be stored until they are completely downloaded) and the completed files. Finally, select the directories which you want to share. It is not recommended to share too much files. Read below "What are the best settings I can set to have a nice download rate". To select recursively all directories inside a certain directory read [[aMule_problems#Is there any way to recursively select a whole directory and its contents?|Is there any way to recursively select a whole directory and its contents?]].

== Will [[aMule_Project_FAQ:About|aMule]] handle my [[xMule]] and [[lMule]] files? What should I do? ==
[[aMule_Project_FAQ:About|aMule]] automatically handles both [[lMule]] and [[xMule]]'s configuration files, but in different ways: 
[[lMule]] has been discontinued for several years now, so [[aMule_Project_FAQ:About|aMule]] understands that you are replacing [[lMule]] with [[aMule_Project_FAQ:About|aMule]], so it renames ~/.lMule folder to ~/.aMule. If you used ~/.lMule/Temp and ~/.lMule/Incoming as your temporary and downloading directories respectively, you should change the paths in Preferences to ~/.aMule/Temp and ~/.aMule/Incoming respectively. 

If a ~/.xMule directory is found, it will be kept unchanged and [[aMule]] will just copy the configuration files found in it. That means that the files you were downloading will remain in the ~/.xMule directory if they were downloading there, but since [[aMule_Project_FAQ:About|aMule]] has handled [[xMule]]'s configuration files, it will use still use it. You can either live with that, or move directories ~/.xMule/Temp and ~/.xMule/Incoming into ~/.aMule and change directories in Preferences.

== How do I start my [[aMule_Project_FAQ:About|aMule]] experience? ==
Just click on the Connect button. You should have some servers listed on the Servers window, though. If you have no servers listed, then click on the little button below the Connect button in the Servers window before clicking the Connect button. After some time, [[aMule_Project_FAQ:About|aMule]] will be connected to some server (you'll know because in the lower right corner the "Not connected" message will disappear). When connected, switch to the Search window and search for the file you want and once you find the file you want, double-click on it. 
For general [[aMule_Project_FAQ:About|aMule]] usage, join [[aMule_Project_FAQ:About|aMule]] #amule in irc.freenode.net or ask in forums at [http://www.amule.org/amule http://www.amule.org/amule]

== What are the best settings I can set to have a nice download rate? ==
If you understood "Is there any limit on the [[FAQ_eD2k-Kademlia|ED2K]] network?" then you might have seen that, if your provider allows you, the best is to have the upload limit set to a minimum of 10 KBps. Also, if you understood "What is all that credits, rate and score stuff about?", you might also understand that the more you upload, the more you download, so take the upload limit up as much as you can. A good tip (thanks to kaouete) when you are trying to download some rare or "never completing" file, is, whenever you see someone uploading to you some chunk of that file, give that client a friend slot so that, if it tries to download something from you, it gets preference and you gain credits on that client.

== Is there a way to open a text file and load all the ed2k links from the file? ==
Yes, there is. Just place all the ed2k links you want to download in a text file, each ed2k link in a separate line. Name that file ''ED2KLinks'' then place it in ''~/.aMule'' and aMule will automatically detect it, add all those ed2k links to download and remove the file. 
You might want to read [[ED2KLinks_file|this]] to know more about this file.

== Can I manage [[aMule_Project_FAQ:About|aMule]] remotely through telnet in the same way I do with [[eDonkey2000|eDonkey]]? ==
Yes you can, but not exactly in the same way as you do with [[eDonkey2000|eDonkey]]. Just start a normal telnet (or ssh) session with the host computer (the one running [[aMule_Project_FAQ:About|aMule]]) and, once in, use amulecmd to take control over [[aMule_Project_FAQ:About|aMule]]. To start new downloads just use the [[ed2k_command|ed2k command]]. Remember [[aMuleCMD]] must be configured. 
Another aMule utility that might be of your interest is [[CAS]] (which's command is <code>cas</code>) which will show basic [[aMule_Project_FAQ:About|aMule]] statistics. 
Also, [[amuleweb|aMule WebServer]] might be what you are looking for if you can and don't mind using a web browser on the client computer. Have in mind that aMule WebBrowser must also be configured.

== Is there any way to start [[aMule_Project_FAQ:About|aMule]] with no graphical interface? ==

Yes. Since aMule 2.0.0-rc6, you can use aMule Daemon, which can be executed on the command line by typing ''amuled''. To control it, use either aMuleWeb, aMuleCMD or any other such application for remotely controlling aMule.

Anyway, up to aMule 2.0.0-rc6, [[aMule_Project_FAQ:About|aMule]] was a monolithic application. This means that core and GUI were whole inseparable block.

So, for those using an old aMule version or who refuse to use aMuled (aMule Daemon), there are still two walkarounds to run [[aMule_Project_FAQ:About|aMule]] on command line but they're not direct ways:
*Through ''[http://xfree.org/4.4.0/Xvfb.1.html Xvfb]''
*Through ''[http://www.realvnc.com VNC]''

'''Through ''[http://xfree.org/4.4.0/Xvfb.1.html Xvfb]:''' 
You should run <code>[http://xfree.org/4.4.0/Xvfb.1.html Xvfb]</code> and then run aMule in it. Afterwards you can take control over [[aMule_Project_FAQ:About|aMule]] using [[aMuleCMD]] and [[ed2k_command|ed2k]] in the same way as you would if you were accessing [[aMule_Project_FAQ:About|aMule]] remotely over telnet (see above).

Short example: 
Run [http://xfree.org/4.4.0/Xvfb.1.html Xvfb]: 
<code>Xvfb :1 -screen 0 640x480x16 &</code> 
Set display to use for amule: 
<code>export DISPLAY=:1</code> 
Then run [[aMule_Project_FAQ:About|aMule]]: 
<code>amule &</code> 
Note: After running <code>export DISPLAY=:1</code>, all graphical applications launched from that shell will be opened in [http://xfree.org/4.4.0/Xvfb.1.html Xvfb]'s display. To avoid this, you can run [[aMule_Project_FAQ:About|aMule]] with the following command, so that only [[aMule_Project_FAQ:About|aMule]] runs there: 
<code>DISPLAY=:1 amule &</code> 
'''INFO:''' See the [[Screen]] page to know more about the [[Screen]] command

'''Through ''[http://www.realvnc.com VNC]:''' 
It's also possible to use ''vncserver'' instead of [http://xfree.org/4.4.0/Xvfb.1.html Xvfb] to achieve something similar. Just install ''vncserver'' and execute ''vncserver :0 -geometry 1024x768'' followed by ''export DISPLAY=:0''. This will create a hidden [http://xfree.org X] server, accessible only remotely using a [http://www.realvnc.com VNC] client. Once the [http://xfree.org X] server is running, you will need a window manager to manage [[aMule]] window (well, it's not really needed, but it's useful if you want to be able to close [[aMule]] without simply killing it), I recommend [http://fluxbox.sourceforge.net FluxBox] due to its low CPU and memory requirements. Just start it with ''fluxbox &'' and then run [[aMule]] with ''amule &''. Now you can connect to the [http://www.realvnc.com VNC] server and see the [[aMule]] window.

Keep in mind that if [[aMule]] shows any dialog that requires user input (like the one showed the first time [[aMule]] is executed), it will get stuck there until someone connects to the [http://www.realvnc.com VNC] server and clicks ok in the dialog. Usually, this should only need to be done once (and this connection may be used to update the serverlist and set the preferences), from then on [[aMule]] will start without user interaction, showing only some informational messages at startup.

If you need help on this issue, search [[aMule_Project_FAQ:About|aMule]]'s [http://www.amule.org/amule forums] or join #amule [[IRC]] channel at irc.freenode.net and ask.

== Can I run two [[aMule_Project_FAQ:About|aMule]] instances at the same time? ==
Yes you can, although it is not recommended. [[aMule_Project_FAQ:About|aMule]] will only check if the concurrent user is running some [[aMule_Project_FAQ:About|aMule]] instance, so you can run as many [[aMule_Project_FAQ:About|aMule]] instances as user accounts you have access to. To do this, just run <code>xhost +</code> and then <code>su</code> as another user and run aMule from that shell. 
Be aware, since [[aMule_Project_FAQ:About|aMule]] can't check if a user is running [[aMule_Project_FAQ:About|aMule]] on another X display. So, if your account is already running some [[aMule_Project_FAQ:About|aMule]] instance in some other X display, do not run another [[aMule_Project_FAQ:About|aMule]] instance on another X display or you might end up with lost configuration settings and corrupt chunks.

== How can I get those nice [[aMule_Project_FAQ:About|aMule]] statistics some people post on the IRC channels? ==
You can either copy and paste [[CAS]]'s (C [[aMule_Project_FAQ:About|aMule]] Statistics) output (to execute [[CAS]], run <code>cas</code>) or, if you use xChat as your IRC client and have the Perl module installed, you could use [[XAS]] (xChat [[aMule_Project_FAQ:About|aMule]] Statistics).

== What is slot allocation? ==
Each upload is a slot, so, if you are uploading to five clients at the same time, you have five upload slots established. So, the amount of slot allocation is the bandwidth which each slot will be given. 
As an example, if your upload limit is 20KBps, you can set slot allocation to 2KBps which means 10 clients will be able to download from you at the same time, each of them at a maximum transfer rate of 2KBps. 
See section "Why is aMule ignoring the bandwidth I set per slot?" in [[AMule_problems|aMule common problem's FAQ]].

== What is a friend slot? ==
A friend slot is just a slot which is assigned to a client in the friends list. Only one friend can have a slot at the same time. Whenever that friend (who has the friend slot enabled) tries to download a file from you, it will be given highest priority in the uploads queue, since it has that slot always assigned. While that friend isn't downloading, that assigned slot will be given to the client with the highest priority in the upload queue, as expected.

== What is the real point on setting up Line Capacities in Preferences? Shouldn't [[aMule_Project_FAQ:About|aMule]] only care for the Bandwidth Limits? ==
aMule really only cares for the Bandwidth Limits. Line Capacities are only set for the Statics display. Let's see: Imagine you have a 100KBps connection, imagine you want to set the Limit at 40KBps because you have a web server which needs a minimum of 60KBps to serve all the petitions. Now imagine you download rare indonesian free songs. You most surely never download at more than 3KBps ever. So, you could set Line Capacities at 5KBps so that the graph at Statics has some meaning, since if you set it up as a 100KBps connection, the graph will show an horizontal line with no meaning at all.

== aMule is crashing quite often here. Can I set it to restart every time it crashes? ==
No, you can't. But you can have scripts to do so. Some of these scripts even work if aMule '''hangs''' but doesn't '''crash'''. 
The following scripts might suit your needs: 
[http://www.amule.org/amule/thread.php?threadid=1232 http://www.amule.org/amule/thread.php?threadid=1232] 
[http://www.amule.org/amule/thread.php?threadid=542 http://www.amule.org/amule/thread.php?threadid=542] 
[http://deepthought.ena.si/mulerunner http://deepthought.ena.si/mulerunner]

== Can I have aMule get data from the standard input to pass it to GDB or Valgrind? ==
Yes, you can. Up to aMule 2.0.0-rc3 this wasn't allowed, but as of version 2.0.0-rc4 you can with the parameter ''-i'' or ''--enable-stdin''. 
Anyway, people with aMule versions previous to 2.0.0-rc4 can use [http://www.amule.org/amule/thread.php?threadid=2474 phoenix's aMule stdin patch].

== How can I switch to aMule from eMule without losing my credits? ==
If you already read [[FAQ_aMule#What_are_all_those_files_aMule_creates_the_first_time_it_is_run?|about the meaning of aMule's files]], you might already know what you have to do: 
Get ''cryptkey.dat'', ''clients.met'' and ''preferences.dat'' files from eMule's config directory (usually, under Windows, something like ''C:\Program files\eMule\config'') and copy them into ''~/.aMule''. Now start aMule so it reads those files. You're done!

== What is all this [[rabbit]] story about? ==
Ah, yeah, this all began... ehm... well... I mean... follow the white [[rabbit]] ;-)

== Which one is the recomended distro / Operating System for running [[aMule]]? ==

The absolutely recomended distro is [[YSWPS]]. It's still not a mature distro, but it's worth the effort to look for it.