http://wiki.amule.org/w/api.php?action=feedcontributions&user=Undrline&feedformat=atomAMule Project FAQ - User contributions [en]2024-03-28T22:22:21ZUser contributionsMediaWiki 1.23.3http://wiki.amule.org/wiki/Talk:ConfigureTalk:Configure2011-05-26T18:47:23Z<p>Undrline: PWD?</p>
<hr />
<div>== PWD? ==<br />
<br />
Shouldn't the terminal be in a specific directory when doing ./configure?</div>Undrlinehttp://wiki.amule.org/wiki/User_talk:UndrlineUser talk:Undrline2011-03-18T23:28:30Z<p>Undrline: </p>
<hr />
<div>Please, leave me a message here.<br />
----<br />
<br />
<br />
The Tagging of Indicators as Spam was just, because it came in the usual workflow. Anyways I don't think this is usefull, because noone will type Indicators into searchbox if he wants to know what an icon on the comments dialog means. He'll type comments ore something like that and get's the answer he wants. This page would be useful, if it would be placed on mainpage, but I don't see it important enough for being there.<br />
<br />
Regards [[User_talk:Vollstrecker|Vollstrecker]]</div>Undrlinehttp://wiki.amule.org/wiki/User_talk:UndrlineUser talk:Undrline2011-03-18T23:27:28Z<p>Undrline: </p>
<hr />
<div>Please, leave me a message here.<br />
----<br />
<br />
<br />
The Tagging of Indicators as Spam was just, because it came in the usual workflow. Anyways I don't think this is usefull, because noone will type Indicators into searchbox if he wants to know what an icon on the comments dialog means. He'll type comments ore something like that and get's the answer he wants. This page would be useful, if it would be placed on mainpage, but I don't see it important enough for being there.<br />
<br />
Regards Vollstrecker</div>Undrlinehttp://wiki.amule.org/wiki/User_talk:VollstreckerUser talk:Vollstrecker2011-03-15T21:25:58Z<p>Undrline: /* Indicators */</p>
<hr />
<div>== Indicators ==<br />
<br />
Not sure why the [[indicators]] page was deleted. It was information I always had trouble finding, so I figured other people might be in the same boat. Far from the "Vandalism:Spam" tag that it received, I think it had redeeming value. Can you please help me to understand?<br />
<br />
--[[User:Undrline|Undrline]] 04:58, 10 March 2011 (UTC)<br />
<br />
<br />
Thanks for the [[User_talk:Undrline|response]]. The comment indicators don't just appear on the comments, they appear in the search results. There's nothing readily apparent that they have anything to do with comments, IMO people wouldn't know to search for that. It took me a while of searching for "green ii" to find out that they had anything to do with comments, or that they were upside-down exclamation marks. If indicator isn't a good word for it, can we pick another word and keep the content?<br />
<br />
--[[User:Undrline|Undrline]] 21:25, 15 March 2011 (UTC)</div>Undrlinehttp://wiki.amule.org/wiki/Comment_iconComment icon2011-03-10T05:03:26Z<p>Undrline: added see also: Getting_Started#Icons_and_What_They_Signify</p>
<hr />
<div><center><br />
'''English''' | <br />
[[Comment icon-de|Deutsch]] | <br />
[[Comment icon-ru|Russian]] | <br />
[[Comment icon-nl|Dutch]]<br />
</center><br />
<br />
When a [[comment]] or a [[rate]] about a [[file]] is know to [[aMule]] an [[indicators|indicator]] will appear by the file's filename so that the user knows about it and checks it.<br />
<br />
Depending on the rate the file has been given the icon will change:<br />
{|<br />
| http://www.amule.org/dev-up/comments1.jpg || The file has a comment but has not been rated<br />
|-<br />
| http://www.amule.org/dev-up/comments2.jpg || The average rate of the file is very bad (probably a [[corrupt]] or a [[fake]])<br />
|-<br />
| http://www.amule.org/dev-up/comments3.jpg || The average rate of the file is poor (possible corrupt, a fake or a [[valid]] file with very bad quality)<br />
|-<br />
| http://www.amule.org/dev-up/comments4.jpg || The average rate of the file is good<br />
|-<br />
| http://www.amule.org/dev-up/comments5.jpg || The average rate of the file is fair<br />
|-<br />
| http://www.amule.org/dev-up/comments6.jpg || The average rate of the file is excellent<br />
|}<br />
<br />
==See also==<br />
[[Getting_Started#Icons_and_What_They_Signify|Getting Started: Icons and What They Signify]]</div>Undrlinehttp://wiki.amule.org/wiki/User_talk:VollstreckerUser talk:Vollstrecker2011-03-10T04:58:06Z<p>Undrline: Indicators</p>
<hr />
<div>== Indicators ==<br />
<br />
Not sure why the [[indicators]] page was deleted. It was information I always had trouble finding, so I figured other people might be in the same boat. Far from the "Vandalism:Spam" tag that it received, I think it had redeeming value. Can you please help me to understand?<br />
<br />
--[[User:Undrline|Undrline]] 04:58, 10 March 2011 (UTC)</div>Undrlinehttp://wiki.amule.org/wiki/User_talk:UndrlineUser talk:Undrline2011-03-10T04:50:35Z<p>Undrline: Created page with 'Please, leave me a message here.'</p>
<hr />
<div>Please, leave me a message here.</div>Undrlinehttp://wiki.amule.org/wiki/FirewallFirewall2011-03-10T04:45:54Z<p>Undrline: Created Belkin Router Configuration</p>
<hr />
<div><center><br />
'''English''' | <br />
[[Firewall-de|Deutsch]] | <br />
[[Firewall-es|Espa&ntilde;ol]]<br />
</center><br />
<br />
== Routers ==<br />
Here is a list of routers and how to set them up to forward their ports to [[aMule]].<br />
<br />
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]].<br />
<br />
=== Linksys WRT54GSV4 ===<br />
#Open your web browser, ''http://192.168.1.1'' and log into it<br />
#Go under ''Gaming applications''<br />
#Now forward the ports to your computer:<br />
##[[Standard client TCP port]]<br />
###Change both ''Ports start'' and ''End'' to ''4662''<br />
###In the next field set ''TCP''<br />
###In the field, the last 3 digits of your LAN [[IP address|IP]]<br />
##[[Extended client UDP port]]<br />
###Change both ''Ports start'' and ''End'' to ''4672''<br />
###In the next field set ''UDP''<br />
###In the field, the last 3 digits of your LAN [[IP address|IP]]<br />
##[[Extended server requests UDP port]]<br />
###Change both ''Ports start'' and ''End'' to ''4665''<br />
###In the next field set ''UDP''<br />
###In the field, the last 3 digits of your LAN [[IP address|IP]]<br />
#Now check ''Enable''<br />
#And click ''Save settings''<br />
#Then restart aMule :)<br />
<br />
=== [http://www.linksys.com Linksys] Router configuration ===<br />
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.<br />
<br />
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'''.<br />
<br />
At this point, you should see a table with 6 columns. The columns are: ''Application'', ''Start to'', ''End'', ''Protocol'', ''IP Address'', ''Enable''.<br />
<br />
'''The Application column'''<br><br />
Friendly name for the service. Put anything you want here, [[aMule]] being suggested.<br />
<br />
'''The Start to -> End column'''<br><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''.<br />
<br />
I suggest using 2 separate entries for each port unless this is not possible.<br />
<br />
'''The Protocol column'''<br><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]].<br />
<br />
'''The IP Address column'''<br><br />
Internal [[IP address]] to forward requests to. This is typically the internal (private) [[IP address]] of the computer that will use [[aMule]].<br />
<br />
'''The Enable column'''<br><br />
Enable rule. You'll need to check this in order to enable your [[aMule]] rules.<br />
<br />
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].<br />
<br />
=== [http://www.dlink.com DLink] Router configuration ===<br />
Log in to your [http://www.dlink.com DLink] router. There are three steps to take to enable your [[aMule]] [[port]]s.<br />
<br />
'''IP Address setup'''<br />
<br />
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:<br />
<br />
*'''Name''': Type in the name of your computer here, could be anything<br />
*'''IP''': The [[IP address]] you want the router to always assign to your computer<br />
*'''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<br />
*Click ''Apply''<br />
<br />
Now your computer will always receive the same [[IP address]].<br />
<br />
Now click on the ''Advanced'' tab, and there are two areas that need to be updated:<br />
<br />
'''Virtual Server'''<br />
*Click the ''Virtual Server'' button. This page forwards external requests to a specific internal [[IP address]] in your network<br />
*Click ''Enabled''<br />
*Enter a name in the ''Name'' entry box, eg ''aMule TCP''<br />
*Enter your static [[IP address]] in the ''Private IP'' box<br />
*Select [http://www.ietf.org/rfc/rfc793.txt TCP] in ''Protocol type''<br />
*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''<br />
*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''<br />
*Schedule is the times at which the port is open. Select ''Always'', or whatever times you wish<br />
*Click ''Apply''<br />
<br />
'''Applications'''<br />
*Click the ''Applications'' button. This page allows you to enter a range of [[port]]s to open for application usage<br />
*Click ''Enabled''<br />
*Enter the [http://www.ietf.org/rfc/rfc793.txt TCP] [[port]] in the first ''Trigger Port'' box, a good value being ''4662''<br />
*Select ''Trigger Type'' as [http://www.ietf.org/rfc/rfc793.txt TCP]<br />
*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''<br />
*Select ''UDP'' as the ''Public Type''<br />
*Click ''Apply''<br />
<br />
You should now be all set, assuming that your computer firewall is setup to allow access on the selected [[port]]s.<br />
<br />
'''Alternate Configuration (ie instead of Applications) for D-Link '''<br />
*Go back to virtual server and set 2 other virtual servers for the UDP ports<br />
(It works only that way on my D-Link DI-804HV)<br />
<br />
*Virtual server aMuleUDP4665 - select your IP address and UDP and 4665 (port)<br />
<br />
*Virtual Server aMuleUDP4672 - select your ip address and UDP and 4672 (port)<br />
<br />
(disable the above amule applications if you did try and it do not work).<br />
Then you shoudl have all arrows green ( and 3 virtual servers running for amule, 1 for TCP and 2 for UDP).<br />
<br />
'''Another Alternate Configuration (using Firewall rules) for D-Link (tested on D-Link DI-624) '''<br />
*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'''<br />
<br />
*Click ''Enabled''<br />
<br />
*Enter your preferred name for the rule (must be unique)<br />
<br />
*Select ''WAN'' as source interface and ''*'' for source IP Range Start (IP Range End can be left blank)<br />
<br />
*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)<br />
<br />
*Select ''*'' as destination protocol<br />
<br />
*Enter ''4662-4672'' as destination port range<br />
<br />
*Select your preferred scheduling<br />
<br />
*Click apply<br />
<br />
'''IMPORTANT NOTE''': disable all existing entries for aMule you may have specified in ''Virtual server'' or ''Applications'' tabs.<br />
<br />
*Reboot your router to be sure new configuration is applied (''Tools'' -> ''Misc'').<br />
<br />
<br />
=== [http://www.belkin.com Belkin] Router configuration ===<br />
Log in to your Belkin router: [http://192.168.2.1 192.168.2.1]. You will be following these steps twice: once to create a [http://www.ietf.org/rfc/rfc793.txt TCP] record, and again to create a UDP record.<br />
<br />
*Click the ''Virtual Servers'' link in the ''Firewall'' section on the left. This page forwards external requests to a specific internal [[IP address]] in your network<br />
*Pick the first empty row<br />
*Check ''Enabled''<br />
*Enter any name you like in the ''Description'' entry box, eg: ''aMule TCP/UDP''<br />
*For the ''Inbound port'' entry boxes, enter ''4660'' and ''4712''.<br />
*Select ''TCP'' or ''UDP'' out of the ''Type'' dropdown. If you already have one set up, pick the other.<br />
*For ''Private IP address'' enter the IP address the router assigned your machine. There are many ways to find this. Ubuntu users might want to use gnome-nettool (Network Tools) and look at the IPv4 entry under the appropriate network interface. If you like the terminal, type ifconfig and look for the inet addr entry. If you're in Windows, you can type ipconfig from the command line. No matter how you do it, the number should look like 192.168.2.x where x is the number you will be entering.<br />
*''Private port'' is the [[port]] that the router will forward the requests to on your computer. Though this can be anything, the default [[aMule]] port is 4662 for TCP and 4672 for UDP. Entering ''4660'' and ''4712'', same as the inbound port range above, will cover other possible ports.<br />
*Repeat the steps above to make sure you have an entry for both TCP and another entry for UDP.<br />
*Click ''Apply''<br />
*If you have aMule open, go to it click ''Disconnect''. When the button changes, click ''Connect''. Kad should no longer be firewalled and you should not get another Low ID error. If you do still have issues, make sure you completed all the steps correctly by testing your ports: [http://www.amule.org/testport.php http://www.amule.org/testport.php]<br />
<br />
Keep in mind that the ''Private IP address'' number could change if you're ever disconnected from the router, because it is dynamically assigned by default.<br />
<br />
=== Netgear router ===<br />
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.<br />
<br />
Not all Netgear routers are the same, evidently, because on the DG834G it's more complicated. Go to the router's configuration page:<br />
# Select '''Services''' from the '''''Content Filtering''''' menu<br />
# Add your three rules (1 x TCP, 2 x UDP) based on your aMule Connection preferences<br />
# Select '''Firewall Rules''' from the same menu<br />
# Add all three rules as ''Inbound Services''<br />
# Add both UDP rules as ''Outbound Services'' (only one of these is crucial but I add the other just in case)<br />
<br />
=== TRENDnet router TW100 ===<br />
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 <br />
you did set one). <br />
<br />
Then On the left side Menu, Select Internet and thenselect Advanced Setup (Advanced Internet). Then click/select, [Special Applications]: <br />
<br />
Add or replace 2 lines in the Special Applications list: <br />
(Try not to remove something which you are using and which is already enabled) <br />
(just add the new application for amule at the end in position Nr. 5 or Nr.6 in the list for example): <br />
<br />
Create the entries as follows: <br />
<br />
amuleU4665 TCP-4665-4665 UDP-4665-4665 <br />
<br />
amuleU4672 TCP-4672-4672 UDP-4672-4672 ) <br />
<br />
(In my Application List the “amuleU4665” and “amule4672” are in Nr1 and Nr2 but it can be in any position in your list). <br />
<br />
->Click on the small box [ ] on the left for both lines of your amuleUxxxx applications to enable the special applications to work! <br />
<br />
Then click on [Save], then click on [Close] <br />
<br />
Then click on [Save] again on the page – Advanced Internet . <br />
<br />
The next and last step is to click on the “Virtual Servers” menu on the left side, then the “Virtual Server page will appear”: <br />
<br />
Add a new virtual server named like: AmuleTCP <br />
<br />
Select your computer* IP Address: in the DropDown Menu <br />
<br />
Select: TCP <br />
<br />
Write the 4662 Port and 4662 port (both fields the same port)<br />
<br />
Then [Add as new server] <br />
<br />
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. <br />
<br />
''Important Note:''<br />
*Be careful in the case that your computer is using the DHCP protocol (ie to obtain IP address from the router). <br />
The router might not give all the time the same IP address to your computer. <br />
(normally it does so... but sometimes it can change). <br />
You have two solutions if you see that you have a low- ID then: (2 solutions)<br />
<br />
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. <br />
<br />
Or an alternative solution : <br />
<br />
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.<br />
<br />
'''In the case that your TRENDNet router crashes or stop forwarding any''' traffic from/to your aMule computer . (it happened to me), then :<br />
<br />
- reduce the Connection limit (in Preferences->Connection) to 100 (or to 50)<br />
- reduce the "Max new connections / 5 secs" (in Preferences->Core Tweaks) to 10 (or to 5) <br />
Stop amule and restart aMule so that configuration will be validated.<br />
<br />
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(?). <br />
<br />
''(TRENDnet Firewall from RFV - --[[User:Robert364|Robert364]] 17:05, 5 Nov 2006 (CET))<br />
''<br />
<br />
=== OpenBSD ===<br />
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):<br />
<br />
# aMule TCP and UDP<br />
rdr pass on egress proto tcp to port 4662 -> IPADDR<br />
rdr pass on egress proto udp to port 4672 -> IPADDR<br />
rdr pass on egress proto udp to port 4665 -> IPADDR<br />
<br />
IPADDR is the internal ip-address of the computer in your network that runs aMule.<br />
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><br />
<br />
Example (IP of computer running aMule is '''192.168.1.10'''):<br />
<br />
# aMule TCP and UDP<br />
rdr pass on egress proto tcp to port 4662 -> '''192.168.1.10'''<br />
rdr pass on egress proto udp to port 4672 -> '''192.168.1.10'''<br />
rdr pass on egress proto udp to port 4665 -> '''192.168.1.10'''<br />
<br />
Of course, the computer running aMule must also have access to the internet so add the following rules too:<br />
<br />
nat on egress from IPADDR to any -> (egress)<br />
<br />
IPADDR is the internal ip-address of the computer in your network that runs aMule.<br />
<br />
Example (like above):<br />
<br />
nat on egress from '''192.168.1.10''' to any -> (egress)<br />
<br />
To activate the changed configuration, reboot or execute the following command:<br><br />
<br />
pfctl -f /etc/pf.conf<br />
<br />
In order to have the firewall automatically loaded at boot :<br />
<br />
echo PF=yes >> /etc/rc.conf.local<br />
<br />
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):<br />
<br />
no nat on egress proto udp from '''192.168.1.10''' port 4672 to any<br />
<br />
See [[FAQ eD2k-Kademlia#Why does Kademlia still say it is firewalled?|the FAQ]] on "Why does Kademlia still say it is firewalled?"<br />
<br />
<br />
<br />
== My router is not here? ==<br />
<br />
<br />
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/</div>Undrlinehttp://wiki.amule.org/wiki/Comment_iconComment icon2011-02-21T02:37:06Z<p>Undrline: </p>
<hr />
<div><center><br />
'''English''' | <br />
[[Comment icon-de|Deutsch]] | <br />
[[Comment icon-ru|Russian]] | <br />
[[Comment icon-nl|Dutch]]<br />
</center><br />
<br />
When a [[comment]] or a [[rate]] about a [[file]] is know to [[aMule]] an [[indicators|indicator]] will appear by the file's filename so that the user knows about it and checks it.<br />
<br />
Depending on the rate the file has been given the icon will change:<br />
{|<br />
| http://www.amule.org/dev-up/comments1.jpg || The file has a comment but has not been rated<br />
|-<br />
| http://www.amule.org/dev-up/comments2.jpg || The average rate of the file is very bad (probably a [[corrupt]] or a [[fake]])<br />
|-<br />
| http://www.amule.org/dev-up/comments3.jpg || The average rate of the file is poor (possible corrupt, a fake or a [[valid]] file with very bad quality)<br />
|-<br />
| http://www.amule.org/dev-up/comments4.jpg || The average rate of the file is good<br />
|-<br />
| http://www.amule.org/dev-up/comments5.jpg || The average rate of the file is fair<br />
|-<br />
| http://www.amule.org/dev-up/comments6.jpg || The average rate of the file is excellent<br />
|}</div>Undrlinehttp://wiki.amule.org/wiki/Getting_StartedGetting Started2011-02-21T02:34:38Z<p>Undrline: /* Icons and What They Signify */</p>
<hr />
<div><center><br />
'''English''' | <br />
[[Getting Started-da|Dansk]] | <br />
[[Getting_Started-de|Deutsch]] | <br />
[[Getting_Started-es|Espa&ntilde;ol]] | <br />
[[Getting Started-fi|Suomi]] | <br />
[[Getting_Started-fr|Fran&ccedil;ais]] | <br />
[[Getting_Started-hu|Magyar]] | <br />
[[Getting Started-it|Italian]] | <br />
[[Getting_Started-nl|Nederlands]] | <br />
[[Getting Started-ru|Russian]]<br />
</center><br />
<br />
== What is [[aMule]] ==<br />
[[aMule]] is a [[P2P|p2p]], or peer-to-peer, client for the [[FAQ_eD2k-Kademlia|eD2k]] network, commonly known as [[FAQ_eD2k-Kademlia|eDonkey network]] or eD2k network ([[eDonkey2000]]). This guide does not require you to be familiar with these networks (but it does help), however it does require that you have [[aMule]] installed on your computer.<br />
If you haven't installed [[aMule]] yet, please refer to the proper installation guide for your system. Links to these guides can be found on the [[Main_Page|main page]].<br />
<br />
== Running [[aMule]] for the first time ==<br />
First, launch [[aMule]]. This can be done by executing the command ''amule'' in a console window or by whatever method might be provided by your distro and/or windows manager in terms of icons, etc.<br />
<br />
Once started, if you are using the [http://subversion.tigris.org/ SVN] build, [[aMule]] will display a notification telling you that you are running it for the first time. Read this to learn what you are getting yourself into ;)<br />
<br />
Please note that aMule makes extensive use of right-click menus, so if you can't find a function, try right-clicking on the item you wish to manipulate.<br />
<br />
=== Configuring [[aMule]] ===<br />
Before you begin file sharing, you will need to properly configure [[aMule]]. This includes connection speeds and limits, directories to be used, proxies, port settings and other settings.<br />
You can access [[aMule]] preferences by clicking on the ''Preferences'' icon at the top of the [[aMule]] window. On Macintosh (Intel) platform, click on the "tools" icon in the upperbar. <br />
<br />
==== Connection Speed ====<br />
You should know that the eDonkey clients enforce upload. This means that in order to download, you'll have to share files yourself (don't worry if you don't have anything to share). This is enforced in two ways:<br />
* Your download speed depends on how fast you upload. If your upload speed is set to anything below 10kb/s then your maximum download speed will be 3 or 4 times your uploadspeed (read [[FAQ_eD2k-Kademlia#Are_there_any_limitations_on_the_ED2K_network?|this]] to know more about it), so if you limit your upload speed to 5kb/s, you'll only be able to download with 20kb/s.<br />
* Partially downloaded files are shared as well. You automatically start sharing a file after you've received at least one [[FAQ_eD2k-Kademlia#What_is_a_chunk?|chunk]] (a [[FAQ_eD2k-Kademlia#What_is_a_chunk?|chunk]] is a 9.28Mb piece of a file).<br />
<br />
Note: If you ever enter the [http://forum.amule.org aMule forum] or [[IRC|IRC channel]] to complain about this or demand that we change the ratio, I will hunt you down and eat your spleen. -- [[User:Xaignar|Xaignar]]<br />
<br />
When you first open the Preferences dialog, the page shown will be "General", which contains some general settings, like the [[nickname]] other people will see when they download from or upload to you. <br />
To proceed, click on the tab named "Connection":<br />
<br />
[[Image:Limits_aMuleSVN_Fedora_Gnome.png]]<br />
<br />
The only settings relevant to this guide are the settings under "Bandwidth Limits" marked "Upload" and "Download". You don't need to enter a max download speed, but it is recommended that you set the upload speed to around 80% of your actual speed, since it can cause slower downloads otherwise.<br />
<br />
Bear in mind that the values for speed are usually given in kilo Bits per second [kb/s] but the values to be entered in the text fields 'Download', 'Upload' and 'Slot Allocation' contained in "Bandwith Limits" are in kilo Bytes per second [kB/s]. To convert to kilo Bytes simply divide the kilo Bits value by 8.<br />
<br />
Example:<br><br />
Maximum Downstream: 1024kb/s ÷ 8 = 128 kB/s<br><br />
Maximum Upstream: 512kb/s ÷ 8 = 64 kB/s<br><br />
<br />
Once you have entered the proper values, you can explore the rest of the settings. To save the changes, simply click the "OK" button.<br />
<br />
=== ED2K and Kademlia ===<br />
aMule is also capable of connecting to the serverless network dubbed [[Kademlia]]. This allows aMule and other eDonkey2000 clients to function without having to rely on generous souls running servers. Both [[Kademlia]] and the server-based [[ED2k]] network are enabled by default, but you can disable either of the two networks on the lower part prefences page titled 'Connection'. Users with slow upload speeds should consider enabling only one of the two networks, due to the added overhead.<br />
<br />
=== Connecting to a Server ===<br />
You should now be looking at the servers dialog:<br />
<br />
[[Image:Serverlist_aMule_Fedora_Gnome.png]]<br />
<br />
The empty list normally contains the servers you know about, but since this is the first time you're running [[aMule]], you don't have any. To remedy this situation, simply click in the text-field containing the text ''http://gruk.org/server.met.gz'' (you can also use the url 'http://peerates.net/servers.php') and press enter.<br />
A dialog will pop up and close again once the download has completed.<br />
<br />
You should now have a full list of servers, if not search google for ''server.met'', replace the url mentioned above and press enter to initiate the download.<br />
<br />
[[Image:Serverlist-ed2k_aMule_Fedora_Gnome.png]]<br />
<br />
Next you need to connect to a [[server]]. Normally it's a good idea to select one with as many users as possible, but for now, let's just click the large "Connect" button near the top-left of the window. This will connect you to a random server. Please wait while [[aMule]] contacts servers and tries to establish a connection. Once this happens, proceed on to the next section.<br />
<br />
=== Connecting to the Kademlia Network ===<br />
To connect to the [[Kademlia]] network, provided that it is enabled in the preferences, all you need to do is press the "Connect" button on the top toolbar. Note that manually connecting to a server (by double-clicking or right-clicking and selecting the 'Connect to server' item) won't connect you to the [[Kademlia]] network. Another way to connect to the [[Kademlia]] network is to enter the 'Kad' sub-page on the 'Networks' page, and press the '[[Bootstrap]] from known clients' button. In case this is the first time you use Kad, you may want to update your [[nodes.dat file]], by clicking in the Url textfield and pressing enter, or by clicking the "blue play button" http://forum.amule.org/images/bunfirlite/lastpost.gif by that bar. It is not necessary to do this again later, as the nodes list is kept up to date when aMule is running.<br />
<br />
[[Image:Serverlist-kad_aMule_Fedora_Gnome.png]]<br />
<br />
=== [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|High and Low ID]] ===<br />
Because [[P2P|p2p]] networks work by [[Client|clients]] directly connecting to each other, being behind a firewalls, or routers that do not/cannot pass traffic on specific ports, can really cause problems. If you don't know whether or not you are behind a firewall, simply look at the globe icon in the bottom-right of the window. If its arrows are green, then you have [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|High ID]] and can proceed, but if they are yellow, then you need to take a look at the page on [[Firewall|Firewalls]] and/or [[AMule_problems#aMule_connects_to_server,_but_it_is_always_given_LowID._Why?_and,_can_I_do_something_about_it?|common problems]], since having a [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|Low ID]] greatly reduces [[P2P|p2p]] experiences.<br />
<br />
== Basic Usage ==<br />
This will cover some basic usage of [[aMule]].<br />
<br />
=== Searching and Downloading ===<br />
OK, this is what [[P2P|p2p]]'ing is about: Downloading files.<br />
For the sake of this guide, I'll presume that you are really keen on downloading the latest [http://www.knoppix.org Knoppix] CD (who isn't?). To download this, first ensure that you are connected to a server, or the [[Kademlia]] network, and then click on the "Searches" button.<br />
<br />
This will bring up the search dialog:<br />
<br />
[[Image:Searchdlg_aMuleSVN_Fedora_Gnome.png]]<br />
<br />
Since we only care about CD images, we select the checkbox "Extended Parameters" and select the option "CD-Images" from the "File Type" dropdown menu. If you are connected to an [[ED2K]] server, select the "[[Search#Local_search|Local]] [[Search]]" setting, since we don't really need to search anything other than the currently connected [[server]]. Otherwise, if you are connected to the [[Kademlia]] network, select the 'Kad' search-type. Then we enter ''Knoppix'' in the top "Name" field and hit enter or the "Search" button. You should now have a listful of results:<br />
<br />
[[Image:Searchresults_aMuleSVN_Fedora_Gnome.png]]<br />
<br />
Let's sort the list by [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]], by clicking twice on the field marked "Sources", this makes it easier to find popular files. The second one looks interesting, so we double-click on it (or click on it and then on the "Download" button). This will queue the file for download.<br />
<br />
Results can be displayed in a number of colors, which signify the following:<br />
* Blue represents the number of sources, the more sources the darker the blue.<br />
* Red represents files that you are currently downloading.<br />
* Green is for files you have downloaded or shared before, in other words files you already have.<br />
<br />
====Advanced Searches====<br />
<br />
Amule supports advanced or Boolean searches. These are searches that have AND, OR, or NOT as keywords in the search. Each boolean expression can be delimited by brackets "(" and ")".<br />
<br />
Example:<br />
<br />
(knoppix AND V5.1.1) OR (knoppix AND V6.0)<br />
<br />
<br />
====Filtering results====<br />
<br />
Many of the results you receive will be spam or complete rubbish. These can be filtered out using the filter field in the search dialog. This field accepts "regular expressions". The regular expression system it implements is that of the [http://docs.wxwidgets.org/2.6.3/wx_wxresyn.html wxRegEx] library. By default the filter is a search, it removes anything which does not match. This behaviour can be reversed.<br />
<br />
Examples;<br />
<br />
'porn|sex' Will filter any string which contains the text "porn" or "sex".<br />
<br />
'^word' will filter any string which begins with "word".<br />
<br />
'word$' will filter any string which ends with "word".<br />
<br />
=== Search Types ===<br />
I only mentioned 'Local' and 'Kad' searching above. <br />
<br />
A local search only asks the server you are connected to, and is enough in most cases. However, if this does not return any results, you can ask all servers in your serverlist, by doing a 'Global' search. This however takes a lot longer (0.75s per server). <br />
<br />
Lastly, you can search on the 'Kademlia' network via the 'Kad' search-type. Note that on the 'Kad' network, results signify complete sources, unlike 'ED2K' searches, where the source-count contains both complete and incomplete sources.<br />
<br />
=== The Download Queue ===<br />
Click on the "Transfers" button to bring forth a list of files you have queued for download:<br />
<br />
[[Image:Up&down_queue_aMuleSVN_fedora_gnome.png]]<br />
<br />
<br />
If you're lucky, the progress bar will turn a nice dark shade of blue, which means that a lot of people have that file (read [[FAQ_aMule#What_do_those_colors_in_the_progress_bar_mean?|this]] to know more about it). Beware of files that have parts marked in red, since it means that no-one has that part of the file and you most likely wont be able to complete the download.<br />
<br />
If you double-click on any of the files, you can see the [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] you have found for that file.<br />
<br />
==== Of Rows and Columns ====<br />
These are the columns of the Download Queue:<br />
<br />
; ''Filename'' : The name of the file.<br />
; ''Size'' : The size of the file. The eDonkey2000 network supports files up to 4GB in size (read [[FAQ_eD2k-Kademlia#Are_there_any_limitations_on_the_ED2K_network?|more]] about this).<br />
; ''Transferred'' : Shows the amount downloaded.<br />
; ''Completed'' : This column displays how much of the file you have actually completed. Please note that this can differ from the Transferred column because of corruptions or gains made by the compression *Mule [[Client|clients]] use (read [[FAQ_aMule#What_is_the_difference_between_Transfered_and_Completed_in_the_Transfers_window?|more]] about this difference).<br />
; ''Progress'' : This bar displays the current progress of the file, the colours signifying the following (alternative [[FAQ_aMule#What_do_those_colors_in_the_progress_bar_mean?|resource]]):<br />
* Blue: How many sources provide this part, the darker the colour, the more sources provide it.<br />
* Red: There are no known [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] that provide this part.<br />
* Black: You have already downloaded this part.<br />
* Yellow: You are currently downloading this part.<br />
: The green bar on top of the larger bar gives an indication of the actual progress.<br />
; ''Sources'' : There are 3 fields in this column, though mostly only 2 are shown (alternative [[FAQ_aMule#What_do_all_those_numbers_in_the_sources_column_in_the_transfers_window_mean?|resource]]):<br />
: <Asked [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]>[/<All [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]>] [+ <[[FAQ_aMule#What_is_A4AF?|A4AF]] [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]> ] [(<Transferring [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]]>)]<br />
: 'Asked [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]' are those that have been asked for the file.<br />
: 'All [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]' are all [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] of that file, asked and unasked.<br />
: '[[FAQ_aMule#What_is_A4AF?|A4AF (Asked For Another File)]] [[FAQ_eD2k-Kademlia#What_is_a_source?|Sources]]' are [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] that provide that file, but have been asked for anther one.<br />
: 'Transferring [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]]' are [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] which are uploading that file to you at this very moment.<br />
; ''Priority'' : The priority of the file. Files are set to auto-priority by default, which means that [[aMule]] will manage it by itself. Priorities affect how [[aMule]] allocates [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] that are known to provide multiple files and thus means that high-priority files get more [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]]. Read [[FAQ_aMule#What_do_all_those_numbers_in_the_priority_column_in_the_extended_transfers_window_mean?|more]] about this.<br />
; ''Status'' : The current status of the file. Waiting means that you are waiting for [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] to start uploading to you.<br />
; ''Time Remaining'' : A guess at how fast the file will be completed. Only shows something when you are currently receiving the file.<br />
; ''Last Seen Complete'' : This shows the last time you've seen the entire file provided by the [[FAQ_eD2k-Kademlia#What_is_a_source?|sources]] you've asked.<br />
; ''Last Reception'' : This shows the last time you were downloading parts of this file.<br />
<br />
=== The Upload Queue ===<br />
The upload queue can be found just beneath the download queue, and shows who are downloading files from you (you might want to read [[FAQ_aMule#Why_are_there_two_transfer_rates_in_the_uploading_transfer_list?|this]]). In case you are wondering, no, you cannot stop uploads. If you click on the blue icon next to the "Uploads" label, you can see who are queued for downloading from you, rather than the people who are actually downloading from you right now.<br />
<br />
=== Icons and What They Signify ===<br />
These are the [[indicators]] that can be found on the Transfers page.<br />
<br />
* '''Source Status''' <br />
** http://www.amule.org/dev-up/Source_1.png - [[Client]] is sending you either a file or a hashset.<br />
** http://www.amule.org/dev-up/Source_2.png - You are either on this [[Client|clients]] queue or currently asking it for a file.<br />
** http://www.amule.org/dev-up/Source_3.png - You are currently connecting to this [[Client|client]].<br />
** http://www.amule.org/dev-up/Source_4.png - [[Client]] has been asked for another file, has no needed parts or is unable to connect because of a [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|Low ID]].<br />
** http://www.amule.org/dev-up/Source_5.png - Status is unknown.<br />
<br />
* '''eDonkey Clients'''<br />
** http://www.amule.org/dev-up/Client_aMule.png - [[aMule]]<br />
** http://www.amule.org/dev-up/Client_eDonkey.png - [[eDonkey2000]]<br />
** http://www.amule.org/dev-up/Client_eMule.png - [[eMule]]<br />
** http://www.amule.org/dev-up/Client_Friend.png - [[Client]] is a [[Friend]]<br />
** http://www.amule.org/dev-up/Client_Lphant.png - [[lphant]]<br />
** http://www.amule.org/dev-up/Client_MLDonkey.png - [[mlDonkey]]<br />
** http://www.amule.org/dev-up/Client_Shareaza.png - [[Shareaza]]<br />
** http://www.amule.org/dev-up/Client_Unknown.png - Unknown [[Client]]<br />
** http://www.amule.org/dev-up/Client_xMule.png - [[xMule]]<br />
<br />
* '''Modifiers'''<br />
** http://www.amule.org/dev-up/Client_Mod_eMuleProt.png - [[Client]] supports the extended [[eMule]] protocols. Source-sharing and such.<br />
** http://www.amule.org/dev-up/Client_Mod_GoodCredit.png - [[Client]] has a good [[FAQ_eD2k-Kademlia#What_is_all_this_talk_about_credits,_ratings_and_scoring_about?|credit-rating]].<br />
** http://www.amule.org/dev-up/Client_Mod_NormCredit.png - [[Client]] has a normal [[FAQ_eD2k-Kademlia#What_is_all_this_talk_about_credits,_ratings_and_scoring_about?|credit-rating]].<br />
** http://www.amule.org/dev-up/Client_Mod_SecId_Good.png - [[Client]] has been [[Secure_User_Identification|securely identified]].<br />
** http://www.amule.org/dev-up/Client_Mod_SecId_Bad.png - [[Client]] has been identified for some reason as a [[bad guy]].<br />
<br />
* '''File [[comment]]s''' icons are explained in the [[comment icon]]s article.<br />
<br />
=== Categories for Downloads ===<br />
It is possible to assign downloads to a category, which can have a unique color on the download listctrl, and can be saved to a different folder than the default one. <br />
<br />
To add a new category, right-click (and hold) on the tab titled 'All', which is located next to the green tick, just below the toolbar on the Transfers page. Then select 'Add Category' and fill in the desired details. A random color is selected by default, but this can be changed.<br />
<br />
To add a file to a category, right-click on it in the download listctrl, and select the desired category in the "Assign to Category" submenu. The item 'Unassigned' will assign it to the default category.<br />
<br />
When categories are added, a matching tab is added next to the original 'All' tab. Left-clicking on these will change the display to only display files assigned to this category. As a final note, the default view, the 'All' tab, allows for various forms of filtering. These can be accessed by right-clicking on the tab and selecting from the 'Select view filter' submenu.<br />
<br />
=== Where Are The Files? ===<br />
Once [[aMule]] starts downloading a file, it will create a number of files to keep track of that specific download. These files can be found in the subdir ''.aMule/Temp'' in your homedir (''~/.aMule/Temp'') on Linux and in ''~/Library/Application Support/aMule/Temp'' on Mac OS X, but should not be touched in most cases. <br />
<br />
If you have incompleted downloads from [[eMule]], you can simply place the temp files in that ''Temp'' directory if you wish for [[aMule]] to continue downloading them.<br />
<br />
However, once a file has been completed, it will be moved away from ''Temp'' and to ''~/.aMule/Incoming'' (Linux) or ''~/Library/Application Support/aMule/Incoming'' (Mac OS X), where all completed files are placed by default. You can change both of these paths in the preferences should you wish to do so.<br />
<br />
Also, please note that on Linux, the ''.aMule'' directory is a hidden directory, so you might have to enable showing of hidden files in your file-mananger, should you use one such.<br />
<br />
On Windows aMule uses the place suggested by the operationg system. For XP this is usually ''C:\Documents and Settings\your name\Application Data\aMule'' (named differently for non English versions), for Vista ''C:\Users\your name\AppData\Roaming\aMule''.<br />
<br />
You can always change (or locate...) the path of your temp and incoming files in Preferences/Directories.<br />
<br />
If there is a subdir ''config'' in the directory where the aMule executable lies, the configuration files are stored and looked for there, so you could run it from a USB memory.<br />
<br />
=== [[Share|Sharing]] [[File]]s ===<br />
First off, note the [[FAQ_eD2k-Kademlia|eDonkey2000 network]] is not meant to [[share]] small [[file]]s such as audio clips, but instead is optimized for distribution of larger [[file]]s. Also note that its your own responsibility to ensure that you do not violate any local laws regarding material shared.<br />
<br />
You can share files in two ways in [[aMule]]: <br />
<br />
The first method is to place the [[file]]s in the "Incoming" directory (''~/.aMule/Incoming'' on [http://www.unix.org Unix] like systems). After this has been done, you must either restart [[aMule]] or press the "Reload" button on the SharedFiles page.<br />
<br />
[[Image:Reload.png]]<br />
<br />
The second method is to explicitly add [[shared directory|shared directories]] in which [[aMule]] will look for [[file]]s to [[share]]. This is done by clicking on the "Preferences" button and selecting the "Directories" page.<br />
<br />
[[Image:Prefs_aMuleSVN_Fedora_Gnome.png]]<br />
<br />
From there, you can browse to the directory you wish to [[share]] via the directory-tree. Double-clicking on the folder icon will [[share]] the given directory and right-clicking on the folder icon will [[share]] the directory recursively.<br />
<br />
== Conclusion == <br />
Hopefully this brief introduction has given you an idea of how [[aMule]] works. If you feel that something is missing from this guide, please let us know or add it yourself.</div>Undrline