AMule Project FAQ - User contributions [en]

AMule devs

2006-04-06T20:06:40Z

129.125.101.92: fixed 1 typo: weel -> well

== The [[aMule]] Project ==
The aMule project is led by a bunch of people (tho some rumours say they are monkeys) who toil away in front of their computers, so that you can enjoy a stable and featureful P2P client.
This page is about them.

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

=== Developers ===
* [[User:deltaHF|deltaHF]]: Webmaster, Admin and from-time-to-time-coder ;)
* [[User:falso|falso]]: [[CAS]] coder.
* [[User:GonoszTopi|GonoszTopi]]: [[External Connections]] developer.
* [[User:Hetfield|Hetfield]]: Ex-Admin, pretty-no-free-time coder.
* [[User:Jacobo221|Jacobo221]]: Our man-for-all
* [[User:ken|Ken]]: The big [http://www.apple.com/macosx Mac] guy.
* [[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!

=== Testers ===
* [[User:Citroklar|Citroklar]]: Tester, slave-work-coder (sometimes)
* ender`: Tester
* [[User:lionel77|lionel77]]: Tester and provider of binaries for Mac OS
* nachbarnebenan: Tester, and life-complicator by using large&strange nicks ;-P
* nich: Tester
* skolnick: Solaris tester
* [[User:Stefanero|Stefanero]]: Supporter, Tester, and [[aMuleWeb]] Guru
* [[User:thedude0001|thedude0001]]: Tester

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

=== Is this Team competent enough? ===

There is a private IRC channel where aMule developers talk about future plans, developing roadmaps and help each other. Many people wonder how's life in that channel. It is well known that a good working environment grants an efficient development. Now, [[A_random_day_in_aMule_development|get a random example of what the Team's working environment is]] ('''Parental advisory:''' Keep your children away from this link!).

== 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 C++ is the language in which [[aMule]] is written. You'll also need to learn about the GUI toolkit used by [[aMule]]: [[wxWidgets]]. In addition, you are required to our [[Coding Style]] rules or we will beat you to death with a sockful of rocks. We do not require that you be an expert, only that you are willing to help and learn.

If you are interested, then simply drop by the [[IRC|IRC Channel]] 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]].

We can especially use your skills if you are using one of the platforms: [http://www.unix.org Unix], *[http://www.bsd.org BSD], [http://www.sun.com/solaris Solaris], [http://www.apple.com Macs] and [http://www.microsoft.com/windows Windows]. If your operating system of choice isn't on that list, then perhaps you can contribute.

=== 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 look at the [[Translations|aMule translation howto]].

BTW, you can also help with [[Translating_Wiki|translating aMule wiki]] articles. There's always lots of work to do. =)

== Contact ==

Contacting the aMule Team is easy. Choose between any of the listed ways in the [[contact|contact article]]. Just please do it once, avoiding spam or floods.

AMuleWeb

2006-04-02T13:18:23Z

129.125.101.92: Fixed the aMuled link

== 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|aMule]]

'''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 [[aMuled|aMule Daemon]] 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]].

Making a handy amulecmd script

2006-03-31T14:08:20Z

129.125.101.92:

== What is the goal? ==

This script is meant to display information about what your [[aMuled]] has been up to in a way pleasing to the eyes, using [[AMuleCMD]]. Because it depends on the "show log" command, make sure you use aMule version 2.1.2 or higher.

== The standard script ==

The script itself is quite simple:

#!/bin/sh
# Version 20060330

domule() {
amulecmd -c "$@" | grep "^ >"
}
domule "show log" | sed "
/: Failed to / {s/: $.*$/: `tput setaf 1`\1`tput sgr0`/;}
/: Finished downloading/ {s/: $.*$/: `tput setaf 2`\1`tput sgr0`/;}
/: Downloading / {s/: $.*$/: `tput setaf 3`\1`tput sgr0`/;}
"
echo ""
domule "status" | sed "
/Download:/ {s/$Download:$$.*$/\1`tput setaf 3`\2`tput sgr0`/;}
/Upload:/ {s/$Upload:$$.*$/\1`tput setaf 2`\2`tput sgr0`/;}
"
domule "reset" >/dev/null

Note:
* This depends on the sh shell, the grep command and the sed command. If your system does not have sh, you will either have to install or change the first line to a shell you do have, f.e., /bin/bash

When executing this script, you get something like this:

http://qtea.nl/amule/amulelog.png

== How to change the colours ==

The "tput set <digit>" is used to insert the colour codes. The different numbers stand for different colours. See man tput for other tricks you can do with tput.

== How to remove the colours ==

If you don't want the colours at all, you can remove the sed commands:

#!/bin/sh
# Version 20060330

domule() {
amulecmd -c "$@" | grep "^ >"
}
domule "show log"
echo ""
domule "status"
domule "reset" >/dev/null

== Nice, but I only want to see finished downloads ==

This can be achieved by using the grep command:

#!/bin/sh
# Version 20060330

domule() {
amulecmd -c "$@" | grep "^ >"
}
domule "show log" | grep ": Finished downloading" || echo " > No finished downloads"

echo ""
domule "status"
domule "reset" >/dev/null

== How to use these scripts ==

Simply save them to a plain text file and make them executable (f.e., on linux by applying 'chmod u+x <yourscriptfilehere>'). This will work on most OS'es, except maybe for Windows since the standard version does not come with a useful command line shell.

== Conclusion ==

There are a hunderd different things you can do with the output of "show log", only limited by your imagination ;) If you want to change the behaviour of the script you might want to check out commands such as grep (easy), awk (a bit harder) and sed (can be quite tricky).

FAQ amulecmd

2006-03-31T14:06:55Z

129.125.101.92:

'''How can I configure amulecmd to schedule actions? (Linux)'''

You have to configure such jobs with crontab. Let's do it by example: 
:bash ~# crontab -e
:00 6   * * * amulecmd -c "set bwlimit up 30"
:00 22 * * * amulecmd -c "set bwlimit up 0"
Will set your download bandwith limit to 30 kb/s on 6:00am and unlimited on 10:00pm. For more possibilities see also [[aMuleCMD]].

'''I cannot connect to [[aMuled]]. It seems [[aMuled]] does not create the listening port for connecting to it :-\?'''

You have probably not enabled [[External Connections]] in ''~/.aMule/amule.conf

{|
|valign=top | '''NOTE:''' || You can create the value for ''ECPassword'' like that:
|-
| ||$ echo -n yourpasswordhere | md5sum | cut -d ' ' -f 1
|}

'''How can I receive a mail every day with a summary of the files amuled downloaded ?'''

First, create [[Making a handy amulecmd script|this]] script and verify that it works properly. Then you can add it to your cron in the same way as shown above. Many cron-daemons will mail output of a script to your user. You can also use utilities like sendmail to mail the output of the script.

AMuleCMD

2006-03-31T13:57:44Z

129.125.101.92:

Basically, aMuleCMD is a command line interface to access [[aMule]] or [[aMuled]] locally or remote. To run AMuleCMD simply type the command name at a command prompt. Note it's all lower case.
:$>amulecmd
(This is based on [[linux.definition|Linux]]. You may need to go to the actual directory on other OS's if it's not in the path.)

According to the amulecmd help you can perform the following commands:

*Available
*Add
*Cancel
*Connect
*Disconnect
*Exit
*Get
*Help
*Pause
*Quit
*Reload
*Resume
*Set
*Show
*Shutdown
*Statistics
*Status

You can use this command to perform scheduled jobs with aMule(d), too. See [[FAQ_amulecmd]] for more details. 
If you prefer something more graphical use [[AMuleGUI]] (or [[aMule]] of course ;-).

'''NOTE:''' You must have [[External Connections]] enabled in order to be able to connect to aMule(d).

I needed to set "use [http://www.networksorcery.com/enp/protocol/tcp.htm TCP] ports instead of [http://www.unix.org Unix] local sockets" to be on, in Preferences -> Remote Connection -> External Connection Parameters.

Making a handy amulecmd script

2006-03-31T13:51:59Z

129.125.101.92:

== What is the goal? ==

This script is meant to display information about what your [[aMuled]] has been up to in a way pleasing to the eyes, using [[AMuleCMD]]. Because it depends on the "show log" command, make sure you use aMule version 2.1.2 or higher.

== The standard script ==

The script itself is quite simple:

#!/bin/sh
# Version 20060330

domule() {
amulecmd -c "$@" | grep "^ >"
}
domule "show log" | sed "
/: Failed to / {s/: $.*$/: `tput setaf 1`\1`tput sgr0`/;}
/: Finished downloading/ {s/: $.*$/: `tput setaf 2`\1`tput sgr0`/;}
/: Downloading / {s/: $.*$/: `tput setaf 3`\1`tput sgr0`/;}
"
echo ""
domule "status" | sed "
/Download:/ {s/$Download:$$.*$/\1`tput setaf 3`\2`tput sgr0`/;}
/Upload:/ {s/$Upload:$$.*$/\1`tput setaf 2`\2`tput sgr0`/;}
"
domule "reset" >/dev/null

Note:
* This depends on the sh shell, the grep command and the sed command. If your system does not have sh, you will either have to install or change the first line to a shell you do have, f.e., /bin/bash

When executing this script, you get something like this:

http://qtea.nl/amule/amulelog.png

== How to change the colours ==

The "tput set <digit>" is used to insert the colour codes. The different numbers stand for different colours. See man tput for other tricks you can do with tput.

== How to remove the colours ==

If you don't want the colours at all, you can remove the sed commands:

#!/bin/sh
# Version 20060330

domule() {
amulecmd -c "$@" | grep "^ >"
}
domule "show log"
echo ""
domule "status"
domule "reset" >/dev/null

== Nice, but I only want to see finished downloads ==

This can be achieved by using the grep command:

#!/bin/sh
# Version 20060330

domule() {
amulecmd -c "$@" | grep "^ >"
}
domule "show log" | grep ": Finished downloading" || echo " > No finished downloads"

echo ""
domule "status"
domule "reset" >/dev/null

== How to use these scripts ==

Simply save them to a plain text file and make them executable by applying 'chmod u+x <yourscriptfilehere>'. This will work on most OS'es, except maybe for Windows since the standard version does not come with command line tools like grep.

== Conclusion ==

There are a hunderd different things you can do with the output of "show log", only limited by your imagination ;) If you want to change the behaviour of the script you might want to check out commands such as grep (easy), awk (a bit harder) and sed (can be quite tricky).

AMule problems

2005-02-15T07:13:09Z

129.125.101.92:

<center>
<h4>[[aMule_Project_FAQ:About|aMule]] common problems</h4>

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

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

== I get an "aMule already running: exiting" message on the terminal when starting aMule. Will I be able to start it in any way? ==
This message is very clear: aMule is already running. But this doesn't refer to the entire system, but that '''you''' (your user account) is running aMule already. 
You might, anyway, think there's no aMule running, since it crashed. But it sometimes happens that some processes aren't completly closed, instead they keep in a status known as ''zombie'' or ''defunct''. To know if this is your problem, run ''ps u | grep amule'' and if it shows any output, then there's some other aMule process running with your account. To kill it, either close it normally (if you can) or kill it with ''kill -9 <aMule-PID>'' or ''killall -9 amule'' or logoff and log in again (which, in most cases should also kill aMule processes, except if you executed aMule with ''nohup'' or something alike). 
If non of the above suits you, then you can run another aMule as another user (if you can log in with another account, of course). Read [[FAQ_aMule#Can_I_run_two_aMule_instances_at_the_same_time?|Can I run two aMule instances at the same time?]].

== aMule starts but is never shown, allthough it's working fine. What's going on? ==
This may happen if you set the incorrect type of SysTray in Preferences -> General -> "Systray Integration" and you set aMule to minimize to tray and you set aMule to start minimized. So you really took some time to brake it, didn't you? 
To be able to recover aMule's GUI, edit ''~/.eMule'' and search for ''StartupMinimized=1'' and once you find it, change that line to ''StartupMinimized=0''. The following script will do that for you: 
''sed s/StartupMinimized=1/StartupMinimized=0/ ~/.eMule > ~/.eMule.temp && mv -f ~/.eMule.temp ~/.eMule'' 
When you next start aMule set the correct SysTray integration in Preferences so that you can enable "Start minimized" without having aMule being hidden. 
If for some reason the above didn't work, try changing manually the Systray integration in your to the default "No systray integration" option. To do so, set the ''DesktopMode='' value in ''~/.eMule'' to ''4''. The following script will do that for you: 
''sed s/DesktopMode=[0-9]/DesktopMode=4/ ~/.eMule > ~/.eMule.temp && mv -f ~/.eMule.temp ~/.eMule'' 
'''NOTE:''' On [[aMule]] versions previous to 2.0.0rc4, you should set it to ''1'' instead of ''4'' since the Preferences storage changed a little.

== aMule starts but is never connecting/behaving very weird/crashing almost every few seconds/etc...? ==
aMule versions up to 2.0.0-rc3 shouldn't be linked against wxWidgets 2.5.x neither GTK2 although some Linux distributions tend to do so. Please make sure your aMule isn't the case. If unsure, paste you backtrace at [http://www.amule.org/amule/board.php?boardid=33 aMule's Backtraces forum] or join aMule's IRC channel #amule at irc.freenode.net

== Where are my downloaded files? ==
By default, aMule stores completed files in ''~/.aMule/Incoming'' but, since ''~/.aMule'' directory is a hidden directory, your file manager might not show it. Make sure you have enabled your file manager to show hidden files. 
By default, files being downloaded are placed in ''~/.aMule/Temp'', so again, this is a hidden directory and the file managed must be configured to show hidden files.

== Why is aMule taking so much CPU resources at start-up? ==
This happens because aMule is hashing new files found on the Shared Directories. If aMule is always taking a lot of CPU at startup and no new files have been added or modified in any way in the Shared Directories, then something is wrong. 
In aMule versions earlier than 2.0.0-rc3 this used to happen when having the Temp, Incoming or any Shared Directory in a FAT32 partition. Since aMule 2.0.0-rc3 this is not happening any more. 
Also, in aMule versions earlier than 2.0.0-rc4 filesystems with UTF-8 encoding (known to happen with SuSE 9.1) could present problems when some file or directory in the Shared Directories path contanied a special character. If this is your problem, there's a walkaround (thanks '''nachbarnebenan'''): after aMule has hashed all shared files (that is, when it stops taking a lot of your CPU's resources), close aMule and enconde ~/.aMule/known.met into UTF-8 encoding (you can do this with the application ''[http://www.gnu.org/directory/recode.html recode]'' by running the following command: ''recode u8 ~/.aMule/known.met''). This should be done whenever a files is added or modified in any Shared Directory. So, best option is to upgrade to latest aMule version. 
If non of the above helps you, then something went really wrong on ''known.met'' file, probably some external program or user broke it. Best option is to delete it, start aMule and let aMule rehash all files again.

== So now aMule starts, but why is it displaying this message: "No valid servers to connect in serverlist found"? ==
That's because you enabled the option "Auto connect to servers the static list only". So, disable it or add some server to the static list. 
To disable that option, go to Preferences -> Servers -> "Auto connect to servers the static list only" 
To add a server to the static list, go to the Servers window and right-click on the server you want to add to the static list. Then select "Add to static" and do this exact process wit all the servers you want to add to the static list.

== aMule connects to server, but it is always given LowID. Why? and, can I do something about it? ==
This can bue due to three reasons:
<ul><li>Some necessary port is not opened in your firewall. Read [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|this]] to get to know what to do and check [http://www.amule.org/testport.php here] if the ports are open.</li>
<li>The server is very busy or maybe badly configured, so it's giving you a LowID. There's nothing that can be done in this case other than reconnect or connect to some other server.</li>
<li>Some ISP forbid the use of p2p applications, such as aMule, by not allowing traffic through popular p2p ports. In these cases, configure aMule to use some other port. It would be even better if it was some popular port used for some other issue. It's been known that on some ISPs it worked with port TCP 25600.</li></ul>

== [[aMule]] was interrupted while completing a file and it is now never completing it (allthough it's 100% downloaded). How can I complete it? ==
This one is easy: Close [[aMule]]. Now go into the Temp directory (by default, ''~/.aMule/Temp'') and run the following command:

''touch ./*''

Finally, run [[aMule]] and let it complete the files.

== I just lost a download. Is there anyway I can recover it? ==
This is strange to happen, but it might, although in most cases it is the result of some non-aMule-related stuff going weird (or user's fault). 
Two things may have happened. Either *.part.met files were deleted, or *.part files were deleted. 
If *.part files have dissapeared, the only solution is to reastart the downloads from the beggining (if *.part.met files are still there, aMule will restart the downloads on next start). However this should '''never''' happen unless the user directly deleted them. 
If *.part.met files have dissapeared but *.part files are still in the Temp directory, then search if *.part.met.bak are also in the Temp directory. If they are, then just rename ''*.part.met.bak'' files to ''*.part.met'' just by running: 
''for file in *.part.met.bak; do mv -f "$file" "${file%.bak}; done'' 
Still, it could happen that, although you have the *.part files, neither *.part.met nor *.part.met.bak files exist any longer. In this case, you would have two ways ways to work out of this: 
Either, use [http://www.bigwillystyle42.com/index.php?dest=mfr MetFileRegenerator] (Java needed) to reconstruct the *.part.met files. 
Or, search again on aMule for the files you were downloading and rename their part number in the *.part.met files to the ones it used to have. For example, if you ware down loading ''aMule_1.2.6.tar.gz'' and that was being downloaded in Temp directory as ''008.part'', then that file used to have it's corresponding ''008.part.met'' file and, probably, it's ''008.part.met.bak'' file. But this two latter files have misteriously dissapeared. Then search again on aMule for ''aMule_1.2.6.tar.gz'' and start downloading it. Close aMule and you'll have this new download as, for example, ''011.part'' file in the Temp directory. Of course, this download will have it's ''011.part.met'' file. Well, rename ''011.part.met'' to ''008.part.met'' and then delete ''011.part'' (and ''011.part.met.bak'' if it existed). Now start aMule and you will have recovered the download from the point it was before the *.part.met files disapeared.

== Why does aMule suddendly become unresponsive to the mouse although it's not hanged? ==
It sometimes happens that you left a dialog window somewhere hidden in the desktop. aMule is waiting for that window to be closed, so it becomes unresponsive untill you click OK, Cancel, or whatever you have to click. 
So, make sure there's no aMule dialog left around in '''any workspace'''.

== Why are some files in my shared folders not shown in the Shared Folders window? ==
This could happen if you added this files after aMule has been started. Press the "Reload" button on Shared Folders window and it should find the new files and hash them (this may take some CPU time). 
However, on some releases it has happened that after restarting aMule, some files dissapear from the Shared Folders window alllthough they are in the shared folders. In such cases, the only way to have them back is to delete ''~/.aMule/known.met'' but, of course, on next aMule start, all shared files will have to be rehashed, and that'll take some time most probably.

== I always get a message about addresses.met when I start aMule. What's wrong? ==
This happens when you enable the option Preferences -> Servers -> "Auto-update serverlist at startup" and you have no serverlists' urls in ''addresses.dat''. You can either add some to ''addresses.dat'' by adding them at Preferences -> Servers -> List or just disable Preferences -> Servers -> "Auto-update serverlist at startup" if you don't really need it. 

== I sometimes get a message on the log about credits being lost. Should I be worried? ==
No, you don't need to be worried. Credits for a client are deleted after 150 days (more or less 5 months) without "seeing" that client. Also, bad clients might lose their credits too. So those messages are just for debug information, you souldn't worry about them.

== What should I do if I lose my ''cryptkey.dat'' file? ==
Losing that file will automatically make you loose all your credits with it, sorry. IF you will to start collecting credits again from this very moment, delete ''~/.aMule/preferences.dat'' too. If you don't, you'll be unable to collect credits on those [[client]]s which had sometime (before loosing the ''cryptkey.dat file) identified you.

== Why is Upload/Download limit always back to 0 after every restart? ==
This happened on aMule versions previous to 2.0.0-rc4 when you trying to set a Upload or Download limit value higher than the Upload or Download Capacity value. However, since version 2.0.0-rc4 this is fixed (read [[FAQ_aMule#What_is_the_real_point_on_setting_up_Line_Capacities_in_Preferences?_Shouldn't_aMule_only_care_for_the_Bandwidth_Limits?|What is the real point on setting up Line Capacities
in Preferences? Shouldn't aMule only care for the Bandwidth Limits?]] to understand why) and shouldn't happen anymore.

== Why is aMule ignoring the bandwith I set per slot? ==
The bandwidth set to each slot can be set in Preferences, but it will be ignored if the bandwidth set per slot doesn't allow at least three connections at the same time. 
So, the maximum speed allowed per slot is '''BandwidthLimit/3'''. 
Please do '''NOT''' confuse '''Bandwidth limit''' with '''Bandwith Capacity'''. Read [[FAQ_aMule#What is the real point on setting up Line Capacities in Preferences? Shouldn't aMule only care for the Bandwidth Limits?|What is the real point on setting up Line Capacities in Preferences? Shouldn't aMule only care for the Bandwidth Limits?]] since the meaning of the Bandwidth Capacity setting is not intuitive. 
Also, if [[aMule]] detects that, after having set all the slots for uploading, still some bandwidth is left before getting to the Bandwidth Limit, it will allow another slot and divide all the slot bandwidths to so use the same amount of bandwidth. 

Example: 
Bandwidth Limit: 7 KBps
Slot allocation: 2 KBps
When [[aMule]] sets the slots to some clients to upload to them, after giving out three slots, it will notice that tehre are no more 2KBps left, since the limit is 7 KBps, but there is still 1 KBps left in the bandwicth before reaching the Bandwidth Limit. So, It will allow another slot to upload to a client and, isntead of giving that last slot a 1 KBps bandwidth connection (and leave the rest with a 2 KBps bandwidth connetcion), it will give all four slots a 1.8 KBps bandwidth connection.

== Why can't I set aMule's download limit to more than X? ==
To keep the ED2K network alive, all ED2K clients have an upload/download limits ratio hardcoded which, depending on the upload limit set, is:

From 0KBps to 3KBps: 
DownloadLimit can't be more than UploadLimit*3 
From 4KBps to 9KBps: 
DownloadLimit can't be more than UploadLimit*4 
UploadLimit values over 9KBps: 
There's no DownloadLimit limitation.

Be carefull when setting 0KBps as Upload Limit . It might not mean what you think it is. Read [[AMule_problems#I_set_Upload_Limit_to_0KBps,_but_aMule_is_still_transfering._What_did_I_do_wrong?|I set Upload Limit to 0KBps, but aMule is still transfering. What did I do wrong?]] to make sure you understand it's meaning.

== I set Upload Limit to 0KBps, but aMule is still transfering. What did I do wrong? ==
Setting Upload limit to 0KBps will not stop transfers, instead, ''0'' value means '''unlimited''', so, it's right the opossite of you're trying to do. There's no way to stop aMule from uploading files, and that's the same on all ED2K clients (eMule, eDonkey, etc). Allowing people not to upload would bring the ED2K network to it's end. 
Even if you don't share any directory, the Temp directory will '''always''' be shared, so that files that you are downloading are shared with other clients.

== Why am I getting "Too many connections" messages on the terminal? ==
This happens when you set a very high value at Preferences -> Connections -> "Connection limits" -> "Max connections". If this value is as almost as big as the the amount of connections your system allows you to have, then aMule will fail to establish connections and display those messages (have in mind that other applications may also have some connections established). 
On Windows 9x/ME platforms there is a limit of 100 TCP connections so, although you might set aMule to establish more than 100 connections, it will be unable to do so. You can change Windows's TCP connections limit by editting the Windows Register ('''Start -> Run -> regedit.exe''') and setting (you'll most surely have to add the value since in most cases it doesn't exist): 
''HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\VxD\MSTCP\MaxConnections'' (which is a String type and it's value must be a 32-bit number).

== My progress bars have lost most of their 3D effect and look more ugly now. Can I turn its look back? ==
On old aMule versions (previous to 2.0.0-rc4) setting the progress bar style to the most right on Preferences -> "GUI tweaks" was the way to have the progress bar have the best 3D effect. As of 2.0.0-rc4 the best 3D effect is given when the style bar is set to the middle. Setting it to the most right will give the progress bar a flat look while setting it to the most left will give it a dark look.

== All my downloads suddenly paused and I can't resume them. What's going on? ==
Check if there's any free space in the filesystem where the Temp directory is placed. If there is any at all, check if there's more free space than the minimum free space set at Preferences -> Files -> "Min disk space".

== Why isn't Preview working at all? ==
Since aMule 2.0.0-rc4 Preview command isn't being run in the same terminal as aMule. As a result, your Preview program may fail to start. This is the case of MPlayer. If you need a terminal to run your Preview player, use some command like ''xterm -e <preview-app>'' i.e.: 
''xterm -T "aMule's preview" -iconic -e mplayer -idx''

== After exitting MPlayer on Preview, my aMule keeps locked? ==
Preview used to lock aMule on purpose until aMule reached version 2.0.0-rc4. As a result of this, people using MPlayer suffered from a bug on MPlayer which remains the main process in background when closing the main MPlayer window. The way to walk around this MPlayer bug on aMule versions previous to 2.0.0-rc4 is to exit MPlayer by pressing the '''Q''' key. Any way, it'd be better if you could possibly upgrade aMule to the latest versions.

== Why is ''Transfered'' a smaller number than ''Completed''? ==
It's a common mistake to think it should be bigger or, at least, equal. 
Please read [[FAQ_aMule#What_is_the_difference_between_Transfered_and_Completed_in_the_Tranfers_window?|What is the difference between Transfered and Completed in the Tranfers window?]] to know more about this.

== aMule always slows down my computer when it completes a download. Is this a normal behaviour? ==
Yes it is. When aMule completes a download it checks it has not been corrupted. Allthough this is already checked while downloading (by checking the chunk's hash values), once the file is completly downloaded aMule hashes all the chunks to check that the chunks which were previously downloaded weren't somehow corrupted by the user or an external application while the rest of the file was being downloaded.

== Is there any way to recursively select a whole directory and its contents? ==
Yes, there is. And it's simple:
*On [[aMule]] 2.0.0-rc4 or later, right-click the directory you want to recusively select.
*On [[aMule]] 1.x and up to 2.0.0-rc3 (included), while clicking on the directory, hold the CTRL key. 
And that's it.

== I downloaded a file and it got corrupted somehow by my hard disk or some external application once completed. Can I avoid redownloading the whole of it? ==
If you still have the [[ed2k_link|ed2k:// link]], start the download again and when a whole chunk (9.28MB) has been downloaded (any chunk), close [[aMule]], rename the corrupted file to the filename the current download has (something like ''002.part''), touch the corrupted file (i.e.: ''touch ~/.aMule/Temp/002.part*'') and restart [[aMule]]. 
[[aMule]] will detect the completed chunks and the corrupted ones, and will only download the chunks which got corrupted.