AMule Project FAQ - User contributions [en]

Translations

2010-04-18T14:01:51Z

Wuischke: /* Start a new translation */ Fix spelling error.

<center>
'''English''' |
[[Translations-cn|简体中文]] |
[[Translations-tw|正體中文]] |
[[Translations-de|Deutsch]] |
[[Translations-es|Español]] |
[[Translations-pt|Portugisisch]] |
[[Translations-ko_KR|Koreanisch]] |
[[Translations-ru|Russisch]]
</center>

== Introduction ==
Thanks for your interest in translating aMule. Becoming a translator isn't hard, you just need to understand common English and of course your native tongue.

The status of all translations are updated hourly at the [http://amule.sourceforge.net/translations/ Translation statistics page], that's an easy way to see if your work is needed. But you're always welcome to check an existing translation for errors or improve unfavourable expressions.

Before you start any work, please check [http://forum.amule.org/index.php?topic=13845.0 the translations list] for an entry for your language. If there's already someone working on the translation for your language, please reply to the forum topic for your language before you start working. It would be a shame to have two translators doing the same work, wouldn't it?
== Translate ==
=== Get Translation file ===
You can get current Portable Object (po) files for all supported languages at the [http://amule.sourceforge.net/translations/ Translation statistics page]. Just click on the name of your language and download the po-file.
==== Start a new translation ====
Your language isn't yet supported by aMule and you can't find a po-file at the statistics page? No problem, let's start a new translation! Either open a new topic in the [http://forum.amule.org/index.php?board=40.0 translations forum] to receive help with the translation process or create the po-file yourself:

To do so, please download the amule.pot file, which is linked at the bottom of the [http://amule.sourceforge.net/translations/ Translation statistics page]. Then you need [http://www.gnu.org/software/gettext/ gettext] installed on your system (comes by default with most operating systems) and the language code of your language. If you don't know the language code of your language, you should be able to find the code in the [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes list of language codes on Wikipedia]. If you've done so, use the following command to create the po-file:

msginit --input=amule.pot --locale=''language code''

If you decide to create your own po-file, please have a look at the [[Translations#Plural_forms|Plural forms]] section of this page.

=== The translation process ===
Now that you've got the po-file, let's start with the actual translation process. There are several programs to help you with this task, like [http://www.poedit.net Poedit], [http://gtranslator.sourceforge.net/ gtranslator] or [http://kbabel.kde.org KBabel], but you can use your favourite text editor, too.

Here's a quick start for these editors, please refer to their respective home pages for a more extensive documentation.
==== Poedit ====
When you open a po-file in Poedit, you are greeted by a screen similar to the following:

http://img516.imageshack.us/img516/481/wikipoedit1ly7.png

In the bottom, you'll find statistics. Not translated strings are marked in shades of turquoise in the string list in the upper part, [[Translations#fuzzy_strings|fuzzy strings]] in brown-sand tones and translated strings in grey/white.

The actual translation takes part in the middle part of the window.

http://img253.imageshack.us/img253/5157/wikipoedit2ov3.png

You'll see the English source string at the top and the field to enter the translations below. Here's even a special case with plural forms. When you're done entering the translated page for one string you can go on by clicking on the next string to translate.

When you're done translating, continue with testing your translation.
==== KBabel ====
Another powerful editor is the KDE-based KBabel.

http://img512.imageshack.us/img512/3183/wikikbabel1my7.png

The user interface is customizable, but in the default view, you'll find the string list, the source string and the input field for translations on the left side. Statistical information are on the bottom, just as with Poedit.

http://img329.imageshack.us/img329/607/wikikbabel2fz0.png

By clicking on the ''Next [[Translations#fuzzy_strings|Fuzzy]] or Untranslated''-button in the toolbar, KBabel will jump directly to the next string in need of some work.

http://img329.imageshack.us/img329/9992/wikikbabel3uw7.png

The actual translation interface is very similar to Poedit, in the upper part you'll see the source string and below you can enter the translation.

==== Using a text editor ====
po-files are just text files and of course you can use any text editor to edit them. Popular editors Emacs and Vim both provide corresponding plugins.

The file format is pretty simple, but please refer to the [http://www.gnu.org/software/gettext/manual/gettext.html#PO-Files section in the gettext manual] for further information.

=== Test the translation ===
Use the following command to test a translation:

msgfmt -c --statistic ''language code''.po

Example output:

$ msgfmt -c --statistics ca.po
1428 translated messages, 58 [[Translations#fuzzy_strings|fuzzy]] translations, 32 untranslated messages.

Please refer to the [[Translations#Common_problems|Common problems]] section if any error messages appear. Don't hesitate to attach your po-file in the [http://forum.amule.org/index.php?board=40.0 translations forum] and ask for help, if you can't solve the problems yourself. I'll try to fix the problems and explain what went wrong.

=== Getting the translation into aMule ===
Find your language in [http://forum.amule.org/index.php?topic=13845.0 the translations list] and attach the po-file in a new reply to your language's topic (click on the language name to go to your language's topic).

If you can't find a topic for your language, just create a new one in the [http://forum.amule.org/index.php?board=40.0 translations forum].

== Common problems ==
=== fuzzy strings ===
Strings are marked fuzzy after a change of the source string of an already translated string. This just means that the translator should review the string and see if the change has any influence on the translation.

An example: "Delete server?" was replaced by "Do you really want to remove the server?". The content is the same and only the wording was changed. Depending on the translation there may be no changes necessary.
=== message compilation errors ===
After testing the translation, you get an error message. Here's a list of common errors and the solution:
* ''end-of-line within string''
** A string started by " (quotation marks) wasn't closed by another ". Take a look at the line number and close the string.
* ''format specifications in 'msgid' and 'msgstr' for argument 1 are not the same''
** You've probably noticed things like '%s' or '%d' in the source strings. These are later replaced by a variable, for instance a string for %s and an number for %d. Please check all your %-constructs in the translated string (use the line number in the error message to find the string) and see if they are the same as in the source string.
* ''number of format specifications in 'msgid' and 'msgstr' does not match''
** This is similar to above error. You don't have the same quantity of %-constructs in the source and translation. Check the translation, maybe you've forgotten one or you accidentally wrote '&s' when you meant '%s'
* ''`msgid' and `msgstr' entries do not both end with '\n'''
** '\n' is a new line in a string. You need the same number of new lines in the translation as in the source. Try to place them similar to the source string.

=== Plural forms ===

Plurals are handled differently in various languages. Whilst English or German have a singular and a plural form, other languages like Turkish don't distinguish between plural or singular and there are languages which use different plurals for different numbers, e.g. Polish.

The first thing you need is the appropriate header in your po-file. You'll find help in the [http://www.gnu.org/software/gettext/manual/gettext.html#Plural-forms gettext manual on plural forms] or the [http://translate.sourceforge.net/wiki/l10n/pluralforms list of plural forms]. If you have trouble to add the header, please ask in the [http://forum.amule.org/index.php?board=40.0 translations forum].

An example for German:

"Plural-Forms: nplurals=2; plural=n != 1;\n"

Plural forms are represented in the source as follows (extract from de.po for German):

#: src/kademlia/routing/RoutingZone.cpp:141
#, c-format
msgid "Read %u Kad contact"
msgid_plural "Read %u Kad contacts"
msgstr[0] "Lese %u Kad-Kontakt"
msgstr[1] "Lese %u Kad-Kontakte"

The first ''msgid'' is the source for the singular, the ''msgid_plural'' is the plural source. Note the index ''msgstr'' gets for plural strings. Each index is for a different plural form. In the case of German ''msgstr[0]'' is the singular string and ''msgstr[1]'' is used for plural forms.

This is similar for other languages. If you are in doubt about which index corresponds to which plural form, please ask in the [http://forum.amule.org/index.php?board=40.0 translations forum].
=== my program doesn't allow me to jump to a line ===
kpeace1 wrote a [http://forum.amule.org/index.php?topic=14699.msg77946#msg77946 script] which converts line numbers in error messages to msgids and makes easier.
#!/usr/bin/env python

import sys

if (len(sys.argv) < 3):
print "usage:\t", sys.argv[0], "file_name ", "line#"

file_name = sys.argv[1]
line_number = int(sys.argv[2])

po_file = open(file_name)
i = 0
msgid = 0

for line in po_file:
i = i + 1
if (line[:5] == "msgid"):
msgid = msgid + 1

if (line_number == i):
print "error in msgid no.", msgid-1
sys.exit(0)

MediaWiki:Titleblacklist

2009-08-05T17:09:58Z

Wuischke: Maybe I should think about the syntax next time before writing stuff down...

# This is a title blacklist. Titles and users that match a regular expression here cannot be created.
# Use "#" for comments.
# This is case insensitive by default

\d\d\d buy.* #Disallow creation of spam users with names like "803 buy ''something''"

MediaWiki:Titleblacklist

2009-08-03T05:31:11Z

Wuischke: Formatting

# This is a title blacklist. Titles and users that match a regular expression here cannot be created.
# Use "#" for comments.
# This is case insensitive by default

[\d\d\d] buy.* #Disallow creation of spam users with names like "803 buy ''something''"

MediaWiki:Titleblacklist

2009-08-03T05:30:23Z

Wuischke: Add regex filter for Spam users

AMule problems

2009-07-24T06:39:42Z

Wuischke:

<center>
'''English''' |
[[AMule_problems-de|Deutsch]] |
[[AMule_problems-es|Español]] |
[[AMule_problems-hu|Magyar]] |
[[AMule_problems-it|Italiano ]] |
[[AMule_problems-nl|Nederlands]]
</center>

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

On a Macintosh downloads are in ''~/Library/Application Support/aMule/Incoming'' and Windows users can find downloads in the folder ''aMule downloads'' in their user folder.

== 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 contained a special character. If this is your problem, there's a workaround (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.

== Why does it happen that sometimes aMule suddenly has no/few servers in is server list? ==
You probably have enabled the options Preferences -> Servers -> "Remove dead server after X retries" and Preferences -> Connection -> "Reconnect on loss".

If so, most probably you lost internet (or lan, etc) connection for a period of time so aMule noticed it was not connected to the ed2k server anymore and went trying to connect to other servers until all servers were removed (after trying X times each).

To solve this problem, disable the "Remove dead server after X retries" option. Disabling the option "Remove dead server after X retries" is safe in most cases. You most probably don't want to disable the "Reconnect on loss" option, so keep it enabled.

== aMule connects to server, but it is always given Low-ID. Why? and, can I do something about it? ==
This can bue due to three reasons:
*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.
*The server is very busy or maybe badly configured, so it's giving you a [[Low ID|Low-ID]]. There's nothing that can be done in this case other than reconnect or connect to some other server.
*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.

== [[aMule]] was interrupted while completing a file and it is now never completing it (although 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 any way 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).<br>
Two things may have happened. Either *.part.met files were deleted, or *.part files were deleted.

If *.part files have disappeared, the only solution is to restart the downloads from the beginning (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 disappeared 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/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 were downloading ''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 mysteriously disappeared. 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 suddenly 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 until 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 although 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 will 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 shouldn't worry about them.

== What should I do if I lose my ''cryptkey.dat'' file? ==
Losing this files means you lose all of your credits. Sorry. Since you'll need to start building credits up again, you'll need to delete ''~/.aMule/preferences.dat'' or you'll not be able to collect credits on [[client|clients]] who have previously identified you (prior to losing cryptkey.dat).

== 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 bandwidth 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 '''Bandwidth 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 there are no more 2KBps left, since the limit is 7 KBps, but there is still 1 KBps left in the bandwidth before reaching the Bandwidth Limit. So, it will allow another slot to upload to a client and, instead of giving that last slot a 1 KBps bandwidth connection (and leave the rest with a 2 KBps bandwidth connection), 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:
*<u>From 0KBps to 3KBps:</u>
*DownloadLimit can't be more than UploadLimit*3
*<u>From 4KBps to 9KBps:</u>
*DownloadLimit can't be more than UploadLimit*4
*<u>UploadLimit values over 9KBps:</u>
*There's <b>no</b> DownloadLimit limitation.

Be careful 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_transferring._What_did_I_do_wrong?|I set Upload Limit to 0KBps, but aMule is still transferring. What did I do wrong?]] to make sure you understand it's meaning.

== I set Upload Limit to 0KBps, but aMule is still transferring. What did I do wrong? ==
Setting Upload limit to 0KBps will not stop transfers, instead, ''0'' value means '''unlimited''', so, it's right the opposite 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 its 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 editing 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? ==
In most aMule versions setting the progress bar style to the most right on Preferences -> "GUI tweaks" is the way to have the progress bar have the best 3D effect. But in versions 2.0.0-rc4 to 2.0.0-rc6 the best 3D effect is given when the style bar is set to the middle. Setting it to the most right would 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".

The minimum free space required for [[aMule]] is 9.28MB, since that's what [[aMule]] needs to be able to download a [[FAQ_eD2k-Kademlia#What_is_a_chunk?|part]] of a file.

== Why can't I preview a file? ==
First of all you must know that [[aMule]] only allows to preview video files.

To be able to preview a file [[aMule]] requires two things:
*The file must have a known video extension in its filename
*You must have downloaded the first 256KBs of the file

Anyway, sometimes it happens that the file is previewable though [[aMule]] doesn't allow you. In that case, go to the Temp directory and preview them manually, if you can and wish.

== Why isn't [[aMule]]'s Preview working at all with MPlayer? ==
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 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_Transfers_window?|What is the difference between Transfered and Completed in the Transfers 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. although this is already checked while downloading (by checking the chunk's hash values), once the file is completely 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 on the icon of the directory you want to recursively 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.

== What should I be aware of when using NFS mounts with [[aMule]]? ==
When using NFS mounts with [[aMule]], make sure you unmount those NFS mounts (the ones from the computer being shut down) from the computer running [[aMule]] because, otherwise, [[aMule]] will simply hang until those mounts are back up again. How to notice this? If you leave [[aMule]] running at night, and on the next day you go to the stats and see straight lines for [[Download]]/[[Upload]]/[[Connect]]ions stats (non-zero) and after mounting those NFS mounts, those straight lines drop to zero resuming normal behaviour, that is a sign. Plus, after unmouting the NFS mounts from any computer being shut down, '''reload''' [[aMule]]'s shared files.

''I noticed all this from my frustrating experience of countless days with no downloads at night ;) ... --[[User:PedroAlgarvio|PedroAlgarvio]] 00:25, 15 Jun 2005 (CEST)''

== Downloaded files don't get the permissions I set in Preferences. Why? ==
aMule must follow the permissions it is allowed to set by ''umask''. ''umask'' sets the permissions which applications should '''not''' be allowed to assign files.

Therefore, if you set, for example, file permissions to ''664'' in aMule's Preferences, and umask's value (check it by running ''umask'') is ''022'', aMule will create files with permissions ''644'' (that is, ''664'' - ''022'' = ''644'').

== aMule fails to create files/shows file descriptor errors. What's going on? ==
This should never happen. If it happens chances are you have the resources limits very low, so aMule is denied to create/open new files. Run ''ulimit -a'' to check your resources limits. Read ''man ulimit'' to learn how to set the limits as you want them, and remember that this has to be set on every system restart (probably your distribution provides a configuration file which sets this automatically).

How to uninstall wxWidgets

2009-07-22T07:52:39Z

Wuischke: Also remove headers in the dirty way.

<center>
'''English''' |
[[How_to_uninstall_wxWidgets-de|Deutsch]] |
[[How_to_uninstall_wxWidgets-es|Español]]
</center>

== Removing packages ==

If you installed [[wxWidgets]] through your distro's packages ([http://www.rpm.org rpm], [http://www.debian.org deb], [http://www.slackware.com tgz], [http://www.gentoo.org ebuild]...) just uninstall it normally.

== Uninstalling from sources ==

If you compiled [[wxWidgets]] on your own, go to the sources directory and run ''make uninstall'' (as '''root''').<br>
If you deleted the sources directory, you can download it again, run ''configure'' and then run ''make uninstall'' (again, as '''root''').

== Forcing [[wxWidgets]] out of the system ==

Last, the quick'n'dirty [[User:deltaHF|deltaHF (TM) ]] way (only to be used if the above two failed):

''<pre>
rm -f /usr/bin/wx*
rm -r /usr/include/wx*
rm -r /usr/lib/wx
rm -f /usr/lib/libwx*
rm -f /usr/local/bin/wx*
rm -r /usr/local/include/wx*
rm -r /usr/local/lib/wx
rm -f /usr/local/lib/libwx*
ldconfig
</pre>''

AMule problems

2009-07-19T19:43:49Z

Wuischke: Add download folder information for Mac and Win

<center>
'''English''' |
[[AMule_problems-de|Deutsch]] |
[[AMule_problems-es|Español]] |
[[AMule_problems-hu|Magyar]] |
[[AMule_problems-it|Italiano ]] |
[[AMule_problems-nl|Nederlands]]
</center>

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

On a Macintosh downloads are in ~/Library/Application Support/aMule/Incoming and Windows users can find downloads in the folder "aMule downloads" in their user folder.

== 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 contained a special character. If this is your problem, there's a workaround (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.

== Why does it happen that sometimes aMule suddenly has no/few servers in is server list? ==
You probably have enabled the options Preferences -> Servers -> "Remove dead server after X retries" and Preferences -> Connection -> "Reconnect on loss".

If so, most probably you lost internet (or lan, etc) connection for a period of time so aMule noticed it was not connected to the ed2k server anymore and went trying to connect to other servers until all servers were removed (after trying X times each).

To solve this problem, disable the "Remove dead server after X retries" option. Disabling the option "Remove dead server after X retries" is safe in most cases. You most probably don't want to disable the "Reconnect on loss" option, so keep it enabled.

== aMule connects to server, but it is always given Low-ID. Why? and, can I do something about it? ==
This can bue due to three reasons:
*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.
*The server is very busy or maybe badly configured, so it's giving you a [[Low ID|Low-ID]]. There's nothing that can be done in this case other than reconnect or connect to some other server.
*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.

== [[aMule]] was interrupted while completing a file and it is now never completing it (although 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 any way 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).<br>
Two things may have happened. Either *.part.met files were deleted, or *.part files were deleted.

If *.part files have disappeared, the only solution is to restart the downloads from the beginning (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 disappeared 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/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 were downloading ''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 mysteriously disappeared. 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 suddenly 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 until 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 although 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 will 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 shouldn't worry about them.

== What should I do if I lose my ''cryptkey.dat'' file? ==
Losing this files means you lose all of your credits. Sorry. Since you'll need to start building credits up again, you'll need to delete ''~/.aMule/preferences.dat'' or you'll not be able to collect credits on [[client|clients]] who have previously identified you (prior to losing cryptkey.dat).

== 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 bandwidth 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 '''Bandwidth 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 there are no more 2KBps left, since the limit is 7 KBps, but there is still 1 KBps left in the bandwidth before reaching the Bandwidth Limit. So, it will allow another slot to upload to a client and, instead of giving that last slot a 1 KBps bandwidth connection (and leave the rest with a 2 KBps bandwidth connection), 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:
*<u>From 0KBps to 3KBps:</u>
*DownloadLimit can't be more than UploadLimit*3
*<u>From 4KBps to 9KBps:</u>
*DownloadLimit can't be more than UploadLimit*4
*<u>UploadLimit values over 9KBps:</u>
*There's <b>no</b> DownloadLimit limitation.

Be careful 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_transferring._What_did_I_do_wrong?|I set Upload Limit to 0KBps, but aMule is still transferring. What did I do wrong?]] to make sure you understand it's meaning.

== I set Upload Limit to 0KBps, but aMule is still transferring. What did I do wrong? ==
Setting Upload limit to 0KBps will not stop transfers, instead, ''0'' value means '''unlimited''', so, it's right the opposite 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 its 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 editing 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? ==
In most aMule versions setting the progress bar style to the most right on Preferences -> "GUI tweaks" is the way to have the progress bar have the best 3D effect. But in versions 2.0.0-rc4 to 2.0.0-rc6 the best 3D effect is given when the style bar is set to the middle. Setting it to the most right would 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".

The minimum free space required for [[aMule]] is 9.28MB, since that's what [[aMule]] needs to be able to download a [[FAQ_eD2k-Kademlia#What_is_a_chunk?|part]] of a file.

== Why can't I preview a file? ==
First of all you must know that [[aMule]] only allows to preview video files.

To be able to preview a file [[aMule]] requires two things:
*The file must have a known video extension in its filename
*You must have downloaded the first 256KBs of the file

Anyway, sometimes it happens that the file is previewable though [[aMule]] doesn't allow you. In that case, go to the Temp directory and preview them manually, if you can and wish.

== Why isn't [[aMule]]'s Preview working at all with MPlayer? ==
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 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_Transfers_window?|What is the difference between Transfered and Completed in the Transfers 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. although this is already checked while downloading (by checking the chunk's hash values), once the file is completely 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 on the icon of the directory you want to recursively 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.

== What should I be aware of when using NFS mounts with [[aMule]]? ==
When using NFS mounts with [[aMule]], make sure you unmount those NFS mounts (the ones from the computer being shut down) from the computer running [[aMule]] because, otherwise, [[aMule]] will simply hang until those mounts are back up again. How to notice this? If you leave [[aMule]] running at night, and on the next day you go to the stats and see straight lines for [[Download]]/[[Upload]]/[[Connect]]ions stats (non-zero) and after mounting those NFS mounts, those straight lines drop to zero resuming normal behaviour, that is a sign. Plus, after unmouting the NFS mounts from any computer being shut down, '''reload''' [[aMule]]'s shared files.

''I noticed all this from my frustrating experience of countless days with no downloads at night ;) ... --[[User:PedroAlgarvio|PedroAlgarvio]] 00:25, 15 Jun 2005 (CEST)''

== Downloaded files don't get the permissions I set in Preferences. Why? ==
aMule must follow the permissions it is allowed to set by ''umask''. ''umask'' sets the permissions which applications should '''not''' be allowed to assign files.

Therefore, if you set, for example, file permissions to ''664'' in aMule's Preferences, and umask's value (check it by running ''umask'') is ''022'', aMule will create files with permissions ''644'' (that is, ''664'' - ''022'' = ''644'').

== aMule fails to create files/shows file descriptor errors. What's going on? ==
This should never happen. If it happens chances are you have the resources limits very low, so aMule is denied to create/open new files. Run ''ulimit -a'' to check your resources limits. Read ''man ulimit'' to learn how to set the limits as you want them, and remember that this has to be set on every system restart (probably your distribution provides a configuration file which sets this automatically).

Firewall

2009-07-19T19:27:07Z

Wuischke:

<center>
'''English''' |
[[Firewall-de|Deutsch]] |
[[Firewall-es|Español]]
</center>

== Routers ==
Here is a list of routers and how to set them up to forward their ports to [[aMule]].

In the descriptions below, examples are using the default ports (that is, ''4662'' for the [[Standard client TCP port]], ''4672'' for the [[Extended client UDP port]] and ''4665'' for the [[Extended server requests UDP port]].

=== Linksys WRT54GSV4 ===
#Open your web browser, ''http://192.168.1.1'' and log into it
#Go under ''Gaming applications''
#Now forward the ports to your computer:
##[[Standard client TCP port]]
###Change both ''Ports start'' and ''End'' to ''4662''
###In the next field set ''TCP''
###In the field, the last 3 digits of your LAN [[IP address|IP]]
##[[Extended client UDP port]]
###Change both ''Ports start'' and ''End'' to ''4672''
###In the next field set ''UDP''
###In the field, the last 3 digits of your LAN [[IP address|IP]]
##[[Extended server requests UDP port]]
###Change both ''Ports start'' and ''End'' to ''4665''
###In the next field set ''UDP''
###In the field, the last 3 digits of your LAN [[IP address|IP]]
#Now check ''Enable''
#And click ''Save settings''
#Then restart aMule :)

=== [http://www.linksys.com Linksys] Router configuration ===
This portion of the wiki applies only to stock versions of the [http://www.linksys.com Linksys] firmware. If you are using a [http://www.linksys.com Linksys] router running a variant of the [[GPL]] code, please follow the guides directly above as you are most likely using iptables.

Log into your [http://www.linksys.com Linksys] router. After successfully logging in, click on the main menu link labeled '''Applications & Gaming''' after which you should see an additional submenu list for this section. Make sure you are under the correct submenu by clicking '''Port Range Forwarding'''.

At this point, you should see a table with 6 columns. The columns are: ''Application'', ''Start to'', ''End'', ''Protocol'', ''IP Address'', ''Enable''.

'''The Application column'''<br>
Friendly name for the service. Put anything you want here, [[aMule]] being suggested.

'''The Start to -> End column'''<br>
Start and end ports. '''Start to''' should be ''4662'' but, in the end, this should reflect whatever port you have defined in [[aMule]] ''Preferences'' -> ''Connection'' -> ''Client TCP Port''. '''End''' should be ''4672'' but, in the end, this should reflect whatever port you have defined in [[aMule]] ''Preferences'' -> ''Connection'' -> ''eMule extended UDP Port''.

I suggest using 2 separate entries for each port unless this is not possible.

'''The Protocol column'''<br>
Protocol to listen for. If you use one line to open your [[aMule]] ports, set this option to '''Both'''. If you use a separate entry line for each, select option '''TCP''' for [[FAQ_eD2k-Kademlia#What_does_each_port_do?|Client TCP Port]] and option '''UDP''' for [[eMule]] [[FAQ_eD2k-Kademlia#What_does_each_port_do?|extended UDP Port]].

'''The IP Address column'''<br>
Internal [[IP address]] to forward requests to. This is typically the internal (private) [[IP address]] of the computer that will use [[aMule]].

'''The Enable column'''<br>
Enable rule. You'll need to check this in order to enable your [[aMule]] rules.

After adding your rule, make sure you save your settings. You can verify whether your rules work by [http://www.amule.org/testport.php testing your ports].

=== [http://www.dlink.com DLink] Router configuration ===
Log in to your [http://www.dlink.com DLink] router. There are three steps to take to enable your [[aMule]] [[port]]s.

'''IP Address setup'''

In the Home tab, click the DHCP button. This page displays the current [[IP address]]es assigned by the router, both static and dynamic. Look for the name or MAC address of the computer you'll be running [[aMule]] on. If your computer is receiving dynamically assigned [[IP address]]es, you will have to change your settings every so often if your [[IP address]] changes. To avoid this, use the Static DHCP section, and perform the following steps:

*'''Name''': Type in the name of your computer here, could be anything
*'''IP''': The [[IP address]] you want the router to always assign to your computer
*'''MAC Address''': The MAC address of your computer. You should be already connected to the router, so you can find your computer in the ''DHCP Client'' drop-down menu, and click clone, to populate this number
*Click ''Apply''

Now your computer will always receive the same [[IP address]].

Now click on the ''Advanced'' tab, and there are two areas that need to be updated:

'''Virtual Server'''
*Click the ''Virtual Server'' button. This page forwards external requests to a specific internal [[IP address]] in your network
*Click ''Enabled''
*Enter a name in the ''Name'' entry box, eg ''aMule TCP''
*Enter your static [[IP address]] in the ''Private IP'' box
*Select [http://www.ietf.org/rfc/rfc793.txt TCP] in ''Protocol type''
*Private [[port]] is the [[port]] that the router will forward the requests to on your computer. This can be anything, a good value is the default [[aMule]] [http://www.ietf.org/rfc/rfc793.txt TCP] [[port]], ''4662''
*Public [[port]] is the [[port]] that the router will receive requests on. Again, a good value is the [[aMule]] [http://www.ietf.org/rfc/rfc793.txt TCP] [[port]] of ''4662''
*Schedule is the times at which the port is open. Select ''Always'', or whatever times you wish
*Click ''Apply''

'''Applications'''
*Click the ''Applications'' button. This page allows you to enter a range of [[port]]s to open for application usage
*Click ''Enabled''
*Enter the [http://www.ietf.org/rfc/rfc793.txt TCP] [[port]] in the first ''Trigger Port'' box, a good value being ''4662''
*Select ''Trigger Type'' as [http://www.ietf.org/rfc/rfc793.txt TCP]
*In ''Public Port'', enter the range from your [[aMule]] [http://www.ietf.org/rfc/rfc793.txt TCP] [[port]] to your [[aMule]] [http://www.faqs.org/rfcs/rfc768.html UDP] [[port]], usually ''4662''-''4672''
*Select ''UDP'' as the ''Public Type''
*Click ''Apply''

You should now be all set, assuming that your computer firewall is setup to allow access on the selected [[port]]s.

'''Alternate Configuration (ie instead of Applications) for D-Link '''
*Go back to virtual server and set 2 other virtual servers for the UDP ports
(It works only that way on my D-Link DI-804HV)

*Virtual server aMuleUDP4665 - select your IP address and UDP and 4665 (port)

*Virtual Server aMuleUDP4672 - select your ip address and UDP and 4672 (port)

(disable the above amule applications if you did try and it do not work).
Then you shoudl have all arrows green ( and 3 virtual servers running for amule, 1 for TCP and 2 for UDP).

'''Another Alternate Configuration (using Firewall rules) for D-Link (tested on D-Link DI-624) '''
*Click on ''Advanced'' tab then click on ''Firewall''. This page can be used to setup firewall rules directly '''Without ANY further settings in ''Virtual server'' or ''Applications'' tabs'''

*Click ''Enabled''

*Enter your preferred name for the rule (must be unique)

*Select ''WAN'' as source interface and ''*'' for source IP Range Start (IP Range End can be left blank)

*Select ''LAN'' as destination interface and enter the static IP of your PC running aMule for destination IP Range Start (IP Range End can be left blank)

*Select ''*'' as destination protocol

*Enter ''4662-4672'' as destination port range

*Select your preferred scheduling

*Click apply

'''IMPORTANT NOTE''': disable all existing entries for aMule you may have specified in ''Virtual server'' or ''Applications'' tabs.

*Reboot your router to be sure new configuration is applied (''Tools'' -> ''Misc'').

=== Netgear router ===
First, go to your router control page, locate at [http://routerlogin.net/start.htm http://routerlogin.net/start.htm]. Then, on the left side of the screen, under the Advanced group of options, click "Port Forwarding/Port Triggering." Click the "Add Custom Service" button, name it aMule1 (or whatever), set it as a TCP-only forwarding, with the starting and ending port being 4662 and the server IP address being whatever local address you're using (probably 192.168.1.2, if you're the only one connected to the router, but check), and click Apply. Repeat the process with aMule2 and aMule 3, using UDP-only ports for both and starting and ending ports of 4665 and 4672, respectively. (That is, the same starting and ending port within aMule2 and aMule3, but aMule2=4665 and aMule3=4672.) Make sure that iptables is properly set up on the machine which will run aMule (as above), and you're done.

Not all Netgear routers are the same, evidently, because on the DG834G it's more complicated. Go to the router's configuration page:
# Select '''Services''' from the '''''Content Filtering''''' menu
# Add your three rules (1 x TCP, 2 x UDP) based on your aMule Connection preferences
# Select '''Firewall Rules''' from the same menu
# Add all three rules as ''Inbound Services''
# Add both UDP rules as ''Outbound Services'' (only one of these is crucial but I add the other just in case)

=== TRENDnet router TW100 ===
First connect to your router: usually open a browser and type directly the router IP address: such as 192.168.0.1 (or 192.168.1.1), then the login box should appear ( depending on your router config) - if so answer the message log message with ‘admin’ as username and nothing as password (or you password if
you did set one).

Then On the left side Menu, Select Internet and thenselect Advanced Setup (Advanced Internet). Then click/select, [Special Applications]:

Add or replace 2 lines in the Special Applications list:
(Try not to remove something which you are using and which is already enabled)
(just add the new application for amule at the end in position Nr. 5 or Nr.6 in the list for example):

Create the entries as follows:

amuleU4665 TCP-4665-4665 UDP-4665-4665

amuleU4672 TCP-4672-4672 UDP-4672-4672 )

(In my Application List the “amuleU4665” and “amule4672” are in Nr1 and Nr2 but it can be in any position in your list).

->Click on the small box [ ] on the left for both lines of your amuleUxxxx applications to enable the special applications to work!

Then click on [Save], then click on [Close]

Then click on [Save] again on the page – Advanced Internet .

The next and last step is to click on the “Virtual Servers” menu on the left side, then the “Virtual Server page will appear”:

Add a new virtual server named like: AmuleTCP

Select your computer* IP Address: in the DropDown Menu

Select: TCP

Write the 4662 Port and 4662 port (both fields the same port)

Then [Add as new server]

Then you are set to have High ID and Kad ON. Finished with the Low-ID, yellow arrows and Kad Firewalled. Now all you arrows should be green and you should have access to Kad and ed2K.

''Important Note:''
*Be careful in the case that your computer is using the DHCP protocol (ie to obtain IP address from the router).
The router might not give all the time the same IP address to your computer.
(normally it does so... but sometimes it can change).
You have two solutions if you see that you have a low- ID then: (2 solutions)

1) log back to the router go back to the virtual server, select the amuleTCP virtual server that you created and just reselect you computer in the “PC(server)” entry box. And select [Update this server] and log out. It should do the job.

Or an alternative solution :

2)You can Set-up your computer with a fixed IP address if you want. If this problem of low-ID happens too often because you DHCP router gives different IP address to your computer, then you can put your computer in static mode or DHCP reserved address. But you need to know your DNS server(s) before to do that – so check with your ISP which are your DNS servers. Then configure your computer to run with a fixed DHCP/ Static address / Manual Address (name depends what OS you are running). For that go to your network settings and put the P address you want, and the gateway (you router IP address) and the DNS from your ISP – All this to be done ion the Other / PC Database (Admin) page of the router.

'''In the case that your TRENDNet router crashes or stop forwarding any''' traffic from/to your aMule computer . (it happened to me), then :

- reduce the Connection limit (in Preferences->Connection) to 100 (or to 50)
- reduce the "Max new connections / 5 secs" (in Preferences->Core Tweaks) to 10 (or to 5)
Stop amule and restart aMule so that configuration will be validated.

Make some tests to find your best config. It should give more stability to your router and avoid your router to crash ( ie you would have to reset and/or turn it on and off). This might be true for other routers as well(?).

''(TRENDnet Firewall from RFV - --[[User:Robert364|Robert364]] 17:05, 5 Nov 2006 (CET))
''

=== OpenBSD ===
The firewall that comes with OpenBSD is called packetfilter (pf). To get aMule running, you must add the following rules to your pf.conf (/etc/pf.conf):

# aMule TCP and UDP
rdr pass on egress proto tcp to port 4662 -> IPADDR
rdr pass on egress proto udp to port 4672 -> IPADDR
rdr pass on egress proto udp to port 4665 -> IPADDR

IPADDR is the internal ip-address of the computer in your network that runs aMule.
Pf guesses automatically the name of the outter interface (connected with the internet), thanks to the keyword "egress" (this means: "the interface where goes the default route", and it's updated dynamicaly in case of change).<br>

Example (IP of computer running aMule is '''192.168.1.10'''):

# aMule TCP and UDP
rdr pass on egress proto tcp to port 4662 -> '''192.168.1.10'''
rdr pass on egress proto udp to port 4672 -> '''192.168.1.10'''
rdr pass on egress proto udp to port 4665 -> '''192.168.1.10'''

Of course, the computer running aMule must also have access to the internet so add the following rules too:

nat on egress from IPADDR to any -> (egress)

IPADDR is the internal ip-address of the computer in your network that runs aMule.

Example (like above):

nat on egress from '''192.168.1.10''' to any -> (egress)

To activate the changed configuration, reboot or execute the following command:<br>

pfctl -f /etc/pf.conf

In order to have the firewall automatically loaded at boot :

echo PF=yes >> /etc/rc.conf.local

To give KAD a better connection than "firewalled" put the following at the beginning of the NAT section of pf.conf (because NAT rules work on the first matching rule in the list, unlike the rest of pf.conf):

no nat on egress proto udp from '''192.168.1.10''' port 4672 to any

See [[FAQ eD2k-Kademlia#Why does Kademlia still say it is firewalled?|the FAQ]] on "Why does Kademlia still say it is firewalled?"

== My router is not here? ==

If You have another type of router, check the correct A-Mule (or E-Mule) NAT-settings for Your modell on this site: http://www.portforward.com/

User:Ohdear

2009-07-19T18:44:30Z

Wuischke: Created page with 'Ohdear is a Spam fighter extraordinaire and a very valuable user. - wuischke'

Ohdear is a Spam fighter extraordinaire and a very valuable user. - wuischke

Main Page

2009-07-19T09:23:11Z

Wuischke:

__NOTOC__
{| width="100%"
| align="center" |

<h1>Welcome to the [http://wiki.org/wiki.cgi?WhatIsWiki Wiki] of the [[aMule|aMule Project]]</h1>

{| align="center" width="100%"
| 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]] | [[Main_Page-de|Deutsch]] | [[Main Page-fr|Français]] | [[Main Page-ru|Russian]] | [[Main Page-it|Italiano]] | [[Main Page-pl|Polish]] | [[Main Page-tw|正體中文]]</h3>
|}
|-
| align="left" |
{| width="100%"
| valign="top" |
== Usage ==
* Help [[Getting_Started|Getting Started With aMule]]
* Help [[aMule_problems|Common problems]]
* Help [[Mac specific usage]]
* Help [[aMule is slow]]?
* Help [[aMule makes everything slow]]?
* Info [[aMule files|aMule's files]]
* Info [[Fake servers]]

== Information about aMule ==
* About [[AMule|aMule's features]]
* aMule [[requirements]]
* [[FAQ_utils|aMule's utilities]]
* [[skins|Skin support]] in aMule
* Watch the [[Releases|release graphs]]
* [[Changelogs]]
* aMule's Licence: [[GNU_FDL|GNU General Public License]]

== aMule Wiki and forum ==
* Our [[forum rules]]
* Our [[IRC rules]]
* HOWTO [[aMule:Help|Edit a Wiki page]]
* [[Wiki reorganization]]

== FAQs ==
* FAQ [[FAQ_aMule|on aMule]]
* FAQ [[FAQ eD2k-Kademlia|on ED2K-Kademlia]]
* FAQ on the [[FAQ_network|Transfer Rates on the eDonkey Network]]

| width="10px" | ||
| valign="top" |

== Installation and Setup ==
* HOWTO [[Compile|Compile and Install aMule]]
* HOWTO [[Migrate from eMule to aMule]]
* HOWTO [[Ed2k links handling|Handle ed2k:// links]]
* HOWTO [[import-export files|Import and export files]]
* HOWTO [[Get HighID]]
* HOWTO [[Firewall|Setup firewall rules for aMule]]
* HOWTO [[Keep a safe list of servers]]
* HOWTO [[aMuleWeb|Setup aMule's Webserver (aMuleWeb)]]
* HOWTO [[test port|Test your ports]]

== Development ==
* Download the latest [[aMule SVN]]
* HOWTO [[Backtraces|Create useful backtraces]]
* HOWTO [[Using gdb and valgrind|Use GDB and Valgrind]]
* HOWTO [[Using_another_wxinstall|Use more than one wxWidgets]]
* HOWTO [[Bug report|Report a bug]]
* About the [[aMule_devs|aMule Development Team]] and [[aMule_devs#Helping|joining it]]
* Documentation of the [[EC_Procotol_HOWTO|EC protocol]]
* Rules of [[Coding Style|coding style]]
* Running a [[testing field]]

== Translations ==
* HOWTO [[Translations|Translate aMule into your native language]]
* HOWTO [[Translating Wiki|Translate this Wiki]]

|}
|}

Main Page

2009-07-17T14:06:45Z

Wuischke: Remove debian font issue as per Vollstrecker's suggestion

__NOTOC__
{| width="100%"
| align="center" |

<h1>Welcome to the [http://wiki.org/wiki.cgi?WhatIsWiki Wiki] of the [[aMule|aMule Project]]</h1>

{| align="center" width="100%"
| 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]] | [[Main_Page-de|Deutsch]] | [[Main Page-fr|Français]] | [[Main Page-ru|Russian]] | [[Main Page-it|Italiano]] | [[Main Page-pl|Polish]] | [[Main Page-tw|正體中文]]</h3>
|}
|-
| align="left" |
{| width="100%"
| valign="top" |
== Usage ==
* Help [[Getting_Started|Getting Started With aMule]]
* Help [[aMule_problems|Common problems]]
* Help [[Mac specific usage]]
* Help [[aMule is slow]]?
* Help [[aMule makes everything slow]]?
* Info [[aMule files|aMule's files]]
* Info [[Fake servers]]

== Information about aMule ==
* About [[AMule|aMule's features]]
* aMule [[requirements]]
* [[skins|Skin support]] in aMule
* Watch the [[Releases|release graphs]]
* [[Changelogs]]
* aMule's Licence: [[GNU_FDL|GNU General Public License]]

== aMule Wiki and forum ==
* Our [[forum rules]]
* Our [[IRC rules]]
* HOWTO [[aMule:Help|Edit a Wiki page]]
* [[Wiki reorganization]]

== FAQs ==
* FAQ [[FAQ_aMule|on aMule]]
* FAQ [[FAQ_utils|on aMule's utilities]]
* FAQ [[FAQ eD2k-Kademlia|on ED2K-Kademlia]]
* FAQ on the [[FAQ_network|Transfer Rates on the eDonkey Network]]

| width="10px" | ||
| valign="top" |

== Installation and Setup ==
* HOWTO [[Compile|Compile and Install aMule]]
* HOWTO [[Migrate from eMule to aMule]]
* HOWTO [[Ed2k links handling|Handle ed2k:// links]]
* HOWTO [[import-export files|Import and export files]]
* HOWTO [[Get HighID]]
* HOWTO [[Firewall|Setup firewall rules for aMule]]
* HOWTO [[Keep a safe list of servers]]
* HOWTO [[aMuleWeb|Setup aMule's Webserver (aMuleWeb)]]
* HOWTO [[test port|Test your ports]]

== Development ==
* Download the latest [[aMule SVN]]
* HOWTO [[Backtraces|Create useful backtraces]]
* HOWTO [[Using gdb and valgrind|Use GDB and Valgrind]]
* HOWTO [[Using_another_wxinstall|Use more than one wxWidgets]]
* HOWTO [[Bug report|Report a bug]]
* About the [[aMule_devs|aMule Development Team]] and [[aMule_devs#Helping|joining it]]
* Documentation of the [[EC_Procotol_HOWTO|EC protocol]]
* Rules of [[Coding Style|coding style]]
* Running a [[testing field]]

== Translations ==
* HOWTO [[Translations|Translate aMule into your native language]]
* HOWTO [[Translating Wiki|Translate this Wiki]]

|}
|}

MediaWiki:Spam-blacklist

2009-07-16T14:39:01Z

Wuischke:

# External URLs matching this list will be blocked when added to a page.
# This list affects only this wiki; refer also to the global blacklist.
# For documentation see http://www.mediawiki.org/wiki/Extension:SpamBlacklist
# <pre>
#
# Syntax is as follows:
# * Everything from a "#" character to the end of the line is a comment
# * Every non-blank line is a regex fragment which will only match hosts inside URLs

acdc-squealer
bravehost
corsicaferry
topsearche.info
stsland.ru
postroysite.info
luludroppy
idoo.com
greatallsearch.biz
siegel-net.de
clario
itallopak.com
vilsass.cn
10rocker.cn
angelfire.com
forums.ugo.com
lakeland.cc.il.us
acc.umu.se
daemonnews.org
hranostaj.com
canpolitics.com
groups.google.com
googlegroups.com
freewebtown.com
freewebs.com
webs.com
bloggy.ru

# You can add keywords as well, this is a regexp blocker (but take care not to block wanted URLs accidentally)
webcam
porno
fetish
lesbian
vangelis
anal
gay
interracial
poker
pharmacy
insurance
xanax
valium
levitra
cialis
viagra
porn
sex
handbags
clavamox
norpace
breast
serophene
buy
ranitidine
sinemet
robaxin

#</pre>

HowTo Compile aMuled

2009-07-15T12:26:32Z

Wuischke:

<center>
'''English''' |
[[HowTo Compile aMuled-de|Deutsch]] |
[[HowTo_Compile_aMuled-es|Español]] |
[[HowTo_Compile_aMuled-nl|Nederlands]] |
[[HowTo Compile aMuled-fr|Français]]
</center>

== Compile wxWidgets without GUI dependencies ==

'''NOTE:''' I had success with [http://www.wxwidgets.org/downloads/ wxall] (a.k.a. wxWidgets) instead of using wxBase --[[User:Felipe1982|Felipe1982]] 06:21, 14 December 2007 (UTC)

Download [[wxBase]] 2.8.10 or higher from http://www.wxWidgets.org
unpack it, and do as user
*''./configure --disable-gui --enable-unicode --without-subdirs --without-expat
*''make''
as root
*''make install''
*''ldconfig''

== Compile aMuled ==
[http://www.amule.org/files/files.php?cat=27 Download aMule]<br>
Unpack it<br>
As user type:
*''./configure --disable-monolithic --with-toolkit=base --enable-amule-daemon --enable-amulecmd --enable-webserver''
*''make''
as root
*''make install''

That's it. You now have a working [[aMuled|aMule-daemon]] in ''/usr/local/bin''

== Configure aMuled ==

Start aMuled with the command ''amuled --ec-config'' to configure [[External Connections]]. Then you can use aMule [[AMuleWeb]], [[AMuleCMD]] or another [[FAQ_utils|utility]] to control the [[aMuled|daemon]].

You'll find the [[Amule.conf|configuration file]] in ''~/.aMule/amule.conf'' after having run [[aMuled]] once. Please edit the file to change preferences.

Please read the [[FAQ_amuled|aMuled FAQ]] for more information.

Main Page

2009-07-15T11:57:34Z

Wuischke:

__NOTOC__
{| width="100%"
| align="center" |

<h1>Welcome to the [http://wiki.org/wiki.cgi?WhatIsWiki Wiki] of the [[aMule|aMule Project]]</h1>

{| align="center" width="100%"
| 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]] | [[Main_Page-de|Deutsch]] | [[Main Page-fr|Français]] | [[Main Page-ru|Russian]] | [[Main Page-it|Italiano]] | [[Main Page-pl|Polish]] | [[Main Page-tw|正體中文]]</h3>
|}
|-
| align="left" |
{| width="100%"
| valign="top" |
== Usage ==
* Help [[Getting_Started|Getting Started With aMule]]
* Help [[aMule_problems|Common problems]]
* Help [[Mac specific usage]]
* Help [[aMule is slow]]?
* Help [[aMule makes everything slow]]?
* Info [[aMule files|aMule's files]]
* Info [[Fake servers]]

== Information about aMule ==
* About [[AMule|aMule's features]]
* aMule [[requirements]]
* [[skins|Skin support]] in aMule
* Watch the [[Releases|release graphs]]
* [[Changelogs]]
* aMule's Licence: [[GNU_FDL|GNU General Public License]]

== aMule Wiki and forum ==
* Our [[forum rules]]
* Our [[IRC rules]]
* HOWTO [[aMule:Help|Edit a Wiki page]]
* [[Wiki reorganization]]

== FAQs ==
* FAQ [[FAQ_aMule|on aMule]]
* FAQ [[FAQ_utils|on aMule's utilities]]
* FAQ [[FAQ eD2k-Kademlia|on ED2K-Kademlia]]
* FAQ on the [[FAQ_network|Transfer Rates on the eDonkey Network]]

| width="10px" | ||
| valign="top" |

== Installation and Setup ==
* HOWTO [[Compile|Compile and Install aMule]]
* HOWTO [[Migrate from eMule to aMule]]
* HOWTO [[Ed2k links handling|Handle ed2k:// links]]
* HOWTO [[Debian_fonts|Address font issue on Debian]]
* HOWTO [[import-export files|Import and export files]]
* HOWTO [[Get HighID]]
* HOWTO [[Firewall|Setup firewall rules for aMule]]
* HOWTO [[Keep a safe list of servers]]
* HOWTO [[aMuleWeb|Setup aMule's Webserver (aMuleWeb)]]
* HOWTO [[test port|Test your ports]]

== Development ==
* Download the latest [[aMule SVN]]
* HOWTO [[Backtraces|Create useful backtraces]]
* HOWTO [[Using gdb and valgrind|Use GDB and Valgrind]]
* HOWTO [[Using_another_wxinstall|Use more than one wxWidgets]]
* HOWTO [[Bug report|Report a bug]]
* About the [[aMule_devs|aMule Development Team]] and [[aMule_devs#Helping|joining it]]
* Documentation of the [[EC_Procotol_HOWTO|EC protocol]]
* Rules of [[Coding Style|coding style]]
* Running a [[testing field]]

== Translations ==
* HOWTO [[Translations|Translate aMule into your native language]]
* HOWTO [[Translating Wiki|Translate this Wiki]]

|}
|}

Changelogs

2009-07-15T11:57:01Z

Wuischke:

Main Page

2009-07-15T11:48:57Z

Wuischke: Rearrange main page to improve information access

Compile

2009-07-15T11:38:18Z

Wuischke:

<center>'''English''' | [[Compile-de|Deutsch]]</center>

This wiki is an index to the available HOWTOs on compiling [[aMule]] on different [http://www.kernel.org Linux] distros and other operation systems.

== From scratch ==
The main wiki [[Compilation Installation| '''from scratch''']], a distro independant wiki, will walk you through the entire installation proccess. This wiki can be found at:

* [[Compilation Installation|How to compile/install aMule '''from scratch''']]
* [[HowTo_Compile_aMuled|How to compile/install aMuled (aMule Daemon) '''from scratch''']]

== [http://www.kernel.org Linux] ==
Distribution specific guides are also available for the following [http://www.kernel.org '''Linux'''] '''distros''' (uses distribution's packages instead of compiling):

* [[HowTo_Compile_In_Debian|How to compile/install aMule on '''Debian''' or '''Ubuntu''']] [[HowTo_Compile_In_Debian-es|Spanish]])
*[[HowTo_Compile_In_Gentoo|How to compile/install aMule on '''Gentoo''']] ([[HowTo_Compile_In_Gentoo-es|Spanish]])
* [[HowTo_Compile_In_Slackware|How to compile/install aMule on '''Slackware''']]
* [[HowTo_Compile_In_RedHat-Fedora|How to compile/install aMule on '''RedHat''' or '''Fedora''']]
* [[HowTo_Compile_In_FC3|How to compile/install aMule on '''Fedora Core 3''']]
* [[HowTo_Compile_In_MDK|How to compile/install aMule on '''Mandrake 10''']] ([[HowTo_Compile_In_MDK-es|Spanish]]) ([[HowTo Compile In MDK-fr|French]])

== [http://www.bsd.org BSD] ==
A guide for [http://www.freebsd.org '''FreeBSD'''] (and other BSD's) users is also available:

* [[Install-amule-freebsd|How to compile/install aMule on '''FreeBSD''']]

== [http://www.sun.com/software/solaris Solaris] ==
For [http://www.sun.com/software/solaris Solaris] users a guide is also available:

* [[HowTo_compile_on_Solaris|How to compile/install aMule on '''Solaris''']]

== [http://www.apple.com/macosx Mac OSX] ==
[[aMule]] for [http://www.apple.com/macosx '''OSX'''] can be compiled following this guide:

* [[HowTo_compile_on_Mac|How to compile/install aMule on '''OSX''']]

== [http://www.microsoft.com/windows Microsoft Windows] ==
You can give a try at [[aMule]]'s current development in [http://www.microsoft.com/windows '''Microsoft Windows'''] using this guide:

* [[HowTo compile on Win32 new|How to compile/install aMule on '''Windows''']]

== Others ==
What? Your distro isn't listed here? Then ''PLEASE'' write your own howto and submit it here in [[Main Page|this wiki]]. Many will be ''VERY'' grateful :-)

Main Page

2009-06-30T17:49:04Z

Wuischke:

Main Page

2009-06-30T17:48:38Z

Wuischke: Big main page clean up

Compatible operating system

2009-06-30T17:46:41Z

Wuischke:

<center>
'''English''' |
[[Compatible_operating_system-de|Deutsch]]
</center>

Currently (officially) supported operating systems by [[aMule]] include:
*[[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]
*[[MacOS X]]
*[[Windows]]
*IRIX
*Other *nix platforms are known to be supported although unofficially

Wiki reorganization

2009-06-30T17:43:33Z

Wuischke: /* List of outdated pages */

= Wiki reorganization =

== Why? ==

Unfortunately many pages in our wiki are outdated - they contain old information, tutorials don't work anymore in aMule 2.2.1 or recent SVN snapshots and some information are even incorrect now. To improve the quality of our documentation, old pages need to be reworked and outdated information replaced by improved and updated texts. aMule 2.1.3 is outdated, references to it (or even older versions) should be replaced by references to [[aMule SVN]].

== How can I help? ==

The easiest way is to read the wiki and add any outdated pages you find to the list below. Add a short note on what needs an update, please.
If you feel comfortable doing more, have a look at the list of pages below and see which ones you could rework. Once the complaint is resolved, you can add a remark that you updated the page.

= main page organization =

Provide a more user centric approach and put advanced topics in the back. Only these information for the end user should be translated.

Information geared at advanced users and developers don't have to be translated, as our dev language is English anyway.

= Pages in need of an update =

== List of outdated pages ==
* [[Getting_Started]] - Update screenshots, rework outdated passages, add information about fake server
* [[Ed2k_links_handling]] - Remove discontinued browser, update screenshots, check information for correctness
* [[Usage_Preferences]] - update preferences description to current version
* <s>[[aMule CVS]] - [[Special:Whatlinkshere/AMule_CVS|Pages still linking to it]] probably need a touch-up anyway and references should be changed to [[aMule SVN]].</s>
* [[Nodes.dat_file]] - update to current format
* [[Releases]]

== outdated / incorrect translations ==

= Style change =

== No Version sections ==

If you encounter any Version sections (created by, updated by), please delete them. These information are available to everyone using the history function. This doesn't mean that the work of all contributors is less recognized, but the layout is cleaner this way.

== Language Links ==
The links to the translated articles should be written in the language of the target page, so any site can be visited by any user. A french user can find the french version of the page, even when he enters the wiki on a korean article. The links should be ordered aphabetical depending on their language-appendix.

* No appendix: English
* -cn: Simplified Chinese (简体中文)
* -da: Dansk
* -de: Deutsch
* -es: Español (write Espa&ntilde;ol)
* -fi: Suomi
* -fr: Français (write Fran&ccedil;ais)
* -hu: Magyar
* -it: Italiano
* -ko_KR: 한국말
* -nl: Nederlands
* -pl: Polski
* -pt_BR: Português (write Portugu&ecirc;s)
* -ru: Русский (write &#1056;&#1091;&#1089;&#1089;&#1082;&#1080;&#1081;)
* -tw: Traditional Chinese (正體中文)

To be continued.

The Links to the translation on the main-pages should dissappaer. A user can change to the main-page of his language. The articles should link to just the version in their lang. If it's not aviable in the corresponding lang, it should be linked to the english version, and marked with (en) after the name.

Wiki reorganization

2009-06-30T14:50:43Z

Wuischke:

= Wiki reorganization =

== Why? ==

Unfortunately many pages in our wiki are outdated - they contain old information, tutorials don't work anymore in aMule 2.2.1 or recent SVN snapshots and some information are even incorrect now. To improve the quality of our documentation, old pages need to be reworked and outdated information replaced by improved and updated texts. aMule 2.1.3 is outdated, references to it (or even older versions) should be replaced by references to [[aMule SVN]].

== How can I help? ==

The easiest way is to read the wiki and add any outdated pages you find to the list below. Add a short note on what needs an update, please.
If you feel comfortable doing more, have a look at the list of pages below and see which ones you could rework. Once the complaint is resolved, you can add a remark that you updated the page.

= main page organization =

Provide a more user centric approach and put advanced topics in the back. Only these information for the end user should be translated.

Information geared at advanced users and developers don't have to be translated, as our dev language is English anyway.

= Pages in need of an update =

== List of outdated pages ==
* [[Getting_Started]] - Update screenshots, rework outdated passages, add information about fake server
* [[Ed2k_links_handling]] - Remove discontinued browser, update screenshots, check information for correctness
* [[Usage_Preferences]] - update preferences description to current version
* <s>[[aMule CVS]] - [[Special:Whatlinkshere/AMule_CVS|Pages still linking to it]] probably need a touch-up anyway and references should be changed to [[aMule SVN]].</s>
* [[Nodes.dat_file]] - update to current format

== outdated / incorrect translations ==

= Style change =

== No Version sections ==

If you encounter any Version sections (created by, updated by), please delete them. These information are available to everyone using the history function. This doesn't mean that the work of all contributors is less recognized, but the layout is cleaner this way.

== Language Links ==
The links to the translated articles should be written in the language of the target page, so any site can be visited by any user. A french user can find the french version of the page, even when he enters the wiki on a korean article. The links should be ordered aphabetical depending on their language-appendix.

* No appendix: English
* -cn: Simplified Chinese (简体中文)
* -da: Dansk
* -de: Deutsch
* -es: Español (write Espa&ntilde;ol)
* -fi: Suomi
* -fr: Français (write Fran&ccedil;ais)
* -hu: Magyar
* -it: Italiano
* -ko_KR: 한국말
* -nl: Nederlands
* -pl: Polski
* -pt_BR: Português (write Portugu&ecirc;s)
* -ru: Русский (write &#1056;&#1091;&#1089;&#1089;&#1082;&#1080;&#1081;)
* -tw: Traditional Chinese (正體中文)

To be continued.

The Links to the translation on the main-pages should dissappaer. A user can change to the main-page of his language. The articles should link to just the version in their lang. If it's not aviable in the corresponding lang, it should be linked to the english version, and marked with (en) after the name.

Main Page-fr

2009-06-30T14:44:35Z

Wuischke:

__NOTOC__

{|
| align="center" | <h1>Bienvenue sur le [http://wiki.org/wiki.cgi?WhatIsWiki Wiki] de [[AMule|du projet aMule]]</h1>
{| align="center"
| align="center" | Nous espérons que vous trouverez les reponses aux questions que vous vous posez sur aMule!
|-
| align="right" | ''-- L'[[aMule_devs| équipe de aMule]] --''
|-
| align="center" | <h3>[[Main_Page|English]] |[[Main_Page-es|Español]] | [[Main_Page-nl|Nederlands]] | [[Main_Page-ko_KR|Korean]] | [[Main_Page-de|Deutsch]] | '''Français''' | [[Main Page-ru|Russian]] | [[Main Page-it|Italiano]] | [[Main Page-pl|Polish]]</h3><br>
|-
| align="center" | Lorsqu'un liens est suivit de "(en)" ce la signifie qu'il n'a pas encore été traduit en français (n'ésitez pas a le faire vous même).
|}
|-
| align="left" |
{|
| valign="top" |
== Installation ==
* HOWTO [[Compilation Installation-fr|Compilation et instalation de aMule depuis les sources]]
* HOWTO [[Install-amule-freebsd|Compiler aMule sous FreeBSD]] (Anglais)
* HOWTO [[HowTo_compile_on_Mac-fr|Compiler aMule sous Mac]]
* HOWTO [[HowTo_compile_on_Solaris|Compiler aMule sous Solaris]] (Anglais)
* HOWTO [[HowTo compile on Win32-fr|Compiler aMule sous Windows]]
* HOWTO [[HowTo_Compile_In_Debian|Compiler aMule sous Debian ou Ubuntu]] (Anglais)
* HOWTO [[HowTo_Compile_In_Gentoo|Compiler aMule sous Gentoo]] (Anglais)
* HOWTO [[HowTo_Compile_In_Slackware|Compiler aMule sous Slackware]] (Anglais)
* HOWTO [[HowTo_Compile_In_RedHat-Fedora|Compiler aMule sous RedHat/Fedora]] (Anglais)
* HOWTO [[HowTo Compile In MDK-fr|Installer aMule sur Mandrake 10]] (Anglais)
* HOWTO [[HowTo_Compile_aMuled|Compiler le daemon de aMule daemon (aMuled)]] (Anglais)
* HOWTO [[HowTo_get_aMule_web_interface|Installation de aMuleWeb]] (Anglais)

== Autres ==
* À propos [[AMule|aMule's features]] (Anglais)
* aMule [[requirements]] (Anglais)
* [[Fake servers]] (Anglais)
* HOWTO [[How_to_launch_VNC_with_aMule_at_Linux_boot|Lancer VNC avec aMule au boot de boot]] (Anglais)
* HOWTO [[Check if wx is installed twice|Controler si wxWidgets est installer twice]] (Anglais)
* HOWTO [[How_to_uninstall_wxWidgets|désinstaller wxWidgets]] (Anglais)
* Obtenir [[wx-cvs|wxWidgets CVS]] (Anglais)
* À propos [[webcache]] (Anglais)
* Utilisateur [[geaiez]] (Anglais)
* Some [[reviews]] (Anglais)
* Testes [[test port|your ports]] (Anglais)
* Lire [[current events]] (Anglais)
* Voir le [[Releases|release graphs]] (Anglais)
* Our [[forum rules]] (Anglais)
* Our [[IRC rules]] (Anglais)
* HOWTO [[aMule:Help|Edit a Wiki page]] (Anglais)
* Join [[frappr!]] (Anglais)

== Changelogs: ==
* [[Changelog_latest|Latest aMule release]](en)
* [[Changelog 2.1_series|aMule 2.1.X]](en)
** [[Changelog 2.1.0|aMule 2.1.0]](en)
** [[Changelog 2.1.1|aMule 2.1.1]](en)
** [[Changelog 2.1.2|aMule 2.1.2]](en)
** [[Changelog 2.1.3|aMule 2.1.3]](en)
* [[Changelog 2.0_series|aMule 2.0.X]](en)
* [[Changelog 2.0.0-rc_series|aMule 2.0.0 Release Candidates]](en)
* [[Changelog_1.2_series|aMule 1.2.X]](en)
* [[Changelog_1.1_series|aMule 1.1.X]](en)
* [[Changelog_1.0_series|aMule 1.0.X]](en)
| width="10px" | ||
| valign="top" |

== Usage ==
* Aide [[Getting_Started-fr|Comment commencer avec aMule]]
* Aide [[Usage aMule|utiliser aMule]] (Anglais)
* Aide [[aMule_problems|Problemes commun]] (Anglais)
* Aide [[Mac specific usage]] (Anglais)
* Aide [[aMule is slow]]? (Anglais)
* Aide [[aMule makes everything slow]]? (Anglais)
* Information [[aMule files|Fichiers aMule]] (Anglais)
* HOWTO [[How_to_use_auxiliary_server_ports|Utiliser un port auxiliaire de serveur]] (Anglais)

== Foire Aux Questions: ==
* FAQ [[FAQ aMule-fr|sur aMule]]
* FAQ [[FAQ_utils|on aMule's utilities]] (Anglais)
* FAQ [[FAQ_ed2k-fr|sur ED2K-Kademlia]] (Anglais)([[FAQ eD2k-Kademlia|English]]) ([[FAQ_eD2k-Kademlia-nl|Dutch]]) ([[FAQ_eD2k-Kademlia-pl|Polish]])
* FAQ sur [[FAQ_network|Transfer Rates on the eDonkey Network]] (Anglais)

== Setup tips ==
* HOWTO [[Migrate from eMule to aMule]] (Anglais)
* HOWTO [[Ed2k links handling|Handle ed2k:// links]] (Anglais)
* HOWTO [[Debian_fonts|Address font issue on Debian]] (Anglais)
* HOWTO [[import-export files|Import and export files]] (Anglais)
* HOWTO [[Get HighID]] (Anglais)
* HOWTO [[Firewall|Setup firewall rules for aMule]] (Anglais)
* HOWTO [[Keep a safe list of servers]] (Anglais)
* HOWTO [[aMuleWeb|Setup aMule's Webserver (aMuleWeb)]] (Anglais)

== Dévelopement ==
* Télécharger la dernière [[aMule SVN]] (Anglais)
* Télécharger la dernière [[Win32_binary|Windows aMule Installer]] (Anglais)
* About the [[aMule_devs|L'équipe de dévelopement de aMule]](en) et [[aMule_devs#Helping|comment la rejoindre]](en)
* HOWTO [[Backtraces|Create useful backtraces]] (Anglais)
* HOWTO [[Using gdb and valgrind|Use GDB and Valgrind]] (Anglais)
* HOWTO [[Using_another_wxinstall|Use more than one wxWidgets]] (Anglais)
* Règle de [[Coding Style|coding style]] (Anglais)
* Running a [[testing field]] (Anglais)
* HOWTO [[Bug report|Report a bug]] (Anglais)
* La [[GNU_FDL| licence GNU]] (Anglais)

== Traductions ==
* HOWTO [[Translations|Translate aMule into your native language]] (Anglais)
* HOWTO [[Translating Wiki-fr|Traduire ce Wiki]]
|}
|}

Main Page-de

2009-06-30T14:23:18Z

Wuischke:

__NOTOC__

{|
| align="center" |
''Das aMule-Wiki hat die Marke von '''10.000.000 gelesenen Artikeln''' erreicht. Danke euch allen!''
|-
| align="center" | <h1>Willkommen im [http://wiki.org/wiki.cgi?WhatIsWiki Wiki] des [[AMule-de|aMule-Projektes]]</h1>
{| align="center"
| align="center" | Wir hoffen, dass du Antworten auf deine aMule Fragen und Probleme findest.
|-
| align="right" | ''-- Das [[aMule_devs-de|aMule-Team]] --''
|-
| align="center" | <h3>[[Main_Page|English]] | [[Main_Page-es|Español]] | [[Main_Page-nl|Nederlands]] | [[Main_Page-ko_KR|Korean]] | '''Deutsch''' | [[Main Page-fr|Français]] | [[Main Page-ru|Russian]] | [[Main Page-it|Italiano]] | [[Main Page-pl|Polish]]</h3>
|}
|-
| align="left" |
{|
| valign="top" |
== Installation ==
* HOWTO: [[Compilation Installation-de|Kompilieren und Installieren von aMule mit Hilfe des Quellcodes]]
* HOWTO: [[Install-amule-freebsd|Kompilieren von aMule unter FreeBSD]] (Englisch)
* HOWTO: [[HowTo_compile_on_Mac-de|Kompilieren von aMule auf dem Mac]]
* HOWTO: [[HowTo_compile_on_Solaris-de|Kompilieren von aMule unter Solaris]]
* HOWTO: [[HowTo compile on Win32-de|Kompilieren von aMule unter Windows]]
* HOWTO: [[HowTo_Compile_In_Debian-de|Kompilieren von aMule unter Debian oder Ubuntu]]
* HOWTO: [[HowTo_Compile_In_Gentoo-de|Kompilieren von aMule unter Gentoo]]
* HOWTO: [[HowTo_Compile_In_Slackware|Kompilieren von aMule unter Slackware]] (Englisch)
* HOWTO: [[HowTo_Compile_In_RedHat-Fedora|Kompilieren von aMule unter RedHat/Fedora]] (Englisch)
* HOWTO: [[HowTo_Compile_In_MDK|Installieren von aMule unter Mandrake 10]] (Englisch)
* HOWTO: [[HowTo_Compile_aMuled-de|Kompilieren des aMule Linux daemon (aMuled)]]
* HOWTO: [[HowTo_get_aMule_web_interface-de|aMuleWeb installieren]]

== Diverses ==
* Über [[aMule-de|aMule's Features]]
* aMule [[requirements-de| Systemvoraussetzungen]]
* [[Fake servers-de|Fake server]]
* Wie kann man [[How_to_launch_VNC_with_aMule_at_Linux_boot|VNC mit aMule beim Linux Boot starten]] (Englisch)
* HOWTO: [[Check if wx is installed twice-de|Prüfe, ob wxWidgets doppelt installiert ist]]
* HOWTO: [[How_to_uninstall_wxWidgets-de|Deinstallieren von wxWidgets]]
* Lade [[wx-cvs-de|wxWidgets-CVS]]
* Über den [[webcache|Webcache]] (Englisch)
* Benutzer [[Geaiez-de|Geaiez]]
* Einige [[reviews|Reviews]] (Englisch)
* Teste [[test port-de|deine aMule Ports]]
* [[current events|Aktuelle Neuigkeiten]] (Englisch)
* Das [[Releases-de|Releasediagramm]]
* Unsere [[forum rules|Forenregeln]] (Englisch)
* Unsere [[IRC rules-de|Regeln im IRC]]
* HOWTO: [[aMule:Help-de|Bearbeiten einer Wikiseite]]
* Mach mit bei [[frappr!-de|frappr!]]

== Changelogs: ==
* [[Changelog_latest|Letztes aMule-Release]]
* [[Changelog 2.1_series|aMule 2.1.X]]
** [[Changelog 2.1.0|aMule 2.1.0]]
** [[Changelog 2.1.1|aMule 2.1.1]]
** [[Changelog 2.1.2|aMule 2.1.2]]
** [[Changelog 2.1.3|aMule 2.1.3]]
* [[Changelog 2.0_series|aMule 2.0.X]]
* [[Changelog 2.0.0-rc_series|aMule 2.0.0 Releasekandidaten]]
* [[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" |

== Verwendung ==
* Hilfe: Ein [[Getting_Started-de|Einstieg in aMule]]
* Hilfe: [[aMule_problems-de|Allgemeine Probleme]]
* Hilfe: [[Mac specific usage|Mac-spezifisches]] (Englisch)
* Hilfe: [[aMule is slow-de|aMule lädt so langsam]]
* Hilfe: [[aMule makes everything slow-de|aMule macht alles langsamer]]Englisch]])
* Info: [[AMule_files-de|aMule's Dateien]]
* HOWTO: [[How_to_use_auxiliary_server_ports-de|Verwenden alternativer Serverports]]

== FAQs: ==
* FAQ [[FAQ_aMule-de|über aMule]]
* FAQ [[FAQ_utils-de|über aMule's Dienstprogramme]]
* FAQ [[FAQ_eD2k-Kademlia-de|über ED2K-Kademlia]]
* FAQ [[FAQ_network|über Transferraten im eDonkey-Netzwerk]] (Englisch)

== Einrichtungstipps ==
* Wie [[Migrate from eMule to aMule|migriert man von eMule zu aMule]] (Englisch)
* Wie kann ich [[Ed2k links handling-de|ed2k:// Links handhaben]]
* Wie geht man mit [[Debian_fonts|Schriftproblemen in Debian]] um (Englisch)
* Wie [[import-export files-de|werden Dateien importiert und exportiert]]
* Wie [[get HighID-de|bekomme ich eine hohe ID?]]
* Wie stellt man die [[Firewall-de|Firewallregeln für aMule]] ein
* Wie [[keep a safe list of servers-de|behält man eine sichere Serverliste]]
* Wie wird der [[aMuleWeb-de|Webserver (aMuleWeb) eingerichtet]]

== Entwicklung ==
* Lade die neueste [[aMule SVN-de|aMule-svn]]
* Lade den neuesten [[Win32_binary|Windows aMule-Installer]] (Englisch)
* Über das [[aMule_devs-de|aMule-Entwicklerteam]] und wie du [[aMule_devs-de#Helfen|Mitglied werden]] kannst
* HOWTO: [[Backtraces|Erzeugen eines brauchbaren Fehlerprotokolls]] (Englisch)
* HOWTO: [[Using gdb and valgrind|Benutzung von GDB und Valgrind]] (Englisch)
* HOWTO: [[Using_another_wxinstall-de|Mehr als eine Version von wxWidgets benutzen]]
* Regeln für den [[Coding Style|Programmier-Stil]] (Englisch)
* Eine [[testing field-de|Testumgebung]] einrichten
* HOWTO: [[Bug report-de|Fehler melden]]
* Die verwendete Lizenz: [[GNU_FDL-de|GNU General Public License]]

== Übersetzungen ==
* HOWTO: [[Translations-de|aMule in deine Muttersprache übersetzen]]
* HOWTO: [[Translating Wiki-de|Das Wiki übersetzen]]
|}
|}

Main Page-ko KR

2009-06-30T14:09:47Z

Wuischke: Does somebody know the korean signs for "English"?

__NOTOC__

{|
| align="center" | <h1>[[AMule|어뮬 프로젝트]]의 [http://wiki.org/wiki.cgi?WhatIsWiki 위키]에 오신것을 환영합니다.</h1>
{| align="center"
| align="center" | 우리는 당신이 어뮬의 궁금증과 해결책을 찾기 바랍니다!
|-
| align="right" | ''-- [[aMule_devs|어뮬 팀]] --''
|-
| align="center" | <h3>[[Main_Page|English]] | [[Main_Page-es|Español]] | [[Main_Page-nl|Nederlands]] | '''한국말''' | [[Main_Page-de|Deutsch]] | [[Main Page-fr|Français]] | [[Main Page-ru|Russian]] | [[Main Page-it|Italiano]] | [[Main Page-pl|Polish]]</h3>
|}
|-
| align="left" |
{|
| valign="top" |

== 설치 ==
* [[Compilation Installation|소스 컴파일과 설치]] 방법 (English)
* [[Install-amule-freebsd|FreeBSD에서 컴파일]] 방법 (English)
* [[HowTo_compile_on_Mac|맥에서 컴파일]] 방법 (English)
* [[HowTo_compile_on_Solaris|솔라리스에서 컴파일]] 방법 (English)
* [[HowTo compile on Win32 new|윈도우에서 컴파일]] 방법 (English)
* [[HowTo_Compile_In_Debian|데비안과 우분투에서 컴파일]] 방법 (English)
* [[HowTo_Compile_In_Gentoo|젠투에서 컴파일]] 방법 (English)
* [[HowTo_Compile_In_Slackware|슬렉웨어에서 컴파일]] 방법 (English)
* [[HowTo_Compile_In_RedHat-Fedora|레드헷에서 컴파일]] 방법 (English)
* [[HowTo_Compile_In_MDK|맨드레크에서 설치]] 방법 (English)
* [[HowTo_Compile_aMuled|어뮬 데몬 컴파일]] 방법 (English)
* [[HowTo_get_aMule_web_interface|어뮬웹 설치]] (English)

== 기타 ==
* [[AMule|어뮬의 특징]]에 대하여 (English)
* 어뮬 [[requirements|요구사항]] (English)
* [[Fake servers|가짜 서버]] (English)
* [[How_to_launch_VNC_with_aMule_at_Linux_boot|리눅스 부팅시 VNC와 어뮬 실행]] 방법 (English)
* [[Check if wx is installed twice|wxWidgets가 중복 설치되었는지 검사하는]] 방법 (English)
* [[How_to_uninstall_wxWidgets|wxWidgets 제거]] 방법 (English)
* [[wx-cvs|wxWidgets CVS]] 얻기 (English)
* [[webcache|웹케시]]에 대하여 (English)
* [[geaiez|geaiez]] 사용자 (English)
* [[reviews|미리보기]] (English)
* [[test port|포트 검사]] (English)
* [[current events|현재 이벤트]] 읽기 (English)
* [[Releases|공개 그래프]] 보기 (English)
* [[forum rules|포럼 룰]] (English)
* [[IRC rules|IRC 룰]] (English)
* [[aMule:Help|위키 수정]] 방법 (English)
* [[frappr!|frappr!]]에 합류하기 (English)

== 변경로그: ==
* [[Changelog_latest|최신 공개 어뮬]]
* [[Changelog 2.1_series-ko_KR|어뮬 2.1.X]]
** [[Changelog 2.1.0|어뮬 2.1.0]]
** [[Changelog 2.1.1|어뮬 2.1.1]]
** [[Changelog 2.1.2|어뮬 2.1.2]]
** [[Changelog 2.1.3|어뮬 2.1.3]]
* [[Changelog 2.0_series-ko_KR|어뮬 2.0.X]]
* [[Changelog 2.0.0-rc_series|어뮬 2.0.0-rcX]]
* [[Changelog_1.2_series|어뮬 1.2.X]]
* [[Changelog_1.1_series|어뮬 1.1.X]]
* [[Changelog_1.0_series|어뮬 1.0.X]]
| width="10px" | ||
| valign="top" |

== 사용법 ==
* [[Getting_Started|어뮬 시작하기]] (English)
* [[Usage aMule|어뮬 사용하기]] (English)
* [[aMule_problems|일반적인 문제]] (English)
* [[Mac specific usage|맥에서 사용하기]] (English)
* [[aMule is slow|어뮬이 느린경우]] (English)
* [[aMule makes everything slow|어뮬이 모든것을 느리게 하는경우]] 도움 (English)
* [[aMule files|어뮬 파일]] 정보 (English)
* [[How_to_use_auxiliary_server_ports|보조 서버포트 사용]] 방법 (English)

== 자주묻는 질문: ==
* [[FAQ_aMule|어뮬]]에 대한 질문과 답변 (English)
* [[FAQ_utils|어뮬 유틸]]에 대한 질문과 답변 (English)
* [[FAQ eD2k-Kademlia|ed2k-카뎀리아]]에 대한 질문과 답변 (English)
* [[FAQ_network|네트워크]]에 대한 질문과 답변 (English)

== 설치 팁 ==
* [[Migrate from eMule to aMule|이뮬에서 어뮬로 이전]]하는 방법 (English)
* [[Ed2k links handling-ko_KR|ed2k://링크 처리기]] 사용법 (English)
* [[Debian_fonts|데비안 폰트]] 문제 (English)
* [[import-export files|파일 가겨오기와 내보내기]] (English)
* [[Get HighID]] (English)
* [[Firewall|어뮬을 위한 방화벽 설정]]법 (English)
* [[Keep a safe list of servers|안전한 서버목록을 유지하는 방법]] (English)
* [[aMuleWeb|어뮬의 웹서버 설정]]법 (English)

== 개발 ==
* 최신의 [[aMule SVN|어뮬 SVN]] 내려받기 (English)
* 최신의 [[Win32_binary|윈도우 어뮬]] 내려받기 (English)
* [[aMule_devs|어뮬 개발팀]] 과 [[aMule_devs#Helping|참가]]에 대하여
* [[Backtraces|유용한 백트랙 생성]]법 (English)
* [[Using gdb and valgrind|GDB와 발그린드 사용]]법 (English)
* [[Using_another_wxinstall|한개 이상의 wxWidgets 사용]]법 (English)
* [[Coding Style|코드 형식]]룰 (English)
* [[testing field|실무 테스트]] (English)
* [[Bug report-ko KR|버그 보고]]법
* [[GNU_FDL|일반 공중 사용 허가서]] (English)

== 번역 ==
* [[Translations-ko_KR|어뮬을 당신의 언어로 번역하는]] 방법
* [[Translating Wiki-ko_KR|이 위키 번역]]법
|}
|}

Main Page-nl

2009-06-30T14:06:22Z

Wuischke:

__NOTOC__

{|
| align="center" | <h1>Welkom op de [http://wiki.org/wiki.cgi?WhatIsWiki Wiki] van het [[AMule|aMule Project]]</h1>
{| align="center"
| align="center" | We hopen dat u hier de antwoorden op uw vragen en problemen kunt vinden!
|-
| align="right" | ''-- Het [[aMule_devs|aMule Team]] --''
|-
| align="center" | <h3>[[Main_Page|English]] | [[Main_Page-es|Español]] | '''Nederlands''' | [[Main_Page-ko_KR|Korean]] | [[Main_Page-de|Deutsch]] | [[Main Page-fr|Français]] | [[Main Page-ru|Russian]] | [[Main Page-it|Italiano]] | [[Main Page-pl|Polish]]</h3>
|}
|-
{|
| valign="top" |
== Installatie ==
* Hoe [[Compilation Installation-nl|aMule compileren/installeren vanaf het begin]]
* Hoe [[Install-amule-freebsd|aMule compileren op FreeBSD]] (Engles)
* Hoe [[HowTo_compile_on_Mac|aMule compileren op de Mac]] (Engles)
* Hoe [[HowTo_compile_on_Solaris|aMule compileren op Solaris]] (Engles)
* Hoe [[HowTo compile on Win32 new|aMule compileren op Windows]] (Engles)
* Hoe [[HowTo_Compile_In_Debian|aMule compileren in Debian of Ubuntu]] (Engles)
* Hoe [[HowTo_Compile_In_Gentoo|aMule compileren in Gentoo]] (Engles)
* Hoe [[HowTo_Compile_In_Slackware|aMule compileren in Slackware]] (Engles)
* Hoe [[HowTo_Compile_In_RedHat-Fedora|aMule compileren in RedHat/Fedora]] (Engles)
* Hoe [[HowTo_Compile_In_MDK|aMule installeren in Mandrake 10]] (Engles)
* Hoe [[HowTo_Compile_aMuled-nl|aMule daemon compileren (aMuled)]]
* Hoe [[HowTo_get_aMule_web_interface|aMuleWeb installeren]] (Engles)

== Anders ==
* Over [[AMule|aMules features]] (Engles)
* aMule [[requirements|benodigdheden]] (Engles)
* [[Fake servers]] (Engles)
* Hoe [[How_to_launch_VNC_with_aMule_at_Linux_boot|VNC met aMule starten bij het opstarten van Linux]] (Engles)
* Hoe [[Check if wx is installed twice|te controleren of wxWidgets twee keer geïnstalleerd is]] (Engles)
* Hoe [[How_to_uninstall_wxWidgets|wxWidgets te verwijderen]] (Engles)
* Over [[webcache]] (Engles)
* Gebruiker [[geaiez]] (Engles)
* Enkele [[reviews|recencies]] (Engles)
* Test [[test port|uw poorten]] (Engles)
* Lees [[current events|huidige gebeurtenissen]] (Engles)
* Bekijk de [[releases|release grafieken]] (Engles)
* Onze [[forum rules|forum regels]] (Engles)
* Onze [[IRC rules|IRC regels]] (Engles)
* Hoe [[aMule:Help|een Wiki pagina bewerken]] (Engles)
* Join [[frappr!]] (Engles)

== Veranderingen: ==
* [[Changelog_latest|Laatste aMule versie]]
* [[Changelog 2.1_series|aMule 2.1.X]]
** [[Changelog 2.1.0|aMule 2.1.0]]
** [[Changelog 2.1.1|aMule 2.1.1]]
** [[Changelog 2.1.2|aMule 2.1.2]]
** [[Changelog 2.1.3|aMule 2.1.3]]
* [[Changelog 2.0_series|aMule 2.0.X]]
* [[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="15px" | ||
| valign="top" |
== Gebruik ==
* Help [[Getting_Started-nl|Beginnen met aMule]]
* Help [[Usage aMule|gebruik van aMule]] (Engles)
* Help [[AMule_problems-nl|Veel voorkomende problemen]]
* Help [[Mac specific usage]] (Engles)
* Help [[aMule_is_slow-nl|aMule is langzaam]]?
* Help [[aMule_makes_everything_slow-nl|aMule vertraagt alles]]?
* Info [[aMule files-nl|aMule's bestanden]]
* HOE [[How_to_use_auxiliary_server_ports-nl|ongewone server poorten te gebruiken]]

== FAQs: ==
* FAQ [[FAQ_aMule-nl|over aMule]]
* FAQ [[FAQ_utils|over aMule's extra programma's]] (Engles)
* FAQ [[FAQ_eD2k-Kademlia-nl|over ED2K-Kademlia]]
* FAQ [[FAQ_network|over Overdracht Snelheden op het eDonkey Netwerk]] (Engles)

== Instelingen tips ==
* Hoe [[migrate from eMule to aMule|overstappen van eMule naar aMule]] (Engles)
* Hoe [[Ed2k links handling-nl|ed2k:// links afhandelen]]
* Hoe [[Debian_fonts|lettertype problemen in Debian oplossen]] (Engles)
* Hoe [[import-export files|bestanden im- en exporteren]] (Engles)
* Hoe [[get HighID|een Hoog ID te krijgen]] (Engles)
* Hoe [[Firewall|iptables instellen voor aMule]] (Engles)
* Hoe [[keep a safe list of servers|een veilige lijst met servers te houden]] (Engles)
* Hoe [[aMuleWeb|aMule's Webserver instellen]] (Engles)

== Ontwikkeling ==
* Download de laatste [[aMule SVN]] (Engles)
* Download de laatste [[Win32_binary|Windows aMule Installer]] (Engles)
* Over het [[aMule_devs|Ontwikkelings Team]] en [[aMule_devs#Helping|u erbij aansluiten]]
* Hoe [[Backtraces|zinvolle backtraces maken]] (Engles)
* Hoe [[Using gdb and valgrind|GDB en Valgrind gebruiken]] (Engles)
* Hoe [[Using_another_wxinstall|meer dan een wxWidgets gebruiken]] (Engles)
* Regels van [[Coding Style|de programmeer stijl]] (Engles)
* Draaien van een [[testing field|test]] (Engles)
* HOE [[Bug report|Een bug melden]] (Engles)
* De [[GNU_FDL|GNU General Public License]] (Engles)

== Vertalingen ==
* Hoe [[Translations|aMule te vertalen in uw taal]] (Engles)
* Hoe [[Translating Wiki-nl|deze Wiki vertalen]]
|}
|}

Main Page-nl

2009-06-30T14:04:17Z

Wuischke: More of the same.

__NOTOC__

{|
| align="center" | <h1>Welkom op de [http://wiki.org/wiki.cgi?WhatIsWiki Wiki] van het [[AMule|aMule Project]]</h1>
{| align="center"
| align="center" | We hopen dat u hier de antwoorden op uw vragen en problemen kunt vinden!
|-
| align="right" | ''-- Het [[aMule_devs|aMule Team]] --''
|-
| align="center" | <h3>[[Main_Page|English]] | [[Main_Page-es|Español]] | '''Nederlands''' | [[Main_Page-ko_KR|Korean]] | [[Main_Page-de|Deutsch]] | [[Main Page-fr|Français]] | [[Main Page-ru|Russian]] | [[Main Page-it|Italiano]] | [[Main Page-pl|Polish]]</h3>
|}
|-
{|
| valign="top" |
== Installatie ==
* Hoe [[Compilation Installation-nl|aMule compileren/installeren vanaf het begin]]
* Hoe [[Install-amule-freebsd|aMule compileren op FreeBSD]] (Engles)
* Hoe [[HowTo_compile_on_Mac|aMule compileren op de Mac]] (Engles)
* Hoe [[HowTo_compile_on_Solaris|aMule compileren op Solaris]] (Engles)
* Hoe [[HowTo compile on Win32|aMule compileren op Windows]] (Engles)
* Hoe [[HowTo_Compile_In_Debian|aMule compileren in Debian of Ubuntu]] (Engles)
* Hoe [[HowTo_Compile_In_Gentoo|aMule compileren in Gentoo]] (Engles)
* Hoe [[HowTo_Compile_In_Slackware|aMule compileren in Slackware]] (Engles)
* Hoe [[HowTo_Compile_In_RedHat-Fedora|aMule compileren in RedHat/Fedora]] (Engles)
* Hoe [[HowTo_Compile_In_MDK|aMule installeren in Mandrake 10]] (Engles)
* Hoe [[HowTo_Compile_aMuled-nl|aMule daemon compileren (aMuled)]]
* Hoe [[HowTo_get_aMule_web_interface|aMuleWeb installeren]] (Engles)

== Anders ==
* Over [[AMule|aMules features]] (Engles)
* aMule [[requirements|benodigdheden]] (Engles)
* [[Fake servers]] (Engles)
* Hoe [[How_to_launch_VNC_with_aMule_at_Linux_boot|VNC met aMule starten bij het opstarten van Linux]] (Engles)
* Hoe [[Check if wx is installed twice|te controleren of wxWidgets twee keer geïnstalleerd is]] (Engles)
* Hoe [[How_to_uninstall_wxWidgets|wxWidgets te verwijderen]] (Engles)
* Over [[webcache]] (Engles)
* Gebruiker [[geaiez]] (Engles)
* Enkele [[reviews|recencies]] (Engles)
* Test [[test port|uw poorten]] (Engles)
* Lees [[current events|huidige gebeurtenissen]] (Engles)
* Bekijk de [[releases|release grafieken]] (Engles)
* Onze [[forum rules|forum regels]] (Engles)
* Onze [[IRC rules|IRC regels]] (Engles)
* Hoe [[aMule:Help|een Wiki pagina bewerken]] (Engles)
* Join [[frappr!]] (Engles)

== Veranderingen: ==
* [[Changelog_latest|Laatste aMule versie]]
* [[Changelog 2.1_series|aMule 2.1.X]]
** [[Changelog 2.1.0|aMule 2.1.0]]
** [[Changelog 2.1.1|aMule 2.1.1]]
** [[Changelog 2.1.2|aMule 2.1.2]]
** [[Changelog 2.1.3|aMule 2.1.3]]
* [[Changelog 2.0_series|aMule 2.0.X]]
* [[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="15px" | ||
| valign="top" |
== Gebruik ==
* Help [[Getting_Started-nl|Beginnen met aMule]]
* Help [[Usage aMule|gebruik van aMule]] (Engles)
* Help [[AMule_problems-nl|Veel voorkomende problemen]]
* Help [[Mac specific usage]] (Engles)
* Help [[aMule_is_slow-nl|aMule is langzaam]]?
* Help [[aMule_makes_everything_slow-nl|aMule vertraagt alles]]?
* Info [[aMule files-nl|aMule's bestanden]]
* HOE [[How_to_use_auxiliary_server_ports-nl|ongewone server poorten te gebruiken]]

== FAQs: ==
* FAQ [[FAQ_aMule-nl|over aMule]]
* FAQ [[FAQ_utils|over aMule's extra programma's]] (Engles)
* FAQ [[FAQ_eD2k-Kademlia-nl|over ED2K-Kademlia]]
* FAQ [[FAQ_network|over Overdracht Snelheden op het eDonkey Netwerk]] (Engles)

== Instelingen tips ==
* Hoe [[migrate from eMule to aMule|overstappen van eMule naar aMule]] (Engles)
* Hoe [[Ed2k links handling-nl|ed2k:// links afhandelen]]
* Hoe [[Debian_fonts|lettertype problemen in Debian oplossen]] (Engles)
* Hoe [[import-export files|bestanden im- en exporteren]] (Engles)
* Hoe [[get HighID|een Hoog ID te krijgen]] (Engles)
* Hoe [[Firewall|iptables instellen voor aMule]] (Engles)
* Hoe [[keep a safe list of servers|een veilige lijst met servers te houden]] (Engles)
* Hoe [[aMuleWeb|aMule's Webserver instellen]] (Engles)

== Ontwikkeling ==
* Download de laatste [[aMule SVN]] (Engles)
* Download de laatste [[Win32_binary|Windows aMule Installer]] (Engles)
* Over het [[aMule_devs|Ontwikkelings Team]] en [[aMule_devs#Helping|u erbij aansluiten]]
* Hoe [[Backtraces|zinvolle backtraces maken]] (Engles)
* Hoe [[Using gdb and valgrind|GDB en Valgrind gebruiken]] (Engles)
* Hoe [[Using_another_wxinstall|meer dan een wxWidgets gebruiken]] (Engles)
* Regels van [[Coding Style|de programmeer stijl]] (Engles)
* Draaien van een [[testing field|test]] (Engles)
* HOE [[Bug report|Een bug melden]] (Engles)
* De [[GNU_FDL|GNU General Public License]] (Engles)

== Vertalingen ==
* Hoe [[Translations|aMule te vertalen in uw taal]] (Engles)
* Hoe [[Translating Wiki-nl|deze Wiki vertalen]]
|}
|}

Main Page-es

2009-06-30T13:59:05Z

Wuischke: Clean up languages and add remark where translation is missing.

__NOTOC__

{|
| align="center" | <h1>Bienvenido al [http://wiki.org/wiki.cgi?WhatIsWiki Wiki] del [[AMule|Proyecto aMule]]</h1>
{|
| td align="center" |
¡Esperamos que encontreis aquí las respuestas a vuestras consultas!
|-
| align="right" | ''-- El [[aMule_devs|equipo de aMule]] --''
|-
| align="center" | <h3>[[Main Page|English]] | '''Español''' | [[Main_Page-nl|Nederlands]] | [[Main_Page-ko_KR|Korean]] | [[Main_Page-de|Deutsch]] | [[Main Page-fr|Français]] | [[Main Page-ru|Russian]] | [[Main Page-it|Italiano]] | [[Main Page-pl|Polish]]</h3>
|}
|-
{|
| valign="top" |
== Instalación ==
* Como [[Compilation Installation|compilar/instalar aMule desde cero]] (Inglés)
* Como [[Install-amule-freebsd|compilar aMule en FreeBSD]] (Inglés)
* Como [[HowTo_compile_on_Mac-es|compilar aMule en Mac]]
* Como [[HowTo_compile_on_Solaris|compilar aMule en Solaris]] (Inglés)
* Como [[HowTo compile on Win32 new|compilar aMule en Windows]] (Inglés)
* Como [[HowTo_Compile_In_Debian-es|compilar aMule en Debian o Ubuntu]]
* Como [[HowTo_Compile_In_Gentoo-es|compilar aMule en Gentoo]]
* Como [[HowTo_Compile_In_Slackware|compilar aMule en Slackware]] (Inglés)
* Como [[HowTo_Compile_In_RedHat-Fedora|compilar aMule en RedHat/Fedora]] (Inglés)
* Como [[HowTo_Compile_In_MDK-es|compilar aMule en Mandrake 10]]
* Como [[HowTo_Compile_aMuled-es|compilar aMule daemon (aMuled)]]
* Como [[HowTo_get_aMule_web_interface|Instalar aMuleWeb]] (Inglés)

== Otros ==
* Acerca de [[aMule-es|las funciones de aMule]]
* Lista de [[Requirements|requisitos]] (Inglés)
* [[Fake servers|servidores falsos]] (Inglés)
* Como [[How_to_launch_VNC_with_aMule_at_Linux_boot|ejecutar VNC con aMule durante el arranque de Linux]] (Inglés)
* Como [[Check if wx is installed twice-es|saber si wxWidgets está instalado por duplicado]]
* Como [[How_to_uninstall_wxWidgets-es|eliminar wxWidgets]]
* Utilizando [[wx-cvs-es|wxWidgets CVS]]
* Sobre el [[webcache]] (Inglés)
* Usuario [[geaiez-es|geaiez]]
* Algunas [[reviews|revisiones]] (Inglés)
* Test [[test port|de puertos]] (Inglés)
* Lee los [[current events-es|eventos actuales]]
* Ver [[Releases|gráfico de versiones]] (Inglés)
* Nuestras [[forum rules|normas en los foros]] (Inglés)
* Nuestras [[IRC rules|normas en el IRC]] (Inglés)
* Como [[aMule:Help|editar un artículo de este Wiki]] (Inglés)
* Join [[frappr!]] (Inglés)

== Changelogs: ==
* [[Changelog_latest|Última versión de aMule]]
* [[Changelog 2.1_series|aMule 2.1.X]]
** [[Changelog 2.1.0|aMule 2.1.0]]
** [[Changelog 2.1.1|aMule 2.1.1]]
** [[Changelog 2.1.2|aMule 2.1.2]]
** [[Changelog 2.1.3|aMule 2.1.3]]
* [[Changelog 2.0_series|aMule 2.0.X]]
* [[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="15px" | || valign="top" |
== Utilización ==
* Ayuda [[Getting_Started-es|Iniciandose con aMule]]
* Aprender a [[Usage aMule|usar aMule]] (Inglés)
* Ayuda [[aMule_problems-es|Problemas comunes]]
* Ayuda [[Mac specific usage|uso específico para Mac]] (Inglés)
* Ayuda ¿[[aMule is slow-es|aMule va lento]]?
* Ayuda ¿[[aMule makes everything slow-es|aMule hace que todo vaya lento]]?
* Info [[aMule files|Archivos de aMule]] (Inglés)
* Como [[How_to_use_auxiliary_server_ports-es|usar puertos auxiliares de servidores]]

== FAQs: ==
* FAQ [[FAQ_aMule-es|sobre aMule]]
* FAQ [[FAQ_utils-es|sobre las utilidades de aMule]]
* FAQ [[FAQ eD2k-Kademlia-es|sobre ED2K-Kademlia]]
* FAQ sobre [[FAQ_network|velocidad en la red eDonkey]] (Inglés)

== Configuración ==
* Como [[Migrate from eMule to aMule|migrar de eMule a aMule]] (Inglés)
* Como [[Ed2k links handling|soportar los enlaces ed2k://]] (Inglés)
* Como [[Debian_fonts-es|solucionar problemas con las fuentes en Debian]]
* Como [[import-export files|importar-exportar archivos]] (Inglés)
* Como [[Get HighID|conseguir ID alta]] (Inglés)
* Como [[Firewall-es|configurar iptables para aMule]] (Inglés)
* Como [[Keep a safe list of servers-es|mantener una buena lista de servidores]]
* Como [[aMuleWeb|configurar el servidor web de aMule]] (Inglés)

== Desarrollo ==
* Consigue el último [[aMule SVN-es|aMule SVN]]
* Consigue el último [[Win32_binary|Instalador de aMule para Windows]] (Inglés)
* Sobre el [[aMule_devs|Equipo de Desarrollo]] y [[aMule_devs#Helping|como unirse a él]]
* Como [[Backtraces|crear backtraces útiles]] (Inglés)
* Como [[Using gdb and valgrind|usar GDB y Valgrind]] (Inglés)
* Como [[Using_another_wxinstall-es|usar más de un wxWidgets]]
* Ejecutando un [[testing field|campo de pruebas]] (Inglés)
* Como [[Bug report|informar de un bug]] (Inglés)
* La [[GNU_FDL|Licencia GPL]] (Inglés)

== Traducciones ==
* Como [[Translations-es|traducir aMule a tu propìo lenguaje]]
* Como [[Translating Wiki-es|traducir este Wiki]]

Main Page

2009-06-30T13:53:31Z

Wuischke:

Main Page

2009-06-30T13:46:45Z

Wuischke:

__NOTOC__

{| width="100%"
| align="center" |
''We have more than '''15,000,000 article reads'''. Thanks to everyone for contributing!''
|-
| align="center" |

<h1>Welcome to the [http://wiki.org/wiki.cgi?WhatIsWiki Wiki] of the [[aMule|aMule Project]]</h1>
{| align="center" width="100%"
| 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]] | [[Main_Page-de|Deutsch]] | [[Main Page-fr|Français]] | [[Main Page-ru|Russian]] | [[Main Page-it|Italiano]] | [[Main Page-pl|Polish]] | [[Main Page-tw|正體中文]]</h3>
|}
|-
| align="left" |
{| width="100%"
| valign="top" |
== Installation ==
* HOWTO [[Compilation Installation|Compile and install aMule from sources]] ([[Compilation Installation-fr|French]]) ([[Compilation Installation-nl|Dutch]]) ([[Compilation Installation-br|Portuguese]]) ([[Compilation Installation-de|German]]) ([[Compilation Installation-ru|Russian]]) ([[Compilation Installation-it|Italian]]) ([[Compilation Installation-es|Spanish]])
* HOWTO [[Install-amule-freebsd|Compile aMule on FreeBSD]]
* HOWTO [[HowTo_compile_on_Mac|Compile aMule on Mac]] ([[HowTo_compile_on_Mac-de|German]]) ([[HowTo_compile_on_Mac-fr|French]]) ([[HowTo_compile_on_Mac-es|Spanish]])
* HOWTO [[HowTo_compile_on_Solaris|Compile aMule on Solaris]] ([[HowTo_compile_on_Solaris-de|German]])
* HOWTO [[HowTo compile on Win32 new|Compile aMule for Windows]] ([[HowTo compile on Win32-de|German]]) ([[HowTo compile on Win32-fr|French]])
* HOWTO [[HowTo compile with Visual Studio|Compile aMule on Windows with Visual Studio]]
* HOWTO [[HowTo_Compile_In_Debian|Compile aMule on Debian or Ubuntu]] ([[HowTo_Compile_In_Debian-es|Spanish]]) ([[HowTo_Compile_In_Debian-de|German]])
* HOWTO [[HowTo_Compile_In_Gentoo|Compile aMule on Gentoo]] ([[HowTo_Compile_In_Gentoo-de|German]]) ([[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_MDK|Install aMule on Mandrake 10]] ([[HowTo_Compile_In_MDK-es|Spanish]]) ([[HowTo Compile In MDK-fr|French]])
* HOWTO [[HowTo_Compile_aMuled|Compile the aMule daemon (aMuled)]] ([[HowTo Compile aMuled-es|Spanish]]) ([[HowTo Compile aMuled-nl|Dutch]]) ([[HowTo Compile aMuled-de|German]])
* HOWTO [[HowTo_get_aMule_web_interface|Install aMuleWeb]] ([[HowTo_get_aMule_web_interface-no|Norwegian]]) ([[HowTo_get_aMule_web_interface-de|German]])

== Other ==
* About [[AMule|aMule's features]] ([[aMule-hu|Hungarian]]) ([[aMule-es|Spanish]]) ([[aMule-de|German]]) ([[aMule-it|Italian]])
* aMule [[requirements]] ([[Requirements-de|German]]) ([[Requirements-it|Italian]]) ([[Requirements-es|Spanish]])
* [[Fake servers]] ([[Fake_servers-de|German]]) ([[Fake_servers-it|Italian]])
* 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-es|Spanish]]) ([[Check_if_wx_is_installed_twice-de|German]])
* HOWTO [[How_to_uninstall_wxWidgets|Uninstall wxWidgets]] ([[How to uninstall wxWidgets-es|Spanish]]) ([[How_to_uninstall_wxWidgets-de|German]])
* [[skins|Skin support]] in aMule
* Get [[wx-cvs|wxWidgets CVS]] ([[Wx-cvs-es|Spanish]]) ([[Wx-cvs-de|German]]) ([[Wx-cvs-it|Italian]])
* About [[webcache]]
* User [[geaiez]] ([[Geaiez-es|Spanish]]) ([[Geaiez-de|German]])
* Some [[reviews]]
* Test [[test port|your ports]] ([[Test port-de|German]])
* Read [[current events]] ([[current events-es|Spanish]])
* Watch the [[Releases|release graphs]] ([[Releases-de|German]])
* Our [[forum rules]]
* Our [[IRC rules]]
* HOWTO [[aMule:Help|Edit a Wiki page]] ([[aMule:Help-de|German]])
* Join [[frappr!]] ([[frappr!-de|German]])

== Changelogs ==
* [[Changelog_latest|Latest aMule release]]
* [[Changelog_2.2_series|aMule 2.2.X]]
** [[Changelog_2.2.5|aMule 2.2.5]]
** [[Changelog_2.2.4|aMule 2.2.4]]
** [[Changelog_2.2.3|aMule 2.2.3]]
** [[Changelog_2.2.2|aMule 2.2.2]]
** [[Changelog_2.2.1|aMule 2.2.1]]
* [[Changelog 2.1_series|aMule 2.1.X]]
* [[Changelog 2.0_series|aMule 2.0.X]]
* [[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]]) ([[Getting Started-ru|Russian]]) ([[Getting Started-da|Dansk]])
* Help [[Usage aMule|using aMule]] ([[Usage aMule-fr|French]])
* Help [[aMule_problems|Common problems]] ([[aMule_problems-es|Spanish]]) ([[AMule_problems-nl|Dutch]]) ([[AMule_problems-hu|Hungarian]]) ([[aMule_problems-de|German]])
* Help [[Mac specific usage]] ([[Mac specific usage-fr|French]])
* 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]]) ([[AMule makes everything slow-de|German]])
* 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]]) ([[How_to_use_auxiliary_server_ports-de|German]]) ([[How_to_use_auxiliary_server_ports-no|Norwegian]]) ([[How_to_use_auxiliary_server_ports-es|Spanish]])

== 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 aMule-ru|Russian]])
* FAQ [[FAQ_utils|on aMule's utilities]] ([[FAQ_utils-es|Spanish]]) ([[FAQ_utils-de|German]]) ([[FAQ_utils-it|Italian]])
* FAQ [[FAQ eD2k-Kademlia|on ED2K-Kademlia]] ([[FAQ eD2k-Kademlia-es|Spanish]]) ([[FAQ eD2k-Kademlia-it|Italian]]) ([[FAQ eD2k-Kademlia-de|German]]) ([[FAQ_ed2k-fr|French]]) ([[FAQ_eD2k-Kademlia-nl|Dutch]]) ([[FAQ_eD2k-Kademlia-pl|Polish]]) ([[FAQ_eD2k-Kademlia-ru|Russian]])
* 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]] ([[Ed2k links handling-de|German]]) ([[Ed2k links handling-nl|Dutch]]) ([[Ed2k_links_handling-ko_KR|Korean]])
* HOWTO [[Debian_fonts|Address font issue on Debian]] ([[Debian_fonts-es|Spanish]])
* HOWTO [[import-export files|Import and export files]] ([[import-export files-de|German]])
* HOWTO [[Get HighID]] ([[Get HighID-de|German]]) ([[Get HighID-es|Spanish]])
* HOWTO [[Firewall|Setup firewall rules for aMule]] ([[Firewall-de|German]]) ([[Firewall-es|Spanish]])
* HOWTO [[Keep a safe list of servers]] ([[Keep a safe list of servers-de|German]]) ([[Keep_a_safe_list_of_servers-es|Spanish]])
* HOWTO [[aMuleWeb|Setup aMule's Webserver (aMuleWeb)]]

== Development ==
* Download the latest [[aMule SVN]] ([[AMule SVN-es|Spanish]]) ([[AMule SVN-de|German]])
* 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]])
* Documentation of the [[EC_Procotol_HOWTO|EC protocol]]
* Rules of [[Coding Style|coding style]]
* Running a [[testing field]] ([[testing field-de|German]])
* HOWTO [[Bug report|Report a bug]]
* The [[GNU_FDL|GNU General Public License]]

== Translations ==
* HOWTO [[Translations|Translate aMule into your native language]] ([[Translations-pt|Portuguese]]) ([[Translations-ko_KR|Korean]]) ([[Translations-ru|Russian]]) ([[Translations-cn|Chinese]]) ([[Translations-es|Spanish]])
* HOWTO [[Translating Wiki|Translate this Wiki]] ([[Translating Wiki-pt_BR|Portuguese]]) ([[Translating Wiki-es|Spanish]]) ([[Translating Wiki-de|German]]) ([[Translating Wiki-fr|French]]) ([[Translating_Wiki-it|Italian]]) ([[Translating_Wiki-da|Dansk]]) ([[Translating_Wiki-ru|Russian]])

== Reorganization ==
* [[Wiki reorganization]]
|}
|}

Main Page

2009-06-30T13:45:13Z

Wuischke:

__NOTOC__

{| width="100%"
| align="center" |
''aMule Wiki reached the '''10,000,000 article reads''' milestone. Thanks to all of you!''
|-
| align="center" |

<h1>Welcome to the [http://wiki.org/wiki.cgi?WhatIsWiki Wiki] of the [[aMule|aMule Project]]</h1>
{| align="center" width="100%"
| 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]] | [[Main_Page-de|Deutsch]] | [[Main Page-fr|Français]] | [[Main Page-ru|Russian]] | [[Main Page-it|Italiano]] | [[Main Page-pl|Polish]] | [[Main Page-tw|正體中文]]</h3>
|}
|-
| align="left" |
{| width="100%"
| valign="top" |
== Installation ==
* HOWTO [[Compilation Installation|Compile and install aMule from sources]] ([[Compilation Installation-fr|French]]) ([[Compilation Installation-nl|Dutch]]) ([[Compilation Installation-br|Portuguese]]) ([[Compilation Installation-de|German]]) ([[Compilation Installation-ru|Russian]]) ([[Compilation Installation-it|Italian]]) ([[Compilation Installation-es|Spanish]])
* HOWTO [[Install-amule-freebsd|Compile aMule on FreeBSD]]
* HOWTO [[HowTo_compile_on_Mac|Compile aMule on Mac]] ([[HowTo_compile_on_Mac-de|German]]) ([[HowTo_compile_on_Mac-fr|French]]) ([[HowTo_compile_on_Mac-es|Spanish]])
* HOWTO [[HowTo_compile_on_Solaris|Compile aMule on Solaris]] ([[HowTo_compile_on_Solaris-de|German]])
* HOWTO [[HowTo compile on Win32 new|Compile aMule for Windows]] ([[HowTo compile on Win32-de|German]]) ([[HowTo compile on Win32-fr|French]])
* HOWTO [[HowTo compile with Visual Studio|Compile aMule on Windows with Visual Studio]]
* HOWTO [[HowTo_Compile_In_Debian|Compile aMule on Debian or Ubuntu]] ([[HowTo_Compile_In_Debian-es|Spanish]]) ([[HowTo_Compile_In_Debian-de|German]])
* HOWTO [[HowTo_Compile_In_Gentoo|Compile aMule on Gentoo]] ([[HowTo_Compile_In_Gentoo-de|German]]) ([[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_MDK|Install aMule on Mandrake 10]] ([[HowTo_Compile_In_MDK-es|Spanish]]) ([[HowTo Compile In MDK-fr|French]])
* HOWTO [[HowTo_Compile_aMuled|Compile the aMule daemon (aMuled)]] ([[HowTo Compile aMuled-es|Spanish]]) ([[HowTo Compile aMuled-nl|Dutch]]) ([[HowTo Compile aMuled-de|German]])
* HOWTO [[HowTo_get_aMule_web_interface|Install aMuleWeb]] ([[HowTo_get_aMule_web_interface-no|Norwegian]]) ([[HowTo_get_aMule_web_interface-de|German]])

== Other ==
* About [[AMule|aMule's features]] ([[aMule-hu|Hungarian]]) ([[aMule-es|Spanish]]) ([[aMule-de|German]]) ([[aMule-it|Italian]])
* aMule [[requirements]] ([[Requirements-de|German]]) ([[Requirements-it|Italian]]) ([[Requirements-es|Spanish]])
* [[Fake servers]] ([[Fake_servers-de|German]]) ([[Fake_servers-it|Italian]])
* 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-es|Spanish]]) ([[Check_if_wx_is_installed_twice-de|German]])
* HOWTO [[How_to_uninstall_wxWidgets|Uninstall wxWidgets]] ([[How to uninstall wxWidgets-es|Spanish]]) ([[How_to_uninstall_wxWidgets-de|German]])
* [[skins|Skin support]] in aMule
* Get [[wx-cvs|wxWidgets CVS]] ([[Wx-cvs-es|Spanish]]) ([[Wx-cvs-de|German]]) ([[Wx-cvs-it|Italian]])
* About [[webcache]]
* User [[geaiez]] ([[Geaiez-es|Spanish]]) ([[Geaiez-de|German]])
* Some [[reviews]]
* Test [[test port|your ports]] ([[Test port-de|German]])
* Read [[current events]] ([[current events-es|Spanish]])
* Watch the [[Releases|release graphs]] ([[Releases-de|German]])
* Our [[forum rules]]
* Our [[IRC rules]]
* HOWTO [[aMule:Help|Edit a Wiki page]] ([[aMule:Help-de|German]])
* Join [[frappr!]] ([[frappr!-de|German]])

== Changelogs ==
* [[Changelog_latest|Latest aMule release]]
* [[Changelog_2.2_series|aMule 2.2.X]]
** [[Changelog_2.2.5|aMule 2.2.5]]
** [[Changelog_2.2.4|aMule 2.2.4]]
** [[Changelog_2.2.3|aMule 2.2.3]]
** [[Changelog_2.2.2|aMule 2.2.2]]
** [[Changelog_2.2.1|aMule 2.2.1]]
* [[Changelog 2.1_series|aMule 2.1.X]]
* [[Changelog 2.0_series|aMule 2.0.X]]
* [[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]]) ([[Getting Started-ru|Russian]]) ([[Getting Started-da|Dansk]])
* Help [[Usage aMule|using aMule]] ([[Usage aMule-fr|French]])
* Help [[aMule_problems|Common problems]] ([[aMule_problems-es|Spanish]]) ([[AMule_problems-nl|Dutch]]) ([[AMule_problems-hu|Hungarian]]) ([[aMule_problems-de|German]])
* Help [[Mac specific usage]] ([[Mac specific usage-fr|French]])
* 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]]) ([[AMule makes everything slow-de|German]])
* 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]]) ([[How_to_use_auxiliary_server_ports-de|German]]) ([[How_to_use_auxiliary_server_ports-no|Norwegian]]) ([[How_to_use_auxiliary_server_ports-es|Spanish]])

== 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 aMule-ru|Russian]])
* FAQ [[FAQ_utils|on aMule's utilities]] ([[FAQ_utils-es|Spanish]]) ([[FAQ_utils-de|German]]) ([[FAQ_utils-it|Italian]])
* FAQ [[FAQ eD2k-Kademlia|on ED2K-Kademlia]] ([[FAQ eD2k-Kademlia-es|Spanish]]) ([[FAQ eD2k-Kademlia-it|Italian]]) ([[FAQ eD2k-Kademlia-de|German]]) ([[FAQ_ed2k-fr|French]]) ([[FAQ_eD2k-Kademlia-nl|Dutch]]) ([[FAQ_eD2k-Kademlia-pl|Polish]]) ([[FAQ_eD2k-Kademlia-ru|Russian]])
* 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]] ([[Ed2k links handling-de|German]]) ([[Ed2k links handling-nl|Dutch]]) ([[Ed2k_links_handling-ko_KR|Korean]])
* HOWTO [[Debian_fonts|Address font issue on Debian]] ([[Debian_fonts-es|Spanish]])
* HOWTO [[import-export files|Import and export files]] ([[import-export files-de|German]])
* HOWTO [[Get HighID]] ([[Get HighID-de|German]]) ([[Get HighID-es|Spanish]])
* HOWTO [[Firewall|Setup firewall rules for aMule]] ([[Firewall-de|German]]) ([[Firewall-es|Spanish]])
* HOWTO [[Keep a safe list of servers]] ([[Keep a safe list of servers-de|German]]) ([[Keep_a_safe_list_of_servers-es|Spanish]])
* HOWTO [[aMuleWeb|Setup aMule's Webserver (aMuleWeb)]]

== Development ==
* Download the latest [[aMule SVN]] ([[AMule SVN-es|Spanish]]) ([[AMule SVN-de|German]])
* 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]])
* Documentation of the [[EC_Procotol_HOWTO|EC protocol]]
* Rules of [[Coding Style|coding style]]
* Running a [[testing field]] ([[testing field-de|German]])
* HOWTO [[Bug report|Report a bug]]
* The [[GNU_FDL|GNU General Public License]]

== Translations ==
* HOWTO [[Translations|Translate aMule into your native language]] ([[Translations-pt|Portuguese]]) ([[Translations-ko_KR|Korean]]) ([[Translations-ru|Russian]]) ([[Translations-cn|Chinese]]) ([[Translations-es|Spanish]])
* HOWTO [[Translating Wiki|Translate this Wiki]] ([[Translating Wiki-pt_BR|Portuguese]]) ([[Translating Wiki-es|Spanish]]) ([[Translating Wiki-de|German]]) ([[Translating Wiki-fr|French]]) ([[Translating_Wiki-it|Italian]]) ([[Translating_Wiki-da|Dansk]]) ([[Translating_Wiki-ru|Russian]])

== Reorganization ==
* [[Wiki reorganization]]
|}
|}

HowTo compile on Win32

2009-06-30T13:45:07Z

Wuischke:

= Environments =
== MS Visual Studio ==
See [[HowTo_compile_with_Visual_Studio]] for information about compilation with MS VS.
== Compile from Linux ==
See [[Cross-compilation for windows with mingw]] for details about cross-compiling from Linux.
== MinGW ==
This tutorial focuses on the free MinGW environment for Windows, tested on Vista Business 32bit.
= Requirements =
== MinGW environment ==
Start by downloading [http://sourceforge.net/project/showfiles.php?group_id=2435&package_id=240780 the latest MinGW Installer].
Select to download and install, accept the licence, use the current package and select the MinGW base tools and g++ compiler packages.
Select an installation path, but try to avoid spaces in the path name. Wait for the download and installation to finish.

Then download [http://sourceforge.net/project/showfiles.php?group_id=2435&package_id=24963 the current MSYS release] and install it. In the post installation configuration, put the path to your existing mingw installation.

Go to the [http://sourceforge.net/project/showfiles.php?group_id=2435 MinGW download page] and download the latest 'gettext-devel-0.16.1-MSYS' and 'zlib-1.2.3-MSYS' packages and extract them to your MSYS path.
== wxWidgets ==

Download the latest wxMSW package in zip format from [http://wxwidgets.org/downloads/ the wxWidgets download page]. I recomment to extract it to your MSYS home directory, for instance C:\MSYS\1.0\home\''user''.

Now open the MSYS shell, change your working directory to your wxWidgets directory and execute
./configure --disable-debug --enable-optimize --enable-unicode
make
make install
to compile and install wxwidgets.

If you get a permission denied error when issuing "make install", see [http://sourceforge.net/tracker/index.php?func=detail&aid=1711379&group_id=2435&atid=102435 this page] for a fix.

Cross-compilation for windows with mingw

2009-06-30T13:41:41Z

Wuischke: Make it prettier

= Introduction =

If you know how to compile everything on Linux, there's not much new to learn.

Two things are important:
* use the cross-compile toolchain (i.e. i486-mingw32-gcc instead of gcc and i486-mingw32-ranlib instead of ranlib)
* use the headers and libraries for the target system

If something goes wrong, you can expect one of these two points to be the culprit. Wrong/different headers or additional libraries (like ws2_32 for sockets) are another major source of trouble.

Most software using autotools will compile using ./configure --host=i486-mingw32; other software may require further changes.

= Compilation step-by-step =

== Installing mingw32 ==

=== Arch ===
pacman -S mingw32-{binutils,gcc,runtime,w32api}
=== Debian/Ubuntu ===
aptitude install mingw32{,-binutils,-runtime}

== Setting environment variables ==

The value for TARGET depends on mingw32, it's i486-mingw32 for arch and i586-mingw32msvc for Debian.

export TARGET=i486-mingw32
#export TARGET=i586-mingw32msvc

Set a directory for building aMule. These two export commands have to be once in every terminal used to execute other command blocks shown here.

export BUILDDIR=$HOME/mingw32

== Prepare build directory ==

mkdir -p $BUILDDIR
mkdir -p $BUILDDIR/tmp

== Build zlib ==

cd $BUILDDIR
wget http://www.zlib.net/zlib-1.2.3.tar.gz
tar xzf zlib-1.2.3.tar.gz
cd zlib-1.2.3
CC=$TARGET-gcc AR="$TARGET-ar rc" RANLIB=$TARGET-ranlib ./configure --prefix=$BUILDDIR/tmp
make install

== Build libiconv ==

cd $BUILDDIR
wget http://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.13.tar.gz
tar xzf libiconv-1.13.tar.gz
cd libiconv-1.13
./configure --host=$TARGET --prefix=$BUILDDIR/tmp
make install

== Build gettext ==
(patch necessary)

cd $BUILDDIR
wget http://ftp.gnu.org/pub/gnu/gettext/gettext-0.17.tar.gz
tar xzf gettext-0.17.tar.gz
cd gettext-0.17
echo "29,30d28
< VARIABLE(rpl_optarg)
< VARIABLE(rpl_optind)
" | patch gettext-tools/woe32dll/gettextlib-exports.c
./configure --host=$TARGET --prefix=$BUILDDIR/tmp --with-libiconv-prefix=$BUILDDIR/tmp
make install

== Build wxwidgets ==

cd $BUILDDIR
wget http://prdownloads.sourceforge.net/wxwindows/wxWidgets-2.8.10.tar.bz2
tar xjf wxWidgets-2.8.10.tar.bz2
cd wxWidgets-2.8.10
./configure --host=$TARGET --prefix=$BUILDDIR/tmp --with-libiconv-prefix=$BUILDDIR/tmp --enable-unicode --disable-shared
make install

== Build cryptopp ==
quite some patching necessary

cd $BUILDDIR
wget http://cryptopp.com/cryptopp560.zip
mkdir cryptopp
cd cryptopp
unzip -a ../cryptopp560.zip
echo "71a72,73
> #include <malloc.h>
>
" | patch rijndael.cpp
echo "69d68
< LDFLAGS += -pthread" | patch GNUmakefile
echo "9c9
< RANLIB = ranlib
---
> RANLIB = $TARGET-ranlib" | patch GNUmakefile
CXX=$TARGET-g++ RANLIB=$TARGET-ranlib AR=$TARGET-ar LDLIBS=-lws2_32 make -f GNUmakefile
PREFIX=$BUILDDIR/tmp make -f GNUmakefile install

== aMule ==

cd $BUILDDIR
wget http://prdownloads.sourceforge.net/amule/aMule-2.2.5.tar.bz2
tar xjf aMule-2.2.5.tar.bz2
cd aMule-2.2.5
./configure --host=$TARGET --with-zlib=$BUILDDIR/tmp --with-wx-prefix=$BUILDDIR/tmp --with-wx-config=$BUILDDIR/tmp/bin/wx-config --with-crypto-prefix=$BUILDDIR/tmp --prefix=$BUILDDIR/tmp
make install

== Copying everything together ==

cd $BUILDDIR
mkdir pkg
cp /usr/$TARGET/bin/mingwm10.dll $BUILDDIR/pkg
cp $BUILDDIR/tmp/lib/*.dll $BUILDDIR/pkg
cp $BUILDDIR/tmp/bin/amule.exe $BUILDDIR/pkg

== Testing ==

cd $BUILDDIR/pkg
wine amule

== Stripping binaries ==

It significantly reduces the binary sizes, but you will loose debug information! So don't do it if you need to send crash reports to the aMule developers.

You need the cross-compile strip tool (for instance i686-mingw32-strip instead of strip).

cd $BUILDDIR/pkg
$TARGET-strip amule

Cross-compilation for windows with mingw

2009-06-29T20:51:18Z

Wuischke: First rought draft containing most important information, needs a lot of editing

If you know how to compile everything on Linux, there's not much new to learn.

Two things are important:
* use the cross-compile toolchain (i.e. i486-mingw32-gcc instead of gcc and i486-mingw32-ranlib instead of ranlib)
* use the headers and libraries for the target system

If something goes wrong, you can expect one of these two points to be the culprit. Wrong/different headers or additional libraries (like ws2_32 for sockets) are another major source of trouble.

Most software using autotools will compile using ./configure --host=i486-mingw32; other software may require further changes.

Install mingw32:

Arch:
pacman -S mingw32-{binutils,gcc,runtime,w32api}
Debian/Ubuntu:
aptitude install mingw32{,-binutils,-runtime}

The value for TARGET depends on mingw32, it's i486-mingw32 for arch and i586-mingw32msvc for Debian.

export TARGET=i486-mingw32
#export TARGET=i586-mingw32msvc

Set a directory for building aMule. These two export commands have to be once in every terminal used to execute other command blocks shown here.

export BUILDDIR=$HOME/mingw32

Prepare build directory:

mkdir -p $BUILDDIR
mkdir -p $BUILDDIR/tmp

Build zlib

cd $BUILDDIR
wget http://www.zlib.net/zlib-1.2.3.tar.gz
tar xzf zlib-1.2.3.tar.gz
cd zlib-1.2.3
CC=$TARGET-gcc AR="$TARGET-ar rc" RANLIB=$TARGET-ranlib ./configure --prefix=$BUILDDIR/tmp
make install

Build libiconv (needed for gettext)

cd $BUILDDIR
wget http://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.13.tar.gz
tar xzf libiconv-1.13.tar.gz
cd libiconv-1.13
./configure --host=$TARGET --prefix=$BUILDDIR/tmp
make install

Build gettext (patch needed)

cd $BUILDDIR
wget http://ftp.gnu.org/pub/gnu/gettext/gettext-0.17.tar.gz
tar xzf gettext-0.17.tar.gz
cd gettext-0.17
echo "29,30d28
< VARIABLE(rpl_optarg)
< VARIABLE(rpl_optind)
" | patch gettext-tools/woe32dll/gettextlib-exports.c
./configure --host=$TARGET --prefix=$BUILDDIR/tmp --with-libiconv-prefix=$BUILDDIR/tmp
make install

Build wxwidgets

cd $BUILDDIR
wget http://prdownloads.sourceforge.net/wxwindows/wxWidgets-2.8.10.tar.bz2
tar xjf wxWidgets-2.8.10.tar.bz2
cd wxWidgets-2.8.10
./configure --host=$TARGET --prefix=$BUILDDIR/tmp --with-libiconv-prefix=$BUILDDIR/tmp --enable-unicode --disable-shared
make install

Build cryptopp, quite some patching necessary.

cd $BUILDDIR
wget http://cryptopp.com/cryptopp560.zip
mkdir cryptopp
cd cryptopp
unzip -a ../cryptopp560.zip
echo "71a72,73
> #include <malloc.h>
>
" | patch rijndael.cpp
echo "69d68
< LDFLAGS += -pthread" | patch GNUmakefile
echo "9c9
< RANLIB = ranlib
---
> RANLIB = $TARGET-ranlib" | patch GNUmakefile
CXX=$TARGET-g++ RANLIB=$TARGET-ranlib AR=$TARGET-ar LDLIBS=-lws2_32 make -f GNUmakefile
PREFIX=$BUILDDIR/tmp make -f GNUmakefile install

And finally aMule:

cd $BUILDDIR
wget http://prdownloads.sourceforge.net/amule/aMule-2.2.5.tar.bz2
tar xjf aMule-2.2.5.tar.bz2
cd aMule-2.2.5
./configure --host=$TARGET --with-zlib=$BUILDDIR/tmp --with-wx-prefix=$BUILDDIR/tmp --with-wx-config=$BUILDDIR/tmp/bin/wx-config --with-crypto-prefix=$BUILDDIR/tmp --prefix=$BUILDDIR/tmp
make install

Copying everything together:

cd $BUILDDIR
mkdir pkg
cp /usr/$TARGET/bin/mingwm10.dll $BUILDDIR/pkg
cp $BUILDDIR/tmp/lib/*.dll $BUILDDIR/pkg
cp $BUILDDIR/tmp/bin/amule.exe $BUILDDIR/pkg

Testing:

cd $BUILDDIR/pkg
wine amule

FAQ aMule

2009-02-18T18:28:26Z

Wuischke:

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

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

aMule currently supports [http://www.kernel.org Linux], [http://www.freebsd.org FreeBSD], [http://www.openbsd.org OpenBSD], [http://www.microsoft.com Windows], [http://www.apple.com/macosx MacOS X] and [http://www.microsoft.com/xbox X-Box] on both [http://en.wikipedia.org/wiki/64-bit#32_vs_64_bit 32 and 64 bit] computers.

[[aMule]] is intended to be as user friendly and feature rich as [[eMule]] and to remain faithful to the look and feel of [[eMule]] so users familiar with either [[aMule]] or [[eMule]] will be able switch between the two easily.

Since [[aMule]] is based upon the [[eMule]] codebase, new features in [[eMule]] tend to find their way into [[aMule]] soon after their inclusion into [[eMule]] so users of [[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 whom are probably even more user friendly than [[aMule]] itself. Join us in #amule on irc.freenode.net or visit the [http://forum.amule.org aMule forums] if you have any suggestions, questions, problems, bugs, patches or anything else that you might think of.

If you are interested in joining the development team, please contact us via the [http://forum.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 the client) by right clicking on the client's nickname 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). In the same dialog window, if that client is in your upload queue, you'll be able to view the client's rate and score on you.

== What do those colors in the progress bar mean? ==
<u>In the downloading transfers list:</u>
*'''Red''' chunks have no sources on the current session.
*'''Blue''' chunks have at least one source availble; the darker the blue, the more sources are available.
*'''Yellow''' chunks are being downloaded at this very moment.
*'''Black''' chunks have already been downloaded and verified.
*'''Green''' progress bars have been completely downloaded and successfully verified (and so will be in your 'incoming folder').

<u>In the expanded transfers list (can be viewed by double-clicking a transfer):</u>
*'''Black''' chunks are those a client has and you don't.
*'''White''' chunks are those that client doesn't have.
*'''Green''' chunks are those both you and that client have.
*'''Yellow''' chunks are those that client is currently uploading to you.

<u>In the uploading transfers list:</u>
*'''Black''' chunks are those that client has completed and verified.
*'''Grey''' chunks are those that client doesn't have.

Not all clients support telling other clients what parts they have already completed when uploading, so some clients might have no bar at all.

<u>In the shared-files window:</u>
*'''Red''' chunks are those that have been found in any source apart from you.
*'''Blue''' chunks—the darker the blue, the more spread that chunk is.<br><br>

<u>On the search windows:</u>
*'''Black''' files have only one client.
*'''Blue''' files have two or more clients have; the darker the blue, the more clients have have it.
*'''Red''' files are already in the downloading queue.
*'''Green''' files are those which you are already sharing (i.e., you have 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). 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 number of sources available (the number of sources found that you can download from)
*'''YY''' stands for the number of sources found (the total number of sources found)
*'''ZZ''' stands for the number of "Asked for another file" sources
*'''WW''' stands for the number of sources from whom 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 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 ''Asked 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.

If a file has XX+ZZ sources, the ZZ sources might include some which have no needed parts. aMule will exclude those if you tell it to swap to the file.

== What do the "QR: xxxx" numbers mean that I see when I look at my sources? ==
QR stands for "Queue Rank" and it is your current position in this source's queue.

Obviously, a lower value is better. If the source is an eMule client and there is no QR number, it's likely that it's queue is full and cannot accept more clients.

== 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]] will try to connect to those sources.

Instead, when a transfer is stopped, all sources are dropped so, when it's resumed, [[aMule]] will start searching for clients who are sharing that file.

== What are all those files [[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]] and [[eMule]] are the program configuration (that is, preferences.ini in [[eMule]] and ''~/.aMule/amule.conf'' in [[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]] specific, such as ''amulesig.dat'' or ''aMule.tmpl'', so it's better to only move those files that are in both the [[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 these files can be found in the [[amulesig.dat_file|''amulesig.dat'' article]] and the [[onlinesig.dat_file|''onlinesig.dat'' article]].

== I just installed [[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]] and click on the Preferences button. Set a nickname and the language in which you wish to have [[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]] 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]] handle my [[xMule]] and [[lMule]] files? What should I do? ==
[[aMule]] automatically handles both [[lMule]] and [[xMule]]'s configuration files, but in different ways:

[[lMule]] has been discontinued for several years now, so [[aMule]] understands that you are replacing [[lMule]] with [[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]] has handled [[xMule]]'s configuration files, it will 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]] 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]] 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]] usage, join [[aMule]] #amule in irc.freenode.net or ask in forums at [http://forum.amule.org http://forum.amule.org]

== 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]] 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]]) and, once in, use amulecmd to take control over [[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]] 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]] 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]] 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]] 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]:'''<br>
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]] using [[aMuleCMD]] and [[ed2k_command|ed2k]] in the same way as you would if you were accessing [[aMule]] remotely over telnet (see above).

<u>Short example:</u>
#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]]: <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]] with the following command, so that only [[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]]'s [http://www.amule.org/amule forums] or join #amule [[IRC]] channel at irc.freenode.net and ask.

== Can I run two [[aMule]] instances at the same time? ==
Yes you can, although it is not recommended. [[aMule]] will only check if the concurrent user is running some [[aMule]] instance, so you can run as many [[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 that [[aMule]] can't check if a user is running [[aMule]] on another X display. So, if your account is already running some [[aMule]] instance in some other X display, do not run another [[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]] statistics some people post on the IRC channels? ==
You can either copy and paste [[CAS]]'s (C [[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]] 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]] 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://forum.amule.org/index.php?topic=1232.0
*http://forum.amule.org/index.php?topic=542.0
*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:<br>
Get ''cryptkey.dat'', ''clients.met'', ''preferences.dat'', ''preferencesKad.dat'', ''key_index.dat'', ''load_index.dat'' and ''src_index.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!

You might still want to take a look at the [[migrate from eMule to aMule]] article, though.

== Does aMule support Universal Plug and Play (UPnP)? ==

Yes, aMule versions since 2.2.1 support UPnP. UPnP is currently not supported on Windows.

== What's the story behind the [[rabbit]]? ==
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.

== When will next aMule release happen? ==
Whatever next release, the answer is always the same, it is standard: [[Soon]] (suggestion: follow the link).

Emulecollection

2009-02-07T10:36:50Z

Wuischke: aMule can do this, too.

== What is an emulecollection? ==

An emulecollection is a file which contains various (hence a collection of) ed2k links. This is usually used to group various related files, e.g. a series or a music album.

== aMule and emulecollections ==

Since aMule [[Changelog_2.2.0 | 2.2.0]], aMule opens emulecollection with the ed2k utility. The syntax is:
ed2k -e ''file.emulecollection''

In aMule shared files view, you can also right click on an emulecollection file and select ''Add files in collection to transfer list'' to open it.

== further reading ==

*[http://code.google.com/p/amule-emc/wiki/emulecollection technical information]
*[http://content.emule-project.net/ legal downloads with collections]

HowTo Compile In Debian/Ubuntu

2009-01-05T10:33:38Z

Wuischke:

<center>
'''English''' |
[[HowTo_Compile_In_Debian-de|Deutsch]] |
[[HowTo_Compile_In_Debian-es|Español]] |
[[HowTo_Compile_In_Debian-fr|Français]]
</center>

'''NOTE:''' This Manual also works for [http://www.ubuntulinux.com Ubuntu Linux].

See also general [[Compilation Installation]]

== Are you sure you want to compile? ==
If not, (which is pretty common) decide if you want the [[aMule]] stable release or the [[aMule CVS]] release.

== Debian ==

=== [[aMule]] stable release ===
You can just install latest stable [[aMule]] version through [http://packages.debian.org deb]s adding the following lines into your ''/etc/apt/sources.list'' file:

deb http://www.vollstreckernet.de/debian/ testing amule-stable wx

or

deb http://www.vollstreckernet.de/debian/ stable amule-stable wx

If you have wx from somewhere else, you can ommit it in theses lines, but don't cry if it won't work.

Now run <code>apt-get update && apt-get install amule</code>

For the packages in the repo and how to get the key, look into the next section.

=== [[aMule CVS]] release ===
You can also get the latest [[aMule CVS]] through debs adding the following line into your ''/etc/apt/sources.list'' file:

For Debian Testing (aka Lenny). In most cases this works for sid/unstable, too

deb http://www.vollstreckernet.de/debian/ testing amule

For Debian Stable (aka Etch)

deb http://www.vollstreckernet.de/debian/ stable amule

If you need a recent Version of wx (2.8 atm), just append '''" wx"''' to the lines above.
Be careful, between amule and wx is a space needed.
If you only want wx binaries installed, replace amule with wx.

packages are GPG signed, so follow this steps:
''gpg --keyserver wwwkeys.eu.pgp.net --recv 50D0AE60''
''gpg -a --export 50D0AE60 > /tmp/key''
''apt-key add /tmp/key'' (requires superuser privileges)

Another, shorter, method utilizing '''"sudo"''' is as follows:
''gpg --keyserver wwwkeys.eu.pgp.net --recv 50D0AE60''
''gpg -a --export 50D0AE60 | sudo apt-key add -''

Now run ''aptitude update && aptitude install amule''

You might also want to take a look at the other available [[aMule]] utilities:

'''[[aMule CVS]]'''

* amule
* amule-alc
* amule-alcc
* amule-alcc-dbg
* amule-alc-dbg
* amule-cas
* amule-cas-dbg
* amule-cmd
* amule-cmd-dbg
* amule-common
* amule-daemon
* amule-daemon-dbg
* amule-dbg
* amule-ed2k
* amule-ed2k-dbg
* amule-i18n-ar
* amule-i18n-bg
* amule-i18n-ca
* amule-i18n-da
* amule-i18n-de
* amule-i18n-en-gb
* amule-i18n-en-us
* amule-i18n-es
* amule-i18n-es-mx
* amule-i18n-et-ee
* amule-i18n-eu
* amule-i18n-fi
* amule-i18n-fr
* amule-i18n-gl
* amule-i18n-hr
* amule-i18n-hu
* amule-i18n-it
* amule-i18n-it-ch
* amule-i18n-ko-kr
* amule-i18n-nl
* amule-i18n-pl
* amule-i18n-pt-br
* amule-i18n-pt-pt
* amule-i18n-ru
* amule-i18n-sl
* amule-i18n-sv
* amule-i18n-tr
* amule-i18n-zh-cn
* amule-i18n-zh-tw
* amule-remote-gui
* amule-remote-gui-dbg
* amule-skin-gnome
* amule-skin-kde4
* amule-skin-tango
* amule-skin-xfce
* amule-theme-default
* amule-utils
* amule-utils-gui
* amuleweb
* amuleweb-dbg
* amule-wxcas
* amule-wxcas-dbg
* amule-xas

For example, if you think [[aMule]]'s [[AMuleWeb|Web interface]] rocks and you want to have it too, enter this line after the one above:

For [[aMule CVS]]: ''aptitude install amuleweb''

For [[aMule]] stable: ''aptitude install amule-console-utils''

If you still want to compile [[aMule]] instead of just installing a binary, keep reading...

== Ubuntu ==

=== Official ===

The latest stable versions of aMule are in the official [http://en.wikipedia.org/wiki/Software_repository Ubuntu repositories].

You can use [http://en.wikipedia.org/wiki/Synaptic_Package_Manager Synaptic Package Manager] (if you use [http://en.wikipedia.org/wiki/GNOME Gnome]) or [http://en.wikipedia.org/wiki/Adept_Manager Adept] (if you use [http://en.wikipedia.org/wiki/KDE KDE]). Then you must search and install '''amule''' package.

If you prefer to use the terminal, enter this command:

sudo aptitude install amule

If you prefer to download the aMule can do it manually from [http://packages.ubuntu.com/search?keywords=amule&searchon=names&suite=all&section=all this website]

==Info: What aMule release needs what wxwidgets release?==
* Debian Etch includes aMule 2.1.3 and wxwidgets 2.6.3

* aMule 2.1.x needs wxwidgets 2.6. You cannot compile it with newer versions of wxwidgets.
* aMule 2.2.x needs wxwidgets 2.8. You cannot compile it with older versions of wxwidgets.

==What developement packages do I need for compiling?==
For compiling [[aMule-CVS]] and [[aMule 2.2.0]] you need the following packages installed:

* libglib2.0-dev
* libgtk2.0-dev
* zlib1g-dev
* libwxgtk2.8-dev (if you compile wx by hand, this isn't needed. This package is atm only available for debian from Vollstreckers repository)
* libgd2-xpm-dev
* bison
* flex
* libreadline5-dev
* libgeoip-dev
* libupnp-dev
* libcrypto++-dev

==Preparing: Compiling and installing wxwidgets==
This algorithm works for all Debian flavours.

To compile aMule, You need to have a current version of [[wxWidgets]] installed. To achieve that:
Uninstall every possibly previously installed wxwidgets stuff (see [[How to uninstall wxWidgets]]
and [[Check if wx is installed twice]])
You need the following packages installed:

* flex
* bison
* gettext
* libgtk2.0-dev
* python-dev (>= 2.4.3)
* python-dbg
* zlib1g-dev
* libjpeg62-dev
* libpng12-dev
* libtiff4-dev
* libgl1-mesa-dev '''or''' libgl-dev
* libglu1-mesa-dev '''or''' libglu-dev
* libesd0-dev
* libgnomeprintui2.2-dev
* libgconf2-dev
* libgstreamer0.10-dev
* libgstreamer-plugins-base0.10-dev
* python-central
* bc

# Download current wxwidgets wxGTK stable release source code tar ball from <tt>http://www.wxwidgets.org/downloads/</tt>
# <tt>$ tar xvzf wxgtk-''version''.tar.gz</tt>
# <tt>$ cd wxGTK-''version''</tt>
# <tt>$ ./configure --prefix=/usr --with-gtk --enable-unicode --disable-compat24 --enable-optimise</tt>
# <tt>$ make</tt>
# <tt># make install</tt>
# <tt># ldconfig</tt>

$ = command executed with normal user account<br>
<nowiki>#</nowiki> = command executed with root account

==Compiling and installing aMule==
Now that You have installed current wxGTK, go on to compile aMule:
# Install the needed packages mentioned in '''"What developement packages do I need for compiling?"'''
# Download aMule source code tar ball from <tt>http://www.amule.org</tt> (note: For compiling aMule 2.1.3 you'll need a patch aviable [http://cvs.pld-linux.org/cgi-bin/cvsweb/SOURCES/aMule-wx.patch?rev=1.2 HERE]
# <tt>$ tar xvjf aMule-''version''.tar.bz2</tt>
# <tt>$ cd aMule-''version''</tt>
# To have a look what features of aMule You can enable or disable: <tt>$ ./configure --help</tt>
# You should be right with <tt>$ ./configure --disable-debug --enable-optimize</tt>
# <tt>$ make</tt>
# <tt># make install</tt>

$ = command executed with normal user account<br>
<nowiki>#</nowiki> = command executed with root account

That's it! Now You can start aMule with command "amule".

== Building your own debian packages ==
First you have to get a source tarball. Note, that only aMule-CVS and Releases of aMule 2.2.0 or later are able to build debain-packages directly.

First install all needed tools:

* build-essential
* debhelper
* libglib2.0-dev
* libgtk2.0-dev
* zlib1g-dev
* libwxgtk2.8-dev
* libgd2-xpm-dev
* bison
* flex
* libcrypto++-dev
* libreadline5-dev
* libgeoip-dev
* libupnp-dev
* devscripts

'''All commands after here are entered in the top-dir of the extracted aMule-source-tarball (usually .../amule-cvs or .../aMule-<version>)'''

Create a new changelog Entry with (the version in the changelog indicates the version your packages will get):
dch -v `date +%Y%m%d` New Upstream CVS Release
Now start the packages creation with:
dpkg-buildpackage -uc -b -rfakeroot
Now you have all created debian-packages in the parent dir of you source-dir and can install them with:
dpkg -i <package>
or build your own repository.

If you want to build just a few packages instead of all, you can obtain information about how this works with:
debian/rules help

== You're done... ==
That's it! Your own compiled [[aMule]] is installed on your system and ready to go.

To run [[aMule]], just type <code>"amule"</code>. You can check if everything worked by typing <code>"amule -v"</code> and check if the displayed version corresponds with the one you were compiling/installing.

If this HowTo didn't help, you have a rare problem on your system ;-) Take a look at http://www.amule.org (aMule Forums at http://forum.amule.org ) or visit us in #amule on irc.freenode.net and (don't doubt) we'll try to do our best to help you.

== Final notes ==
If you are in one of those rare cases when you wish to compile [[aMule]] statically, install also ''libtiff4-dev'' (through ''apt-get install libtiff4-dev''). Anyway, this is '''NOT''' recommended and, in fact, will probably not do any better or even, not work at all.

Known distribution problems

2008-12-25T11:37:06Z

Wuischke:

= Known distribution problems =

This is a list of known problems with distribution packages. If you encounter these problems with a fully patched version of your distribution, please file a bug report at your distribution's bug tracker.

Please note that these are '''not''' aMule bugs, but problems with distribution packages.

== General advise ==

Most crashes are related to crypto++ or wxwidgets. Rebuilding these packages from source usually solves crashes. Also make sure you are using the latest version of aMule.

=== crypto++ ===

Crypto++ uses some Assembler code, which might cause problems. Some compiler versions seem to produce crashing code when using optimisations.

Adding the options "-DCRYPTOPP_DISABLE_ASM" and "-O1" or "-O0" to CXXFlags in the GNUmakefile for crypto++ help to solve this issue. To do so, unpack the zip file with the sources to a new directory, open GNUmakefile and make the changes and type ''make'' in a terminal after changing into the source directory to compile. Now execute ''./cryptest.exe v'' in the source directory to test the library. If everything is OK, use ''make install'' with super user permissions to install the new version. Don't forget to recompile aMule afterwards.

crypto++ integrates a test suite called "cryptest.exe" on all systems. Executing "cryptest.exe v" in a terminal will run a verification test - if this test fails, the problem is most probably with crypto++.

== Known crashes ==

Please do '''not''' report crashes which contain one of the following lines in the backtrace printed after the crash. Make sure you use the latest packages and notify your distribution about these problems.

[23] CryptoPP::BufferedTransformation::ChannelPut2(std::string const&, unsigned char const*, unsigned long, int, bool) in amule[0x4489c9]

[21] CryptoPP::IteratedHash<unsigned int, CryptoPP::EnumToType<CryptoPP::ByteOrder, 0>, 64u, CryptoPP::HashTransformation>::~IteratedHash() in amule [0x5032b2]

[19] wxNotebook::SetPadding(wxSize const&) in amule[0x8085191]

Known distribution problems

2008-12-25T11:31:23Z

Wuischke:

= Known distribution problems =

This is a list of known problems with distribution packages. If you encounter these problems with a fully patched version of your distribution, please file a bug report at your distribution's bug tracker.

Please note that these are '''not''' aMule bugs, but problems with distribution packages.

== General advise ==

Most crashes are related to crypto++ or wxwidgets. Rebuilding these packages from source usually solves crashes. Also make sure you are using the latest version of aMule.

=== crypto++ ===

Crypto++ uses some Assembler code, which might cause problems. Some compiler versions seem to produce crashing code when using optimisations.

Adding the options "-DCRYPTOPP_DISABLE_ASM" and "-O1" or "-O0" to CXXFlags in the GNUMakefile for crypt++ help to solve this issue.

crypto++ integrates a test suite called "cryptest.exe" on all systems. Executing "cryptest.exe v" in a terminal will run a verification test - if this test fails, the problem is most probably with crypto++.

== Known crashes ==

Please do '''not''' report crashes which contain one of the following lines in the backtrace printed after the crash. Make sure you use the latest packages and notify your distribution about these problems.

[23] CryptoPP::BufferedTransformation::ChannelPut2(std::string const&, unsigned char const*, unsigned long, int, bool) in amule[0x4489c9]

[21] CryptoPP::IteratedHash<unsigned int, CryptoPP::EnumToType<CryptoPP::ByteOrder, 0>, 64u, CryptoPP::HashTransformation>::~IteratedHash() in amule [0x5032b2]

[19] wxNotebook::SetPadding(wxSize const&) in amule[0x8085191]

Translations

2008-12-05T22:31:12Z

Wuischke:

<center>
'''English''' |
[[Translations-cn|汉语]] |
[[Translations-de|Deutsch]] |
[[Translations-es|Español]] |
[[Translations-pt|Portugisisch]] |
[[Translations-ko_KR|Koreanisch]] |
[[Translations-ru|Russisch]]
</center>

== Introduction ==
Thanks for your interest in translating aMule. Becoming a translator isn't hard, you just need to understand common English and of course your native tongue.

The status of all translations are updated hourly at the [http://amule.uw.hu/translations/ Translation statistics page], that's an easy way to see if your work is needed. But you're always welcome to check an existing translation for errors or improve unfavourable expressions.

Before you start any work, please check [http://forum.amule.org/index.php?topic=13845.0 the translations list] for an entry for your language. If there's already someone working on the translation for your language, please reply to the forum topic for your language before you start working. It would be a shame to have two translators doing the same work, wouldn't it?
== Translate ==
=== Get Translation file ===
You can get current Portable Object (po) files for all supported languages at the [http://amule.uw.hu/translations/ Translation statistics page]. Just click on the name of your language and download the po-file.
==== Start a new translation ====
Your language isn't yet supported by aMule and you can't find a po-file at the statistics page? No problem, let's start a new translation! Either open a new topic in the [http://forum.amule.org/index.php?board=40.0 translations forum] to receive help with the translation process or create the po-file yourself:

To do so, please download the amule.pot file, which is linked at the bottom of the [http://amule.uw.hu/translations/ Translation statistics page]. Then you need [http://www.gnu.org/software/gettext/ gettext] installed on your system (comes by default with most operating systems) and the language code of your language. If you don't know the language code of your language, you should be able to find the code in the [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes list of language codes on Wikipedia]. If you've done so, use the following command to create the po-file:

msginit --input=amule.pot --locale=''language code''

If you decide to create your own po-file, please have a loot at the [[Translations#Plural_forms|Plural forms]] section of this page.
=== The translation process ===
Now that you've got the po-file, let's start with the actual translation process. There are several programs to help you with this task, like [http://www.poedit.net Poedit], [http://gtranslator.sourceforge.net/ gtranslator] or [http://kbabel.kde.org KBabel], but you can use your favourite text editor, too.

Here's a quick start for these editors, please refer to their respective home pages for a more extensive documentation.
==== Poedit ====
When you open a po-file in Poedit, you are greeted by a screen similar to the following:

http://img516.imageshack.us/img516/481/wikipoedit1ly7.png

In the bottom, you'll find statistics. Not translated strings are marked in shades of turquoise in the string list in the upper part, [[Translations#fuzzy_strings|fuzzy strings]] in brown-sand tones and translated strings in grey/white.

The actual translation takes part in the middle part of the window.

http://img253.imageshack.us/img253/5157/wikipoedit2ov3.png

You'll see the English source string at the top and the field to enter the translations below. Here's even a special case with plural forms. When you're done entering the translated page for one string you can go on by clicking on the next string to translate.

When you're done translating, continue with testing your translation.
==== KBabel ====
Another powerful editor is the KDE-based KBabel.

http://img512.imageshack.us/img512/3183/wikikbabel1my7.png

The user interface is customizable, but in the default view, you'll find the string list, the source string and the input field for translations on the left side. Statistical information are on the bottom, just as with Poedit.

http://img329.imageshack.us/img329/607/wikikbabel2fz0.png

By clicking on the ''Next [[Translations#fuzzy_strings|Fuzzy]] or Untranslated''-button in the toolbar, KBabel will jump directly to the next string in need of some work.

http://img329.imageshack.us/img329/9992/wikikbabel3uw7.png

The actual translation interface is very similar to Poedit, in the upper part you'll see the source string and below you can enter the translation.

==== Using a text editor ====
po-files are just text files and of course you can use any text editor to edit them. Popular editors Emacs and Vim both provide corresponding plugins.

The file format is pretty simple, but please refer to the [http://www.gnu.org/software/gettext/manual/gettext.html#PO-Files section in the gettext manual] for further information.

=== Test the translation ===
Use the following command to test a translation:

msgfmt -c --statistic ''language code''.po

Example output:

$ msgfmt -c --statistics ca.po
1428 translated messages, 58 [[Translations#fuzzy_strings|fuzzy]] translations, 32 untranslated messages.

Please refer to the [[Translations#Common_problems|Common problems]] section if any error messages appear. Don't hesitate to attach your po-file in the [http://forum.amule.org/index.php?board=40.0 translations forum] and ask for help, if you can't solve the problems yourself. I'll try to fix the problems and explain what went wrong.

=== Getting the translation into aMule ===
Find your language in [http://forum.amule.org/index.php?topic=13845.0 the translations list] and attach the po-file in a new reply to your language's topic (click on the language name to go to your language's topic).

If you can't find a topic for your language, just create a new one in the [http://forum.amule.org/index.php?board=40.0 translations forum].

== Common problems ==
=== fuzzy strings ===
Strings are marked fuzzy after a change of the source string of an already translated string. This just means that the translator should review the string and see if the change has any influence on the translation.

An example: "Delete server?" was replaced by "Do you really want to remove the server?". The content is the same and only the wording was changed. Depending on the translation there may be no changes necessary.
=== message compilation errors ===
After testing the translation, you get an error message. Here's a list of common errors and the solution:
* ''end-of-line within string''
** A string started by " (quotation marks) wasn't closed by another ". Take a look at the line number and close the string.
* ''format specifications in 'msgid' and 'msgstr' for argument 1 are not the same''
** You've probably noticed things like '%s' or '%d' in the source strings. These are later replaced by a variable, for instance a string for %s and an number for %d. Please check all your %-constructs in the translated string (use the line number in the error message to find the string) and see if they are the same as in the source string.
* ''number of format specifications in 'msgid' and 'msgstr' does not match''
** This is similar to above error. You don't have the same quantity of %-constructs in the source and translation. Check the translation, maybe you've forgotten one or you accidentally wrote '&s' when you meant '%s'
* ''`msgid' and `msgstr' entries do not both end with '\n'''
** '\n' is a new line in a string. You need the same number of new lines in the translation as in the source. Try to place them similar to the source string.

=== Plural forms ===

Plurals are handled differently in various languages. Whilst English or German have a singular and a plural form, other languages like Turkish don't distinguish between plural or singular and there are languages which use different plurals for different numbers, e.g. Polish.

The first thing you need is the appropriate header in your po-file. You'll find help in the [http://www.gnu.org/software/gettext/manual/gettext.html#Plural-forms gettext manual on plural forms] or the [http://translate.sourceforge.net/wiki/l10n/pluralforms list of plural forms]. If you have trouble to add the header, please ask in the [http://forum.amule.org/index.php?board=40.0 translations forum].

An example for German:

"Plural-Forms: nplurals=2; plural=n != 1;\n"

Plural forms are represented in the source as follows (extract from de.po for German):

#: src/kademlia/routing/RoutingZone.cpp:141
#, c-format
msgid "Read %u Kad contact"
msgid_plural "Read %u Kad contacts"
msgstr[0] "Lese %u Kad-Kontakt"
msgstr[1] "Lese %u Kad-Kontakte"

The first ''msgid'' is the source for the singular, the ''msgid_plural'' is the plural source. Note the index ''msgstr'' gets for plural strings. Each index is for a different plural form. In the case of German ''msgstr[0]'' is the singular string and ''msgstr[1]'' is used for plural forms.

This is similar for other languages. If you are in doubt about which index corresponds to which plural form, please ask in the [http://forum.amule.org/index.php?board=40.0 translations forum].
=== my program doesn't allow me to jump to a line ===
kpeace1 wrote a [http://forum.amule.org/index.php?topic=14699.msg77946#msg77946 script] which converts line numbers in error messages to msgids and makes easier.
#!/usr/bin/env python

import sys

if (len(sys.argv) < 3):
print "usage:\t", sys.argv[0], "file_name ", "line#"

file_name = sys.argv[1]
line_number = int(sys.argv[2])

po_file = open(file_name)
i = 0
msgid = 0

for line in po_file:
i = i + 1
if (line[:5] == "msgid"):
msgid = msgid + 1

if (line_number == i):
print "error in msgid no.", msgid-1
sys.exit(0)

Mac specific usage

2008-11-09T19:01:37Z

Wuischke:

== Description ==
This article is a guideline for Mac-specific issues in [[aMule]]. It should help anyone use all the features aMule has to offer on Macs and help with an easy and comfortable setup.

== Right/control-click to activate pop-up menus ==
Many of aMule's features are only accessible through pop-up menus, e.g. [[pause]] or [[cancel]] a [[download]] change the [[upload]] or download [[priority]] of a [[file]], see [[Usage_File_Details|file details]], etc.

You activate a pop-up menu either by clicking the right mouse button or, if you have a one-button mouse, by holding down the control key on your keyboard and clicking.

There are no visual cues to where these menus exist, so you need to experiment. You may for example try any list of files, [[client]]s and [[server]]s, all the labels on the top of these lists (e.g. "File Name") and the bar "all" at the top of the download window.

== Setting up firewall access ==
In addition to properly configuring your router to handle port forwarding, you need to configure the settings of the built-in firewall that comes included with Mac OS X. To do so:<br>
1. Go to Apple Menu > System Preferences.<br>
2. Click on the "Security" Preferences Pane.<br>
3. Click on the "Firewall" tab.<br>
4. Click "New..." on the right side of the tab, which will bring up a drop-down dialogue box.<br>
5. For "Port Name" select "Other"; for "TCP Port Number(s)" enter the same port number as you used in your "Connection" preferences in aMule; for "Description" enter something handy to remember what you did, like "aMule"; click "OK".<br>
6. Returning to the "Firewall" tab, be sure that the port you just created (i.e. "aMule") is checked. <br>

Now you should be good to go. You can see if you have correctly opened the port by testing [http://www.amule.org/testport.php here] .<br>

== Handling ed2k-Links ==
There are basically four ways to download files with aMule:

#[[Search]] for files using aMule's [[Usage_Searches|search dialog]] and double click those search results that you want to download.
#Copy [[ed2k link|ed2k-links]] from a web page into the "[[Usage_ED2K_Link_Handler|ED2K-Link Handler]]" field at the bottom of the search window of aMule and press the commit button. If the ed2k-link is longer than that text field is wide you need to make the aMule window wider until the link fits completely into the field (you can make the aMule window wider than your screen if necessary). We are working on eliminating this issue.
#Import ed2k-links directly from your browser into aMule. See http://forum.amule.org/index.php?topic=5679.0 for more details.
#Use a text editor (e.g. TextEdit) to paste ed2k-links into a "[[ED2KLinks_file|ED2Links]]" file inside ''~/Library/Application Support/aMule/'' and aMule will automatically import those links.

== Setting up aMule's video preview feature ==
You can use a video player like [http://www.videolan.org VLC] or [http://www.mplayerhq.hu Mplayer] to preview incomplete downloads of video files. To set up aMule properly for this, go to Preferences -> General. Under "Video Player", you have to enter "/usr/bin/open -a" together with the path of your video player program.

For example:
/usr/bin/open -a "/Applications/VLC.app"
/usr/bin/open -a "/Applications/vlc-0.8.4a/VLC.app"
/usr/bin/open -a "/Applications/MPlayer OS X 2.0b8r5/MPlayer OS X 2.app"

Or just "/usr/bin/open" to use the default application for the specific file type - as set up in the finder.

For additional information, see [[Usage_Preferences|this article]].

Known distribution problems

2008-11-06T19:55:00Z

Wuischke:

= Known distribution problems =

This is a list of known problems with distribution packages. If you encounter these problems with a fully patched version of your distribution, please file a bug report at your distribution's bug tracker.

Please note that these are '''not''' aMule bugs, but problems with distribution packages.

== General advise ==

Most crashes are related to crypto++ or wxwidgets. Rebuilding these packages from source usually solves crashes. Also make sure you are using the latest version of aMule.

=== crypto++ ===

Crypto++ uses some Assembler code, which might cause problems. Some compiler versions seem to produce crashing code when using optimisations.

Adding the options "-DCRYPTOPP_DISABLE_ASM" and "-O1" or "-O0" to CXXFlags in the GNUMakefile for crypt++ help to solve this issue.

crypto++ integrates a test suite called "cryptest.exe" on all systems. Executing "cryptest.exe v" in a terminal will run a verification test - if this test fails, The problem is most probably with

== Known crashes ==

Please do '''not''' report crashes which contain one of the following lines in the backtrace printed after the crash. Make sure you use the latest packages and notify your distribution about these problems.

[23] CryptoPP::BufferedTransformation::ChannelPut2(std::string const&, unsigned char const*, unsigned long, int, bool) in amule[0x4489c9]

[21] CryptoPP::IteratedHash<unsigned int, CryptoPP::EnumToType<CryptoPP::ByteOrder, 0>, 64u, CryptoPP::HashTransformation>::~IteratedHash() in amule [0x5032b2]

[19] wxNotebook::SetPadding(wxSize const&) in amule[0x8085191]

Main Page

2008-04-16T18:07:35Z

Wuischke:

__NOTOC__

{|
| align="center" |
''aMule Wiki reached the '''10,000,000 article reads''' milestone. Thanks to all of you!''
|-
| align="center" |

<h1>Welcome to the [http://wiki.org/wiki.cgi?WhatIsWiki Wiki] of the [[aMule|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]] | [[Main_Page-de|Deutsch]] | [[Main Page-fr|Français]] | [[Main Page-ru|Russian]] | [[Main Page-it|Italiano]] | [[Main Page-pl|Polish]]</h3>
|}
|-
| align="left" |
{|
| valign="top" |
== Installation ==
* HOWTO [[Compilation Installation|Compile and install aMule from sources]] ([[Compilation Installation-fr|French]]) ([[Compilation Installation-nl|Dutch]]) ([[Compilation Installation-br|Portuguese]]) ([[Compilation Installation-de|German]]) ([[Compilation Installation-ru|Russian]]) ([[Compilation Installation-it|Italian]])
* HOWTO [[Install-amule-freebsd|Compile aMule on FreeBSD]]
* HOWTO [[HowTo_compile_on_Mac|Compile aMule on Mac]] ([[HowTo_compile_on_Mac-de|German]]) ([[HowTo_compile_on_Mac-fr|French]]) ([[HowTo_compile_on_Mac-es|Spanish]])
* HOWTO [[HowTo_compile_on_Solaris|Compile aMule on Solaris]] ([[HowTo_compile_on_Solaris-de|German]])
* HOWTO [[HowTo compile on Win32|Compile aMule on Windows]] ([[HowTo compile on Win32-de|German]] ([[HowTo compile on Win32-fr|French]])
* HOWTO [[HowTo_Compile_In_Debian|Compile aMule on Debian or Ubuntu]] ([[HowTo_Compile_In_Debian-es|Spanish]]) ([[HowTo_Compile_In_Debian-de|German]])
* HOWTO [[HowTo_Compile_In_Gentoo|Compile aMule on Gentoo]] ([[HowTo_Compile_In_Gentoo-de|German]] | [[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]]) ([[HowTo Compile In MDK-fr|French]])
* HOWTO [[HowTo_compile_on_IRIX_SGI_O2|Compile on IRIX SGI O2]]
* 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]]) ([[HowTo Compile aMuled-nl|Dutch]]) ([[HowTo Compile aMuled-de|German]])
* HOWTO [[HowTo_get_aMule_web_interface|Install aMuleWeb]] ([[HowTo_get_aMule_web_interface-no|Norwegian]]) ([[HowTo_get_aMule_web_interface-de|German]])

== Other ==
* About [[AMule|aMule's features]] ([[aMule-hu|Hungarian]]) ([[aMule-es|Spanish]]) ([[aMule-de|German]]) ([[aMule-it|Italian]])
* aMule [[requirements]] ([[Requirements-de|German]]) ([[Requirements-it|Italian]]) ([[Requirements-es|Spanish]])
* [[Fake servers]] ([[Fake_servers-de|German]]) ([[Fake_servers-it|Italian]])
* 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]]) ([[Check_if_wx_is_installed_twice-de|German]])
* HOWTO [[How_to_uninstall_wxWidgets|Uninstall wxWidgets]] ([[How to uninstall wxWidgets-es|Spanish]]) ([[How_to_uninstall_wxWidgets-de|German]])
* [[skins|Skin support]] in aMule
* Get [[wx-cvs|wxWidgets CVS]] ([[Wx-cvs-es|Spanish]]) ([[Wx-cvs-de|German]]) ([[Wx-cvs-it|Italian]])
* About [[webcache]]
* User [[geaiez]] ([[Geaiez-es|Spanish]]) ([[Geaiez-de|German]])
* Some [[reviews]]
* Test [[test port|your ports]] ([[Test port-de|German]])
* Read [[current events]] ([[current events-es|Spanish]])
* Watch the [[Releases|release graphs]] ([[Releases-de|German]])
* Our [[forum rules]]
* Our [[IRC rules]]
* HOWTO [[aMule:Help|Edit a Wiki page]] ([[aMule:Help-de|German]])
* Join [[frappr!]] ([[frappr!-de|German]])

== Changelogs: ==
* [[Changelog_latest|Latest aMule release]]
* [[Changelog 2.1_series|aMule 2.1.X]]
** [[Changelog 2.1.0|aMule 2.1.0]]
** [[Changelog 2.1.1|aMule 2.1.1]]
** [[Changelog 2.1.2|aMule 2.1.2]]
** [[Changelog 2.1.3|aMule 2.1.3]]
* [[Changelog 2.0_series|aMule 2.0.X]]
* [[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]]) ([[Getting Started-ru|Russian]]) ([[Getting Started-da|Dansk]])
* Help [[Usage aMule|using aMule]] ([[Usage aMule-fr|French]])
* Help [[aMule_problems|Common problems]] ([[aMule_problems-es|Spanish]]) ([[AMule_problems-nl|Dutch]]) ([[AMule_problems-hu|Hungarian]]) ([[aMule_problems-de|German]])
* Help [[Mac specific usage]]
* 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]]) ([[AMule makes everything slow-de|German]])
* 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]]) ([[How_to_use_auxiliary_server_ports-de|German]]) ([[How_to_use_auxiliary_server_ports-no|Norwegian]]) ([[How_to_use_auxiliary_server_ports-es|Spanish]])

== 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 aMule-ru|Russian]])
* FAQ [[FAQ_utils|on aMule's utilities]] ([[FAQ_utils-es|Spanish]]) ([[FAQ_utils-de|German]]) ([[FAQ_utils-it|Italian]])
* FAQ [[FAQ eD2k-Kademlia|on ED2K-Kademlia]] ([[FAQ eD2k-Kademlia-es|Spanish]]) ([[FAQ eD2k-Kademlia-it|Italian]]) ([[FAQ eD2k-Kademlia-de|German]]) ([[FAQ_ed2k-fr|French]]) ([[FAQ_eD2k-Kademlia-nl|Dutch]]) ([[FAQ_eD2k-Kademlia-pl|Polish]]) ([[FAQ_eD2k-Kademlia-ru|Russian]])
* 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]] ([[Ed2k links handling-de|German]]) ([[Ed2k links handling-nl|Dutch]]) ([[Ed2k_links_handling-ko_KR|Korean]])
* HOWTO [[Debian_fonts|Address font issue on Debian]] ([[Debian_fonts-es|Spanish]])
* HOWTO [[import-export files|Import and export files]] ([[import-export files-de|German]])
* HOWTO [[Get HighID]] ([[Get HighID-de|German]]) ([[Get HighID-es|Spanish]])
* HOWTO [[Firewall|Setup firewall rules for aMule]] (([[Firewall-de|German]]) [[Firewall-es|Spanish]])
* HOWTO [[Keep a safe list of servers]] ([[Keep a safe list of servers-de|German]]) ([[Keep_a_safe_list_of_servers-es|Spanish]])
* HOWTO [[aMuleWeb|Setup aMule's Webserver (aMuleWeb)]]

== Development ==
* Download the latest [[aMule CVS]] ([[AMule CVS-es|Spanish]]) ([[AMule CVS-de|German]])
* 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]])
* Documentation of the [[EC_Procotol_HOWTO|EC protocol]]
* Rules of [[Coding Style|coding style]]
* Running a [[testing field]] ([[testing field-de|German]])
* HOWTO [[Bug report|Report a bug]] ([[Report_a_bug-ko_KR|Korean]])
* The [[GNU_FDL|GNU General Public License]]

== Translations ==
* HOWTO [[Translations|Translate aMule into your native language]] ([[Translations-pt|Portuguese]]) ([[Translations-ko_KR|Korean]]) ([[Translations-ru|Russian]]) ([[Translations-cn|Chinese]]) ([[Translations-es|Spanish]])
* HOWTO [[Translating Wiki|Translate this Wiki]] ([[Translating Wiki-pt_BR|Portuguese]]) ([[Translating Wiki-es|Spanish]]) ([[Translating Wiki-de|German]]) ([[Translating Wiki-fr|French]]) ([[Translating_Wiki-it|Italian]]) ([[Translating_Wiki-da|Dansk]]) ([[Translating_Wiki-ru|Russian]])
|}
|}

Main Page

2008-04-16T15:46:24Z

Wuischke:

__NOTOC__

{|
| align="center" |
''aMule Wiki reached the '''10,000,000 article reads''' milestone. Thanks to all of you!''
|-
| align="center" |

<h1>Welcome to the [http://wiki.org/wiki.cgi?WhatIsWiki Wiki] of the [[aMule|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]] | [[Main_Page-de|Deutsch]] | [[Main Page-fr|Français]] | [[Main Page-ru|Russian]] | [[Main Page-it|Italiano]] | [[Main Page-pl|Polish]]</h3>
|}
|-
| align="left" |
{|
| valign="top" |
== Installation ==
* HOWTO [[Compilation Installation|Compile and install aMule from sources]] ([[Compilation Installation-fr|French]]) ([[Compilation Installation-nl|Dutch]]) ([[Compilation Installation-br|Portuguese]]) ([[Compilation Installation-de|German]]) ([[Compilation Installation-ru|Russian]]) ([[Compilation Installation-it|Italian]])
* HOWTO [[Install-amule-freebsd|Compile aMule on FreeBSD]]
* HOWTO [[HowTo_compile_on_Mac|Compile aMule on Mac]] ([[HowTo_compile_on_Mac-de|German]]) ([[HowTo_compile_on_Mac-fr|French]]) ([[HowTo_compile_on_Mac-es|Spanish]])
* HOWTO [[HowTo_compile_on_Solaris|Compile aMule on Solaris]] ([[HowTo_compile_on_Solaris-de|German]])
* HOWTO [[HowTo compile on Win32|Compile aMule on Windows]] ([[HowTo compile on Win32-de|German]] ([[HowTo compile on Win32-fr|French]])
* HOWTO [[HowTo_Compile_In_Debian|Compile aMule on Debian or Ubuntu]] ([[HowTo_Compile_In_Debian-es|Spanish]]) ([[HowTo_Compile_In_Debian-de|German]])
* HOWTO [[HowTo_Compile_In_Gentoo|Compile aMule on Gentoo]] ([[HowTo_Compile_In_Gentoo-de|German]] | [[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]]) ([[HowTo Compile In MDK-fr|French]])
* HOWTO [[HowTo_compile_on_IRIX_SGI_O2|Compile on IRIX SGI O2]]
* 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]]) ([[HowTo Compile aMuled-nl|Dutch]]) ([[HowTo Compile aMuled-de|German]])
* HOWTO [[HowTo_get_aMule_web_interface|Install aMuleWeb]] ([[HowTo_get_aMule_web_interface-no|Norwegian]]) ([[HowTo_get_aMule_web_interface-de|German]])

== Other ==
* About [[AMule|aMule's features]] ([[aMule-hu|Hungarian]]) ([[aMule-es|Spanish]]) ([[aMule-de|German]]) ([[aMule-it|Italian]])
* aMule [[requirements]] ([[Requirements-de|German]]) ([[Requirements-it|Italian]]) ([[Requirements-es|Spanish]])
* [[Fake servers]] ([[Fake_servers-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]]) ([[Check_if_wx_is_installed_twice-de|German]])
* HOWTO [[How_to_uninstall_wxWidgets|Uninstall wxWidgets]] ([[How to uninstall wxWidgets-es|Spanish]]) ([[How_to_uninstall_wxWidgets-de|German]])
* [[skins|Skin support]] in aMule
* Get [[wx-cvs|wxWidgets CVS]] ([[Wx-cvs-es|Spanish]]) ([[Wx-cvs-de|German]]) ([[Wx-cvs-it|Italian]])
* About [[webcache]]
* User [[geaiez]] ([[Geaiez-es|Spanish]]) ([[Geaiez-de|German]])
* Some [[reviews]]
* Test [[test port|your ports]] ([[Test port-de|German]])
* Read [[current events]] ([[current events-es|Spanish]])
* Watch the [[Releases|release graphs]] ([[Releases-de|German]])
* Our [[forum rules]]
* Our [[IRC rules]]
* HOWTO [[aMule:Help|Edit a Wiki page]] ([[aMule:Help-de|German]])
* Join [[frappr!]] ([[frappr!-de|German]])

== Changelogs: ==
* [[Changelog_latest|Latest aMule release]]
* [[Changelog 2.1_series|aMule 2.1.X]]
** [[Changelog 2.1.0|aMule 2.1.0]]
** [[Changelog 2.1.1|aMule 2.1.1]]
** [[Changelog 2.1.2|aMule 2.1.2]]
** [[Changelog 2.1.3|aMule 2.1.3]]
* [[Changelog 2.0_series|aMule 2.0.X]]
* [[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]]) ([[Getting Started-ru|Russian]]) ([[Getting Started-da|Dansk]])
* Help [[Usage aMule|using aMule]] ([[Usage aMule-fr|French]])
* Help [[aMule_problems|Common problems]] ([[aMule_problems-es|Spanish]]) ([[AMule_problems-nl|Dutch]]) ([[AMule_problems-hu|Hungarian]]) ([[aMule_problems-de|German]])
* Help [[Mac specific usage]]
* 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]]) ([[AMule makes everything slow-de|German]])
* 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]]) ([[How_to_use_auxiliary_server_ports-de|German]]) ([[How_to_use_auxiliary_server_ports-no|Norwegian]]) ([[How_to_use_auxiliary_server_ports-es|Spanish]])

== 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 aMule-ru|Russian]])
* FAQ [[FAQ_utils|on aMule's utilities]] ([[FAQ_utils-es|Spanish]]) ([[FAQ_utils-de|German]]) ([[FAQ_utils-it|Italian]])
* FAQ [[FAQ eD2k-Kademlia|on ED2K-Kademlia]] ([[FAQ eD2k-Kademlia-es|Spanish]]) ([[FAQ eD2k-Kademlia-it|Italian]]) ([[FAQ eD2k-Kademlia-de|German]]) ([[FAQ_ed2k-fr|French]]) ([[FAQ_eD2k-Kademlia-nl|Dutch]]) ([[FAQ_eD2k-Kademlia-pl|Polish]]) ([[FAQ_eD2k-Kademlia-ru|Russian]])
* 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]] ([[Ed2k links handling-de|German]]) ([[Ed2k links handling-nl|Dutch]]) ([[Ed2k_links_handling-ko_KR|Korean]])
* HOWTO [[Debian_fonts|Address font issue on Debian]] ([[Debian_fonts-es|Spanish]])
* HOWTO [[import-export files|Import and export files]] ([[import-export files-de|German]])
* HOWTO [[Get HighID]] ([[Get HighID-de|German]]) ([[Get HighID-es|Spanish]])
* HOWTO [[Firewall|Setup firewall rules for aMule]] (([[Firewall-de|German]]) [[Firewall-es|Spanish]])
* HOWTO [[Keep a safe list of servers]] ([[Keep a safe list of servers-de|German]]) ([[Keep_a_safe_list_of_servers-es|Spanish]])
* HOWTO [[aMuleWeb|Setup aMule's Webserver (aMuleWeb)]]

== Development ==
* Download the latest [[aMule CVS]] ([[AMule CVS-es|Spanish]]) ([[AMule CVS-de|German]])
* 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]])
* Documentation of the [[EC_Procotol_HOWTO|EC protocol]]
* Rules of [[Coding Style|coding style]]
* Running a [[testing field]] ([[testing field-de|German]])
* HOWTO [[Bug report|Report a bug]] ([[Report_a_bug-ko_KR|Korean]])
* The [[GNU_FDL|GNU General Public License]]

== Translations ==
* HOWTO [[Translations|Translate aMule into your native language]] ([[Translations-pt|Portuguese]]) ([[Translations-ko_KR|Korean]]) ([[Translations-ru|Russian]]) ([[Translations-cn|Chinese]]) ([[Translations-es|Spanish]])
* HOWTO [[Translating Wiki|Translate this Wiki]] ([[Translating Wiki-pt_BR|Portuguese]]) ([[Translating Wiki-es|Spanish]]) ([[Translating Wiki-de|German]]) ([[Translating Wiki-fr|French]]) ([[Translating_Wiki-it|Italian]]) ([[Translating_Wiki-da|Dansk]]) ([[Translating_Wiki-ru|Russian]])
|}
|}

Webcache

2008-04-13T21:40:59Z

Wuischke: Fixed link, thanks stu redman

== Description ==

The idea of webcache is to upload the shared data into an ISP proxy and leave it there for other [[client]]s to download.

The description of the scheme can be found with full details in the [http://forum.emule-project.net/index.php?showtopic=14768 original post]. Plus, there are lot's of additional documentation pages all around the net; [http://www.google.com Google] is your friend ;)

== History ==

The idea began on 13 April 2003 at [http://forum.emule-project.net eMule's forums] when [mailto:sufcrusher@zonnet.nl sufcrusher] posted [http://forum.emule-project.net/index.php?showtopic=14768 this post]. The history can be followed there up to the first [[eMule]] mods implementing it.

== Pros and cons, as seen by [[aMule_devs|the Team]] ==

=== Pros ===

* The most evident pro, and the main purpose of it, is that web proxies have a lot of bandwidth and very high speed so the data sharing speeds should be greatly boosted.

* Also, [[P2P]] [[client]]s generate heavy traffic on ISPs since they open and close lots of connections in very little time and send/receive large amounts of data. Using webcache would stop these connections from going through the ISPs since they would only get to the ISPs' proxies.

=== Cons ===

* Since all your data (or some of it) would pass through your ISP's proxy, your ISP would know what you are sharing, so your privacy would suffer greatly.

* If you encrypt your traffic then you can't use webcache anyways. Encrypting e.g. with the openssl library like https or ssh does would mean an extension to the edonkey protocol but that should be possible with backwards compatibility.

* It is not clear whether using ISPs' web proxies for things other than web data is legal. Even if it was in your country, legislation are different from state to state, so [[client]]s try to conform to the broadest possible range of legislation to keep their users from having unpleasant experiencies with the law. Also, allthough the webcache feature might be better for your ISP, it can be bad if the traffic is too high, so you might have your ISP breaking the contract with you and leaving you without connection.

* Like it or not, webcache at large scale becomes a DDoS to the ISP's http cache servers. The ISPs' clients will notice a worse quality of the service, and ISPs will blame the webcache, being right. What's worse: [[P2P]] developers that support webcache could be sued for developing DDoS tools and invite people to use it, ISPs can say they are losing clients because of the quality the lost in their services, and so, [[P2P]] developer teams could have big problems.

* The [[P2P]] networks are being heavily tracked by some governments since they believe they are used for illegal purposes. There is a popular saying: "if it works, don't touch it". Well, that applies it here.

== Implementing webcache ==

There are already some [[client]]s out there supporting webcache. Most of them are [[eMule]] mods. We do '''NOT''' recommend using them. These mods bring down the [[P2P]] reputation and by using them you contribute in doing so.

== Regarding [[aMule]] ==

Discussions about implementing webcache feature into [[aMule]] have appeared many times in [http://forum.amule.org aMule's forums] although maybe the most relevant is [http://forum.amule.org/index.php?topic=3513 this one].

Anyway, until further (and highly unlikely) news, neither [[aMule]] nor [[eMule]] are going to officially support webcache in any future release.

'''This topic is NOT open for discussion.'''

Translations

2008-03-31T18:45:05Z

Wuischke:

== Introduction ==
Thanks for your interest in translating aMule. Becoming a translator isn't hard, you just need to understand common English and of course your native tongue.

The status of all translations are updated hourly at the [http://www.amule.org/translations Translation statistics page], that's an easy way to see if your work is needed. But you're always welcome to check an existing translation for errors or improve unfavourable expressions.

Before you start any work, please check [http://forum.amule.org/index.php?topic=13845.0 the translations list] for an entry for your language. If there's already someone working on the translation for your language, please reply to the forum topic for your language before you start working. It would be a shame to have two translators doing the same work, wouldn't it?
== Translate ==
=== Get Translation file ===
You can get current Portable Object (po) files for all supported languages at the [http://www.amule.org/translations Translation statistics page]. Just click on the name of your language and download the po-file.
==== Start a new translation ====
Your language isn't yet supported by aMule and you can't find a po-file at the statistics page? No problem, let's start a new translation! Either open a new topic in the [http://forum.amule.org/index.php?board=40.0 translations forum] to receive help with the translation process or create the po-file yourself:

To do so, please download the amule.pot file, which is linked at the bottom of the [http://www.amule.org/translations Translation statistics page]. Then you need [http://www.gnu.org/software/gettext/ gettext] installed on your system (comes by default with most operating systems) and the language code of your language. If you don't know the language code of your language, you should be able to find the code in the [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes list of language codes on Wikipedia]. If you've done so, use the following command to create the po-file:

msginit --input=amule.pot --locale=''language code''

If you decide to create your own po-file, please have a loot at the [[Translations#Plural_forms|Plural forms]] section of this page.
=== The translation process ===
Now that you've got the po-file, let's start with the actual translation process. There are several programs to help you with this task, like [http://www.poedit.net Poedit], [http://gtranslator.sourceforge.net/ gtranslator] or [http://kbabel.kde.org KBabel], but you can use your favourite text editor, too.

Here's a quick start for these editors, please refer to their respective home pages for a more extensive documentation.
==== Poedit ====
When you open a po-file in Poedit, you are greeted by a screen similar to the following:

http://img516.imageshack.us/img516/481/wikipoedit1ly7.png

In the bottom, you'll find statistics. Not translated strings are marked in shades of turquoise in the string list in the upper part, [[Translations#fuzzy_strings|fuzzy strings]] in brown-sand tones and translated strings in grey/white.

The actual translation takes part in the middle part of the window.

http://img253.imageshack.us/img253/5157/wikipoedit2ov3.png

You'll see the English source string at the top and the field to enter the translations below. Here's even a special case with plural forms. When you're done entering the translated page for one string you can go on by clicking on the next string to translate.

When you're done translating, continue with testing your translation.
==== KBabel ====
Another powerful editor is the KDE-based KBabel.

http://img512.imageshack.us/img512/3183/wikikbabel1my7.png

The user interface is customizable, but in the default view, you'll find the string list, the source string and the input field for translations on the left side. Statistical information are on the bottom, just as with Poedit.

http://img329.imageshack.us/img329/607/wikikbabel2fz0.png

By clicking on the ''Next [[Translations#fuzzy_strings|Fuzzy]] or Untranslated''-button in the toolbar, KBabel will jump directly to the next string in need of some work.

http://img329.imageshack.us/img329/9992/wikikbabel3uw7.png

The actual translation interface is very similar to Poedit, in the upper part you'll see the source string and below you can enter the translation.

==== Using a text editor ====
po-files are just text files and of course you can use any text editor to edit them. Popular editors Emacs and Vim both provide corresponding plugins.

The file format is pretty simple, but please refer to the [http://www.gnu.org/software/gettext/manual/gettext.html#PO-Files section in the gettext manual] for further information.

=== Test the translation ===
Use the following command to test a translation:

msgfmt -c --statistic ''language code''.po

Example output:

$ msgfmt -c --statistics ca.po
1428 translated messages, 58 [[Translations#fuzzy_strings|fuzzy]] translations, 32 untranslated messages.

Please refer to the [[Translations#Common_problems|Common problems]] section if any error messages appear. Don't hesitate to attach your po-file in the [http://forum.amule.org/index.php?board=40.0 translations forum] and ask for help, if you can't solve the problems yourself. I'll try to fix the problems and explain what went wrong.

=== Getting the translation into aMule ===
Find your language in [http://forum.amule.org/index.php?topic=13845.0 the translations list] and attach the po-file in a new reply to your language's topic (click on the language name to go to your language's topic).

If you can't find a topic for your language, just create a new one in the [http://forum.amule.org/index.php?board=40.0 translations forum].

== Common problems ==
=== fuzzy strings ===
Strings are marked fuzzy after a change of the source string of an already translated string. This just means that the translator should review the string and see if the change has any influence on the translation.

An example: "Delete server?" was replaced by "Do you really want to remove the server?". The content is the same and only the wording was changed. Depending on the translation there may be no changes necessary.
=== message compilation errors ===
After testing the translation, you get an error message. Here's a list of common errors and the solution:
* ''end-of-line within string''
** A string started by " (quotation marks) wasn't closed by another ". Take a look at the line number and close the string.
* ''format specifications in 'msgid' and 'msgstr' for argument 1 are not the same''
** You've probably noticed things like '%s' or '%d' in the source strings. These are later replaced by a variable, for instance a string for %s and an number for %d. Please check all your %-constructs in the translated string (use the line number in the error message to find the string) and see if they are the same as in the source string.
* ''number of format specifications in 'msgid' and 'msgstr' does not match''
** This is similar to above error. You don't have the same quantity of %-constructs in the source and translation. Check the translation, maybe you've forgotten one or you accidentally wrote '&s' when you meant '%s'
* ''`msgid' and `msgstr' entries do not both end with '\n'''
** '\n' is a new line in a string. You need the same number of new lines in the translation as in the source. Try to place them similar to the source string.

=== Plural forms ===

Plurals are handled differently in various languages. Whilst English or German have a singular and a plural form, other languages like Turkish don't distinguish between plural or singular and there are languages which use different plurals for different numbers, e.g. Polish.

The first thing you need is the appropriate header in your po-file. You'll find help in the [http://www.gnu.org/software/gettext/manual/gettext.html#Plural-forms gettext manual on plural forms] or the [http://translate.sourceforge.net/wiki/l10n/pluralforms list of plural forms]. If you have trouble to add the header, please ask in the [http://forum.amule.org/index.php?board=40.0 translations forum].

An example for German:

"Plural-Forms: nplurals=2; plural=n != 1;\n"

Plural forms are represented in the source as follows (extract from de.po for German):

#: src/kademlia/routing/RoutingZone.cpp:141
#, c-format
msgid "Read %u Kad contact"
msgid_plural "Read %u Kad contacts"
msgstr[0] "Lese %u Kad-Kontakt"
msgstr[1] "Lese %u Kad-Kontakte"

The first ''msgid'' is the source for the singular, the ''msgid_plural'' is the plural source. Note the index ''msgstr'' gets for plural strings. Each index is for a different plural form. In the case of German ''msgstr[0]'' is the singular string and ''msgstr[1]'' is used for plural forms.

This is similar for other languages. If you are in doubt about which index corresponds to which plural form, please ask in the [http://forum.amule.org/index.php?board=40.0 translations forum].
=== my program doesn't allow me to jump to a line ===
kpeace1 wrote a [http://forum.amule.org/index.php?topic=14699.msg77946#msg77946 script] which converts line numbers in error messages to msgids and makes easier.
#!/usr/bin/env python

import sys

if (len(sys.argv) < 3):
print "usage:\t", sys.argv[0], "file_name ", "line#"

file_name = sys.argv[1]
line_number = int(sys.argv[2])

po_file = open(file_name)
i = 0
msgid = 0

for line in po_file:
i = i + 1
if (line[:5] == "msgid"):
msgid = msgid + 1

if (line_number == i):
print "error in msgid no.", msgid-1
sys.exit(0)

Talk:Translations

2008-03-26T22:15:54Z

Wuischke:

I didn't link the translations of the old page, because the content is entirely different. If someone translates the new page, please add a link to the English version.

Translations

2008-03-26T22:13:15Z

Wuischke:

== Introduction ==
Thanks for your interest in translating aMule. Becoming a translator isn't hard, you just need to understand common English and of course your native tongue.

The status of all translations are updated hourly at the [http://www.amule.org/translations Translation statistics page], that's an easy way to see if your work is needed. But you're always welcome to check an existing translation for errors or improve unfavourable expressions.

Before you start any work, please check [http://forum.amule.org/index.php?topic=13845.0 the translations list] for an entry for your language. If there's already someone working on the translation for your language, please reply to the forum topic for your language before you start working. It would be a shame to have two translators doing the same work, wouldn't it?
== Translate ==
=== Get Translation file ===
You can get current Portable Object (po) files for all supported languages at the [http://www.amule.org/translations Translation statistics page]. Just click on the name of your language and download the po-file.
==== Start a new translation ====
Your language isn't yet supported by aMule and you can't find a po-file at the statistics page? No problem, let's start a new translation! Either open a new topic in the [http://forum.amule.org/index.php?board=40.0 translations forum] to receive help with the translation process or create the po-file yourself:

To do so, please download the amule.pot file, which is linked at the bottom of the [http://www.amule.org/translations Translation statistics page]. Then you need [http://www.gnu.org/software/gettext/ gettext] installed on your system (comes by default with most operating systems) and the language code of your language. If you don't know the language code of your language, you should be able to find the code in the [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes list of language codes on Wikipedia]. If you've done so, use the following command to create the po-file:

msginit --input=amule.pot --locale=''language code''

If you decide to create your own po-file, please have a loot at the [[Translations#Plural_forms|Plural forms]] section of this page.
=== The translation process ===
Now that you've got the po-file, let's start with the actual translation process. There are several programs to help you with this task, like [http://www.poedit.net Poedit] or [http://kbabel.kde.org KBabel], but you can use your favourite text editor, too.

Here's a quick start for these editors, please refer to their respective home pages for a more extensive documentation.
==== Poedit ====
When you open a po-file in Poedit, you are greeted by a screen similar to the following:

http://img516.imageshack.us/img516/481/wikipoedit1ly7.png

In the bottom, you'll find statistics. Not translated strings are marked in shades of turquoise in the string list in the upper part, [[Translations#fuzzy_strings|fuzzy strings]] in brown-sand tones and translated strings in grey/white.

The actual translation takes part in the middle part of the window.

http://img253.imageshack.us/img253/5157/wikipoedit2ov3.png

You'll see the English source string at the top and the field to enter the translations below. Here's even a special case with plural forms. When you're done entering the translated page for one string you can go on by clicking on the next string to translate.

When you're done translating, continue with testing your translation.
==== KBabel ====
Another powerful editor is the KDE-based KBabel.

http://img512.imageshack.us/img512/3183/wikikbabel1my7.png

The user interface is customizable, but in the default view, you'll find the string list, the source string and the input field for translations on the left side. Statistical information are on the bottom, just as with Poedit.

http://img329.imageshack.us/img329/607/wikikbabel2fz0.png

By clicking on the ''Next [[Translations#fuzzy_strings|Fuzzy]] or Untranslated''-button in the toolbar, KBabel will jump directly to the next string in need of some work.

http://img329.imageshack.us/img329/9992/wikikbabel3uw7.png

The actual translation interface is very similar to Poedit, in the upper part you'll see the source string and below you can enter the translation.

==== Using a text editor ====
po-files are just text files and of course you can use any text editor to edit them. Popular editors Emacs and Vim both provide corresponding plugins.

The file format is pretty simple, but please refer to the [http://www.gnu.org/software/gettext/manual/gettext.html#PO-Files section in the gettext manual] for further information.

=== Test the translation ===
Use the following command to test a translation:

msgfmt -c --statistic ''language code''.po

Example output:

$ msgfmt -c --statistics ca.po
1428 translated messages, 58 [[Translations#fuzzy_strings|fuzzy]] translations, 32 untranslated messages.

Please refer to the [[Translations#Common_problems|Common problems]] section if any error messages appear. Don't hesitate to attach your po-file in the [http://forum.amule.org/index.php?board=40.0 translations forum] and ask for help, if you can't solve the problems yourself. I'll try to fix the problems and explain what went wrong.

=== Getting the translation into aMule ===
Find your language in [http://forum.amule.org/index.php?topic=13845.0 the translations list] and attach the po-file in a new reply to your language's topic (click on the language name to go to your language's topic).

If you can't find a topic for your language, just create a new one in the [http://forum.amule.org/index.php?board=40.0 translations forum].

== Common problems ==
=== fuzzy strings ===
Strings are marked fuzzy after a change of the source string of an already translated string. This just means that the translator should review the string and see if the change has any influence on the translation.

An example: "Delete server?" was replaced by "Do you really want to remove the server?". The content is the same and only the wording was changed. Depending on the translation there may be no changes necessary.
=== message compilation errors ===
After testing the translation, you get an error message. Here's a list of common errors and the solution:
* ''end-of-line within string''
** A string started by " (quotation marks) wasn't closed by another ". Take a look at the line number and close the string.
* ''format specifications in 'msgid' and 'msgstr' for argument 1 are not the same''
** You've probably noticed things like '%s' or '%d' in the source strings. These are later replaced by a variable, for instance a string for %s and an number for %d. Please check all your %-constructs in the translated string (use the line number in the error message to find the string) and see if they are the same as in the source string.
* ''number of format specifications in 'msgid' and 'msgstr' does not match''
** This is similar to above error. You don't have the same quantity of %-constructs in the source and translation. Check the translation, maybe you've forgotten one or you accidentally wrote '&s' when you meant '%s'
* ''`msgid' and `msgstr' entries do not both end with '\n'''
** '\n' is a new line in a string. You need the same number of new lines in the translation as in the source. Try to place them similar to the source string.

=== Plural forms ===

Plurals are handled differently in various languages. Whilst English or German have a singular and a plural form, other languages like Turkish don't distinguish between plural or singular and there are languages which use different plurals for different numbers, e.g. Polish.

The first thing you need is the appropriate header in your po-file. You'll find help in the [http://www.gnu.org/software/gettext/manual/gettext.html#Plural-forms gettext manual on plural forms] or the [http://translate.sourceforge.net/wiki/l10n/pluralforms list of plural forms]. If you have trouble to add the header, please ask in the [http://forum.amule.org/index.php?board=40.0 translations forum].

An example for German:

"Plural-Forms: nplurals=2; plural=n != 1;\n"

Plural forms are represented in the source as follows (extract from de.po for German):

#: src/kademlia/routing/RoutingZone.cpp:141
#, c-format
msgid "Read %u Kad contact"
msgid_plural "Read %u Kad contacts"
msgstr[0] "Lese %u Kad-Kontakt"
msgstr[1] "Lese %u Kad-Kontakte"

The first ''msgid'' is the source for the singular, the ''msgid_plural'' is the plural source. Note the index ''msgstr'' gets for plural strings. Each index is for a different plural form. In the case of German ''msgstr[0]'' is the singular string and ''msgstr[1]'' is used for plural forms.

This is similar for other languages. If you are in doubt about which index corresponds to which plural form, please ask in the [http://forum.amule.org/index.php?board=40.0 translations forum].

Translations

2008-03-26T22:12:41Z

Wuischke:

== Introduction ==
Thanks for your interest in translating aMule. Becoming a translator isn't hard, you just need to understand common English and of course your native tongue.

The status of all translations are updated hourly at the [http://www.amule.org/translations Translation statistics page], that's an easy way to see if your work is needed. But you're always welcome to check an existing translation for errors or improve unfavourable expressions.

Before you start any work, please check [http://forum.amule.org/index.php?topic=13845.0 the translations list] for an entry for your language. If there's already someone working on the translation for your language, please reply to the forum topic for your language before you start working. It would be a shame to have two translators doing the same work, wouldn't it?
== Translate ==
=== Get Translation file ===
You can get current Portable Object (po) files for all supported languages at the [http://www.amule.org/translations Translation statistics page]. Just click on the name of your language and download the po-file.
==== Start a new translation ====
Your language isn't yet supported by aMule and you can't find a po-file at the statistics page? No problem, let's start a new translation! Either open a new topic in the [http://forum.amule.org/index.php?board=40.0 translations forum] to receive help with the translation process or create the po-file yourself:

To do so, please download the amule.pot file, which is linked at the bottom of the [http://www.amule.org/translations Translation statistics page]. Then you need [http://www.gnu.org/software/gettext/ gettext] installed on your system (comes by default with most operating systems) and the language code of your language. If you don't know the language code of your language, you should be able to find the code in the [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes list of language codes on Wikipedia]. If you've done so, use the following command to create the po-file:

msginit --input=amule.pot --locale=''language code''

If you decide to create your own po-file, please have a loot at the [[Translations#Plural_forms|Plural forms]] section of this page.
=== The translation process ===
Now that you've got the po-file, let's start with the actual translation process. There are several programs to help you with this task, like [http://www.poedit.net Poedit] or [http://kbabel.kde.org KBabel], but you can use your favourite text editor, too.

Here's a quick start for these editors, please refer to their respective home pages for a more extensive documentation.
==== Poedit ====
When you open a po-file in Poedit, you are greeted by a screen similar to the following:

http://img516.imageshack.us/img516/481/wikipoedit1ly7.png

In the bottom, you'll find statistics. Not translated strings are marked in shades of turquoise in the string list in the upper part, [[Translations#fuzzy_strings|fuzzy strings] in brown-sand tones and translated strings in grey/white.

The actual translation takes part in the middle part of the window.

http://img253.imageshack.us/img253/5157/wikipoedit2ov3.png

You'll see the English source string at the top and the field to enter the translations below. Here's even a special case with plural forms. When you're done entering the translated page for one string you can go on by clicking on the next string to translate.

When you're done translating, continue with testing your translation.
==== KBabel ====
Another powerful editor is the KDE-based KBabel.

http://img512.imageshack.us/img512/3183/wikikbabel1my7.png

The user interface is customizable, but in the default view, you'll find the string list, the source string and the input field for translations on the left side. Statistical information are on the bottom, just as with Poedit.

http://img329.imageshack.us/img329/607/wikikbabel2fz0.png

By clicking on the ''Next [[Translations#fuzzy_strings|Fuzzy] or Untranslated''-button in the toolbar, KBabel will jump directly to the next string in need of some work.

http://img329.imageshack.us/img329/9992/wikikbabel3uw7.png

The actual translation interface is very similar to Poedit, in the upper part you'll see the source string and below you can enter the translation.

==== Using a text editor ====
po-files are just text files and of course you can use any text editor to edit them. Popular editors Emacs and Vim both provide corresponding plugins.

The file format is pretty simple, but please refer to the [http://www.gnu.org/software/gettext/manual/gettext.html#PO-Files section in the gettext manual] for further information.

=== Test the translation ===
Use the following command to test a translation:

msgfmt -c --statistic ''language code''.po

Example output:

$ msgfmt -c --statistics ca.po
1428 translated messages, 58 [[Translations#fuzzy_strings|fuzzy]] translations, 32 untranslated messages.

Please refer to the [[Translations#Common_problems|Common problems]] section if any error messages appear. Don't hesitate to attach your po-file in the [http://forum.amule.org/index.php?board=40.0 translations forum] and ask for help, if you can't solve the problems yourself. I'll try to fix the problems and explain what went wrong.

=== Getting the translation into aMule ===
Find your language in [http://forum.amule.org/index.php?topic=13845.0 the translations list] and attach the po-file in a new reply to your language's topic (click on the language name to go to your language's topic).

If you can't find a topic for your language, just create a new one in the [http://forum.amule.org/index.php?board=40.0 translations forum].

== Common problems ==
=== fuzzy strings ===
Strings are marked fuzzy after a change of the source string of an already translated string. This just means that the translator should review the string and see if the change has any influence on the translation.

An example: "Delete server?" was replaced by "Do you really want to remove the server?". The content is the same and only the wording was changed. Depending on the translation there may be no changes necessary.
=== message compilation errors ===
After testing the translation, you get an error message. Here's a list of common errors and the solution:
* ''end-of-line within string''
** A string started by " (quotation marks) wasn't closed by another ". Take a look at the line number and close the string.
* ''format specifications in 'msgid' and 'msgstr' for argument 1 are not the same''
** You've probably noticed things like '%s' or '%d' in the source strings. These are later replaced by a variable, for instance a string for %s and an number for %d. Please check all your %-constructs in the translated string (use the line number in the error message to find the string) and see if they are the same as in the source string.
* ''number of format specifications in 'msgid' and 'msgstr' does not match''
** This is similar to above error. You don't have the same quantity of %-constructs in the source and translation. Check the translation, maybe you've forgotten one or you accidentally wrote '&s' when you meant '%s'
* ''`msgid' and `msgstr' entries do not both end with '\n'''
** '\n' is a new line in a string. You need the same number of new lines in the translation as in the source. Try to place them similar to the source string.

=== Plural forms ===

Plurals are handled differently in various languages. Whilst English or German have a singular and a plural form, other languages like Turkish don't distinguish between plural or singular and there are languages which use different plurals for different numbers, e.g. Polish.

The first thing you need is the appropriate header in your po-file. You'll find help in the [http://www.gnu.org/software/gettext/manual/gettext.html#Plural-forms gettext manual on plural forms] or the [http://translate.sourceforge.net/wiki/l10n/pluralforms list of plural forms]. If you have trouble to add the header, please ask in the [http://forum.amule.org/index.php?board=40.0 translations forum].

An example for German:

"Plural-Forms: nplurals=2; plural=n != 1;\n"

Plural forms are represented in the source as follows (extract from de.po for German):

#: src/kademlia/routing/RoutingZone.cpp:141
#, c-format
msgid "Read %u Kad contact"
msgid_plural "Read %u Kad contacts"
msgstr[0] "Lese %u Kad-Kontakt"
msgstr[1] "Lese %u Kad-Kontakte"

The first ''msgid'' is the source for the singular, the ''msgid_plural'' is the plural source. Note the index ''msgstr'' gets for plural strings. Each index is for a different plural form. In the case of German ''msgstr[0]'' is the singular string and ''msgstr[1]'' is used for plural forms.

This is similar for other languages. If you are in doubt about which index corresponds to which plural form, please ask in the [http://forum.amule.org/index.php?board=40.0 translations forum].

Translations

2008-03-26T22:11:39Z

Wuischke: Translations-draft moved to Translations: Rewrite of old article.

== Introduction ==
Thanks for your interest in translating aMule. Becoming a translator isn't hard, you just need to understand common English and of course your native tongue.

The status of all translations are updated hourly at the [http://www.amule.org/translations Translation statistics page], that's an easy way to see if your work is needed. But you're always welcome to check an existing translation for errors or improve unfavourable expressions.

Before you start any work, please check [http://forum.amule.org/index.php?topic=13845.0 the translations list] for an entry for your language. If there's already someone working on the translation for your language, please reply to the forum topic for your language before you start working. It would be a shame to have two translators doing the same work, wouldn't it?
== Translate ==
=== Get Translation file ===
You can get current Portable Object (po) files for all supported languages at the [http://www.amule.org/translations Translation statistics page]. Just click on the name of your language and download the po-file.
==== Start a new translation ====
Your language isn't yet supported by aMule and you can't find a po-file at the statistics page? No problem, let's start a new translation! Either open a new topic in the [http://forum.amule.org/index.php?board=40.0 translations forum] to receive help with the translation process or create the po-file yourself:

To do so, please download the amule.pot file, which is linked at the bottom of the [http://www.amule.org/translations Translation statistics page]. Then you need [http://www.gnu.org/software/gettext/ gettext] installed on your system (comes by default with most operating systems) and the language code of your language. If you don't know the language code of your language, you should be able to find the code in the [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes list of language codes on Wikipedia]. If you've done so, use the following command to create the po-file:

msginit --input=amule.pot --locale=''language code''

If you decide to create your own po-file, please have a loot at the [[Translations#Plural_forms|Plural forms]] section of this page.
=== The translation process ===
Now that you've got the po-file, let's start with the actual translation process. There are several programs to help you with this task, like [http://www.poedit.net Poedit] or [http://kbabel.kde.org KBabel], but you can use your favourite text editor, too.

Here's a quick start for these editors, please refer to their respective home pages for a more extensive documentation.
==== Poedit ====
When you open a po-file in Poedit, you are greeted by a screen similar to the following:

http://img516.imageshack.us/img516/481/wikipoedit1ly7.png

In the bottom, you'll find statistics. Not translated strings are marked in shades of turquoise in the string list in the upper part, [[Translations#fuzzy_strings|fuzzy strings] in brown-sand tones and translated strings in grey/white.

The actual translation takes part in the middle part of the window.

http://img253.imageshack.us/img253/5157/wikipoedit2ov3.png

You'll see the English source string at the top and the field to enter the translations below. Here's even a special case with plural forms. When you're done entering the translated page for one string you can go on by clicking on the next string to translate.

When you're done translating, continue with testing your translation.
==== KBabel ====
Another powerful editor is the KDE-based KBabel.

http://img512.imageshack.us/img512/3183/wikikbabel1my7.png

The user interface is customizable, but in the default view, you'll find the string list, the source string and the input field for translations on the left side. Statistical information are on the bottom, just as with Poedit.

http://img329.imageshack.us/img329/607/wikikbabel2fz0.png

By clicking on the ''Next [[Translations#fuzzy_strings|Fuzzy] or Untranslated''-button in the toolbar, KBabel will jump directly to the next string in need of some work.

http://img329.imageshack.us/img329/9992/wikikbabel3uw7.png

The actual translation interface is very similar to Poedit, in the upper part you'll see the source string and below you can enter the translation.

==== Using a text editor ====
po-files are just text files and of course you can use any text editor to edit them. Popular editors Emacs and Vim both provide corresponding plugins.

The file format is pretty simple, but please refer to the [http://www.gnu.org/software/gettext/manual/gettext.html#PO-Files section in the gettext manual] for further information.

=== Test the translation ===
Use the following command to test a translation:

msgfmt -c --statistic ''language code''.po

Example output:

$ msgfmt -c --statistics ca.po
1428 translated messages, 58 [[Translations#fuzzy_strings|fuzzy] translations, 32 untranslated messages.

Please refer to the [[Translations#Common_problems|Common problems]] section if any error messages appear. Don't hesitate to attach your po-file in the [http://forum.amule.org/index.php?board=40.0 translations forum] and ask for help, if you can't solve the problems yourself. I'll try to fix the problems and explain what went wrong.

=== Getting the translation into aMule ===
Find your language in [http://forum.amule.org/index.php?topic=13845.0 the translations list] and attach the po-file in a new reply to your language's topic (click on the language name to go to your language's topic).

If you can't find a topic for your language, just create a new one in the [http://forum.amule.org/index.php?board=40.0 translations forum].

== Common problems ==
=== fuzzy strings ===
Strings are marked fuzzy after a change of the source string of an already translated string. This just means that the translator should review the string and see if the change has any influence on the translation.

An example: "Delete server?" was replaced by "Do you really want to remove the server?". The content is the same and only the wording was changed. Depending on the translation there may be no changes necessary.
=== message compilation errors ===
After testing the translation, you get an error message. Here's a list of common errors and the solution:
* ''end-of-line within string''
** A string started by " (quotation marks) wasn't closed by another ". Take a look at the line number and close the string.
* ''format specifications in 'msgid' and 'msgstr' for argument 1 are not the same''
** You've probably noticed things like '%s' or '%d' in the source strings. These are later replaced by a variable, for instance a string for %s and an number for %d. Please check all your %-constructs in the translated string (use the line number in the error message to find the string) and see if they are the same as in the source string.
* ''number of format specifications in 'msgid' and 'msgstr' does not match''
** This is similar to above error. You don't have the same quantity of %-constructs in the source and translation. Check the translation, maybe you've forgotten one or you accidentally wrote '&s' when you meant '%s'
* ''`msgid' and `msgstr' entries do not both end with '\n'''
** '\n' is a new line in a string. You need the same number of new lines in the translation as in the source. Try to place them similar to the source string.

=== Plural forms ===

Plurals are handled differently in various languages. Whilst English or German have a singular and a plural form, other languages like Turkish don't distinguish between plural or singular and there are languages which use different plurals for different numbers, e.g. Polish.

The first thing you need is the appropriate header in your po-file. You'll find help in the [http://www.gnu.org/software/gettext/manual/gettext.html#Plural-forms gettext manual on plural forms] or the [http://translate.sourceforge.net/wiki/l10n/pluralforms list of plural forms]. If you have trouble to add the header, please ask in the [http://forum.amule.org/index.php?board=40.0 translations forum].

An example for German:

"Plural-Forms: nplurals=2; plural=n != 1;\n"

Plural forms are represented in the source as follows (extract from de.po for German):

#: src/kademlia/routing/RoutingZone.cpp:141
#, c-format
msgid "Read %u Kad contact"
msgid_plural "Read %u Kad contacts"
msgstr[0] "Lese %u Kad-Kontakt"
msgstr[1] "Lese %u Kad-Kontakte"

The first ''msgid'' is the source for the singular, the ''msgid_plural'' is the plural source. Note the index ''msgstr'' gets for plural strings. Each index is for a different plural form. In the case of German ''msgstr[0]'' is the singular string and ''msgstr[1]'' is used for plural forms.

This is similar for other languages. If you are in doubt about which index corresponds to which plural form, please ask in the [http://forum.amule.org/index.php?board=40.0 translations forum].