Difference between revisions of "Getting Started"
m (Reverted edit of 81.182.126.120, changed back to last version by 81.11.176.162) |
|||
Line 129: | Line 129: | ||
== Conclusion == | == Conclusion == | ||
Hopefully this brief introduction has given you an idea of how [[aMule]] works. If you feel that something is missing from this guide, please let us know or add it yourself. | 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. | ||
− | |||
− | |||
− | |||
− | |||
− |
Revision as of 14:24, 16 August 2004
What is aMule
aMule is a client for the peer-to-peer networked commonly called the eDonkey network, or the ed2k network (eDonkey2000). This guide does not require that you are familiar with another network (but it helps), however it does require that you have gotten aMule installed on your computer. If you haven't installed aMule yet, then please refer to the installation guide appropriate for your system. Links to these can be found on the main page.
--Xaignar 01:12, 10 Jul 2004 (CEST)
Running aMule for the first time
Start by running aMule. Usually this can be done by executing the command amule in a console window or by whatever method might be provided by your distro and windows manager.
Once started, if you are using a CVS build, aMule will display a notification telling you that you are running it for the first time. Read this to learn what you are getting yourself into ;)
Configuring aMule
On the top of the aMule window, there is a row of labelled icons. Click the one marked preferences to enter the configuration dialog. Before you start downloading files, you'll need to properly set your connection speed and possibly other settings.
Connection Speed
You should know that the eDonkey clients enforce upload, which means that in order to download, you'll have to share files yourself (don't worry if you don't have anything to share). This is enforced in two ways:
- Your download speed depends on how fast you upload. If your upload speed is set to anything below 10kb/s, your maximum download speed will be 3 or 4 times your uploadspeed (read this to know more about it), so if you limit your upload speed to 5kb/s, you'll only be able to download with 20kb/s.
- Partially downloaded files are shared as well. You automatically start sharing a file after you've received at least one chunk (a chunk is a 9.28Mb piece of a file).
Note: If you ever enter the aMule forum or IRC channel to complain about this or demand that we change the ratio, then I will hunt you down and eat your spleen. -- Xaignar
When you first open the Preferences dialog, the page shown will be "General", which contains some general settings, like the nickname other people will see when they download from or upload to you. To proceed, click on the tab named "Connection":
The only settings relevant to this guide are the settings under "Bandwidth Limits" marked "Upload" and "Download". You don't need to enter a max download speed, but it is recommended that you set the upload speed to around 80% of your actual speed, since it can cause slower downloads otherwise.
Once you have entered the proper values, you can explore the rest of the settings. To save the changes, simply click the "OK" button.
Connecting to a Server
You should now be looking at the servers dialog: http://www.amule.org/dev-up/ServerDlg.png
The empty list normally contains the servers you know about, but since this is the first time you're running aMule, you don't have any. To remedy this situation, simply click in the text-field containing the text http://www.srv1000.com/azz/server.met and press enter. A dialog will pop up and close again once the download has completed.
You should now have a full list of servers, if not search google for server.met and place the file in the folder .aMule on your home dir. The list should look like this: http://www.amule.org/dev-up/ServerList.png
Next you need to connect to a server. Normally it's a good idea to select one with as many users as possible, but for now, lets just click the large "Connect" button near the top-left of the window. This will connect you to a random server. Please wait while aMule contacts servers and tries to establish an connection. Once this happens, proceed on to the next section.
High and Low ID
Because p2p networks works by clients directly contact each other, being behind a firewall or router can really cause problems. If you don't know whenever or not you are behind a firewall, simply look at the icon in the bottom-right of the window. If it is green, then you have High ID and can proceed, but if it is yellow, then you need to take a look at the page on Firewalls and/or common problems, since having Low ID means greatly reduced capabilities.
Basic Usage
This will cover some basic usage of aMule.
Searching and Downloading
OK, this is what p2p'ing is about: Downloading files. For the sake of this guide, I'll presume that you are really keen on downloading the latest Knoppix CD (who isn't?). To download this, first ensure that you are connected to a server and then click on the "Searches" button.
This will bring up the search dialog: http://www.amule.org/dev-up/SearchDlg.png
Since we only care about CD images, we select the option "CD-Images" from the "Type" dropdown menu. Also untick the "Global Search" setting, since we don't really need to search anything other than the currently connected server. Then we enter Knoppix in the top "Name" field and hit enter or the "Search" button. You should now have a listful of results: http://www.amule.org/dev-up/SearchResults.png
Lets sort the list by sources, by clicking twice on the field marked "Sources", this makes it easier to find popular files. The second one looks interesting, so we double-click on it (or click on it and then on the "Download" button). This will queue the file for download.
The Download Queue
Click on the "Transfers" button to bring forth a list of files you have queued for download: http://www.amule.org/dev-up/DownloadQueue.png
If you're lucky, the progress bar will turn a nice dark shade of blue, which means that a lot of people have that file (read this to know more about it). Beware of files that have parts marked in red, since it means that no-one has that part of the file and you most likely wont be able to complete the download.
If you double-click on any of the files, you can see the sources you have found for that file.
Of Rows and Columns
These are the columns of the Download Queue:
- Filename
- The name of the file.
- Size
- The size of the file. The eDonkey2000 network supports files up to 4GB in size (read more about this).
- Transferred
- Shows the amount downloaded.
- Completed
- This column displays how much of the file you have actually completed. Please note that this can differ from the Transferred column because of corruptions or gains made by the compression *Mule clients use (read more about this difference).
- Progress
- This bar displays the current progress of the file, the colours signifying the following (alternative resource):
- Blue: How many sources provide this part, the darker the colour, the more sources provide it.
- Red: There are no known sources that provide this part.
- Black: You have already downloaded this part.
- Yellow: You are currently downloading this part.
- The green bar on top of the larger bar gives an indication of the actual progress.
- Sources
- There are 3 fields in this column, though mostly only 2 are shown (alternative resource):
- <Asked Sources>[/<All Sources>] [+ <A4AF Sources> ] [(<Transferring sources>)]
- 'Asked Sources' are those that have been asked for the file.
- 'All Sources' are all sources of that file, asked and unasked.
- 'A4AF (Asked For Another File) Sources' are sources that provide that file, but have been asked for anther one.
- 'Transferring sources' are sources which are uploading that file to you at this very moment.
- Priority
- The priority of the file. Files are set to auto-priority by default, which means that aMule will manage it by itself. Priorities affect how aMule allocates sources that are known to provide multiple files and thus means that high-priority files get more sources. Read more about this.
- Status
- The current status of the file. Waiting means that you are waiting for sources to start uploading to you.
- Time Remaining
- An guess at how fast the file will be completed. Only shows something when you are currently receiving the file.
- Last Seen Complete
- This shows the last time you've seen the entire file provided by the sources you've asked.
- Last Reception
- This shows the last time you were downloading parts of this file.
The Upload Queue
The upload queue can be found just beneath the download queue, and shows who are downloading files from you (you might want to read this). In case you are wondering, no, you cannot stop uploads. If you click on the blue icon next to the "Uploads" label, you can see who are queued for downloading from you, rather than the people who are actually downloading from you right now.
Icons and What They Signify
These are the icons that can be found on the Transfers page.
- Source Status
- http://www.amule.org/dev-up/Source_1.png - Client is sending you either a file or a hashset.
- http://www.amule.org/dev-up/Source_2.png - You are either on this clients queue or currently asking it for a file.
- http://www.amule.org/dev-up/Source_3.png - You are currently connecting to this client.
- 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 Low ID.
- http://www.amule.org/dev-up/Source_5.png - Status is unknown.
- eDonkey Clients
- http://www.amule.org/dev-up/Client_aMule.png - aMule
- http://www.amule.org/dev-up/Client_eDonkey.png - eDonkey2000
- http://www.amule.org/dev-up/Client_eMule.png - eMule
- http://www.amule.org/dev-up/Client_Friend.png - Client is a Friend
- http://www.amule.org/dev-up/Client_Lphant.png - lphant
- http://www.amule.org/dev-up/Client_MLDonkey.png - mlDonkey
- http://www.amule.org/dev-up/Client_Shareaza.png - Shareaza
- http://www.amule.org/dev-up/Client_Unknown.png - Unknown Client
- http://www.amule.org/dev-up/Client_xMule.png - xMule
- Modifiers
- http://www.amule.org/dev-up/Client_Mod_eMuleProt.png - Client supports the extended eMule protocols. Source-sharing and such.
- http://www.amule.org/dev-up/Client_Mod_GoodCredit.png - Client has a good credit-rating.
- http://www.amule.org/dev-up/Client_Mod_NormCredit.png - Client has a normal credit-rating.
- http://www.amule.org/dev-up/Client_Mod_SecId_Good.png - Client has been securely identified.
- http://www.amule.org/dev-up/Client_Mod_SecId_Bad.png - Client has been for some reason been identified as a bad guy.
- File comments
- http://www.amule.org/dev-up/File_Comment.png - This file has either been rated or someone has added a comment.
- http://www.amule.org/dev-up/File_Comment_Bad.png - This file has been rated as Fake by at least one person.
Conclusion
Hopefully this brief introduction has given you an idea of how aMule works. If you feel that something is missing from this guide, please let us know or add it yourself.