home *** CD-ROM | disk | FTP | other *** search
/ com!online 2005 April / com_0405_1.iso / opensource / eMule0.44d-Installer.exe / readme.txt < prev    next >
Encoding:
Text File  |  2004-09-04  |  12.7 KB  |  377 lines
  1. eMule Copyright (C)2002-2004 Merkur (merkur-@users.sourceforge.net)
  2.  
  3.  
  4. This program is free software; you can redistribute it and/or modify it under 
  5. the terms of the GNU General Public License as published by the Free Software 
  6. Foundation; either version 2 of the License, or (at your option) any later 
  7. version.
  8.  
  9. This program is distributed in the hope that it will be useful, but WITHOUT 
  10. ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 
  11. FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more 
  12. details.
  13.  
  14. You should have received a copy of the GNU General Public License along with 
  15. this program; if not, write to the Free Software Foundation, Inc., 675 Mass 
  16. Ave, Cambridge, MA 02139, USA.
  17.  
  18.  
  19. -------------------------------------------------------------------------------
  20.  
  21.  
  22. Welcome to eMule, a filesharing client based on the eDonkey2000(C) network.
  23.  
  24.  
  25. Visit us at
  26.  http://www.emule-project.net
  27. and
  28.  http://sourceforge.net/projects/emule
  29. or
  30.  the IRC chatroom, #emule on irc.emule-project.net
  31.  
  32.  
  33.  
  34. Please remember that this is an early version, not all features are 
  35. implemented yet, and not everything might work as expected.
  36.  
  37. Visit our forum for bugreports, feature requests, development or general 
  38. dicussion.
  39.  
  40.  
  41. If you have questions or serious problems, please read the FAQ first :) It can 
  42. be found at www.emule-project.net. A small collection of questions is also 
  43. discussed later in this document.
  44.  
  45.  
  46. If you didn't find an answer, SEARCH the forum for a topic related to your 
  47. problem, DO NOT open a new topic at once, most likely someone else had the 
  48. same problem before.
  49.  
  50. The official Forum is also at http://www.emule-project.net Please use only 
  51. English there, except for the language-specific sections. (PLEASE do not 
  52. report bugs that are already posted by someone else, and keep the "Bug 
  53. Reports", "Feature Requests" and "Development" sections clean and shiny)
  54.  
  55.  
  56. Would you like to donate to the eMule project? A PayPal link can be found on 
  57. the portal page (www.emule-project.net) Thanks ;)
  58.  
  59.  
  60.  
  61.  
  62. INSTALLATION:
  63. -------------
  64.  
  65. -Unzip eMule to a directory of your choice, or start the installer if you 
  66.  downloaded the .exe installer version.
  67.  
  68. -You can move your "Temp" and "Incoming" folders from eDonkey (or a previous 
  69.  version of eMule) to the new directory now, in order to continue your partial 
  70.  downloads. If you don't want to move your folders, you can set the "temp" and 
  71.  "incoming" path in the eMule preferences and restart it to get the same 
  72.  result.
  73.  
  74. -Updating from an earlier version of eMule: The best way to do this is simply 
  75.  to download the .zip file (not the installer), and unzip the new emule.exe to 
  76.  your old emule directory, overwriting the previous one.
  77.  
  78.  
  79.  
  80. CONFIGURATION:
  81. --------------
  82.  
  83. -Go to the "Preferences" tab
  84.  
  85. -Enter a nice nickname ;)
  86.  
  87. -Enter the "Download Capacity" and "Upload Capacity" according to your 
  88.  internet connection. All values in eMule are kiloBytes (KB), your Internet 
  89.  Service Provider's (ISP) numbers are most likely kiloBits (kB). 8 Bits make up 
  90.  1 Byte, so when your Internet Connection is 768kB Downstrean and 128kB 
  91.  Upstrean (like German Telekom DSL), your correct values are:
  92.  
  93.  Downstrean: 768kB / 8 = 96KB, you enter 96 as "Download Capacity"
  94.  Upstream: 128kB / 8 = 16 KB, you enter 16 as "Upload Capacity"
  95.  
  96.  The "capacity" values are used for the statistics display only. Nevertheless, 
  97.  you need to know them to determine the following down/upload limits:
  98.  
  99.  
  100. -Enter "Download Limit" and "Upload Limit"  (IMPORTANT!)
  101.  
  102.  Download Limit: leave this at 0 (should eMule become too fast and you are 
  103.  unable to surf the Internet or whatever, reduce it to 80-90% of "Download 
  104.  Capacity")
  105.  
  106.  Upload Limit: set this to ~80% of your "Upload Capacity" (so when your Upload 
  107.  Capacity is 16, set Upload Limit to 12 or 13)
  108.  
  109.  Setting Upload Limit to a value < 10 will automatically reduce your Download 
  110.  Limit, so upload as fast as you can.
  111.  
  112.  
  113. NOTE: 56k Modem users: eMule only accepts integral values for these settings 
  114. at the moment, you can't enter 2.6 or whatever your sweet-spot setting is, 
  115. yet. Sorry :) Maybe later..
  116.  
  117.  
  118. -"Maximum Connections": depends on your operating system. As a general rule...
  119.  
  120.   -Windows 98/ME (and 56k Modem/ISDN) users enter 50 here
  121.   -Windows 2000/XP users should set this according to their 
  122.    Internet Connection. 250 is a good value for 128k upstream connection, 
  123.    for example. DO NOT set this too high. It will kill your upload and with 
  124.    that, your download.
  125.  
  126. -"Maximum Sources per File": decide for yourself how many you want :) when you 
  127.  set this too high, your computer might slow down drastically or even crash. 
  128.  500-1000 are good values for people with DSL/cable connection.
  129.  
  130. -Choose the directories you want to share with other users. DO NOT SHARE YOUR 
  131.  COMPLETE HARDDISK! Put the stuff you want to share in a seperate Folder. If 
  132.  you share more than ~200 files, you should reconsider that...
  133.  
  134. -The other options are pretty self-explaining. If you dunno what it does, 
  135. don't touch it.
  136.  
  137.  
  138.  
  139. FAQ: (for more, see http://www.emule-project.net/faq/ )
  140. ----
  141.  
  142. --"Will I lose my credits when switching to a new version of eMule?"
  143.  
  144.  Not when move your old preferences.dat (your user ID) and clients.met (other 
  145.  people's credits) files to the directory you installed the new version in. 
  146.  The best way to update is just to replace your old emule.exe with the new one 
  147.  from the .zip download.
  148.  
  149.  
  150.  
  151. --"Why is eMule so slow? My brother/friend/whatever is downloading at 100K constantly"
  152.  
  153.  When you did setup eMule properly, it's all about the availibility of the 
  154.  files you are downloading, a bit of luck and a lot of patience ;)
  155.  
  156.  
  157.  
  158. --"Where can I get a new serverlist?"
  159.  
  160.  There are several lists availible. Some that I know of are:
  161.  -http://www.thedonkeynetwork.com
  162.  -http://ed2k.2x4u.de
  163.  Note that those sites are not related to the eMule project, we are not 
  164.  responsible for their content.
  165.  
  166.  
  167.  
  168. --"What is the adresses.dat file for?"
  169.  
  170.  You can enter a serverlist URL in that file. eMule will then get the 
  171.  serverlist from that URL at startup (when the option "Auto-update serverlist 
  172.  at startup" is activated)
  173.  
  174.  
  175.  
  176. --"What is the staticservers.dat file good for?"
  177.  
  178.  You can enter your favorite servers here to have them permanently in your 
  179.  serverlist with high priority. You can enter the static IP of the server, or 
  180.  an adress like goodserver.dyndns.net. You can also add static servers to this 
  181.  file via the server tab in eMule (right-click -> add to static serverlist)
  182.  
  183.  
  184. --"Why do I always have a low ID (means: firewalled) ??? What can I do against that?"
  185.  
  186.  Look here: http://www.emule-project.net/faq/ports.htm
  187.  
  188.  
  189.  
  190. --"How do I know whether my ID is high or low?"
  191.  
  192.  Look at the arrow in the bottom right corner, next to the server name you are 
  193.  connected to. When it's green, your ID is high. When it's orange, your ID is 
  194.  low.
  195.  
  196.  
  197.  
  198. --"What does high and low ID mean anyway?"
  199.  
  200.  When your ID is high (green arrow), everything is fine :) When it's low 
  201.  (orange arrow), you are behind a firewall or router, and other clients can't 
  202.  connect to you directly (which is a bad thing). Plz read the FAQ or search 
  203.  the forums on how to configure your firewall/router for eMule.
  204.  
  205.  NOTE: you can also get a low ID when the server you connected to is too busy 
  206.  to answer properly, or simply badly configured. When you are sure your 
  207.  settings are ok and you SHOULD have a high ID, connect to antoher server.
  208.  
  209.  
  210.  
  211. --"What is the difference between up/down CAPACITY and LIMIT?"
  212.  
  213.  The CAPACITY is used only by the statistcs tab to determine the vertical 
  214.  limits of the diagram. The LIMITS set the actual network traffic limits (see 
  215.  configuration notes).
  216.  
  217.  
  218.  
  219. --"I'd like to search for specific file types, what filter stands for which files?"
  220.  
  221.  File Type    Extensions found
  222.  --------------------------------------------------------------------------------
  223.  Audio        .mp3 .mp2 .mpc .wav .ogg .aac .mp4 .ape .au .wma .flac
  224.  Video        .avi .mpg .mpeg .ram .rm .vob .divx .mov .ogm .vivo
  225.  Program    .exe .com
  226.  Archive    .zip .rar .ace
  227.  CD-Image    .bin .cue .iso .nrg .ccd .sub .img .bwt .bwi .bwa .bws .mdf .mds
  228.  Picture    .jpg .jpeg .bmp .gif .tif .png
  229.  
  230.  
  231.  
  232. --"What are all those fancy colors in the download progress bar about?"
  233.  
  234.  Each download in the the Transfer tab has a coloured bar to show current file 
  235.  availability and progress.
  236.  
  237.  -Black shows the parts of the file you already have
  238.  -Red indicates a part missing in all known sources
  239.  -Different shades of blue represent the availability of this part in the
  240.   sources. The darker the blue is the higher the availability
  241.  -Yellow denotes a part being downloaded
  242.  -The green bar on top shows the total download progress of this file
  243.  
  244.  If you expand the download you see its sources with the corresponding bar. 
  245.  Here the colours have a slightly different meaning:
  246.  
  247.  -Black shows parts you are still missing
  248.  -Silver stands for parts this source is also missing
  249.  -Green indicates parts you already have
  250.  -Yellow denotes a part being uploaded to you
  251.  
  252.  Learning how the progress bar works will greatly help your understanding of 
  253.  the eDonkey2000 network.
  254.  
  255.  
  256.  
  257. --"What do the "QR: xxxx" numbers mean that I see when I look at my sources?"
  258.  
  259.  QR stands for "Queue Rank" and it is your current position in this source's 
  260.  queue.
  261.  
  262.  Obviously, a lower value is better :) If the source is an eMule client and 
  263.  there is no QR number, it's likely that it's queue is full and cannot accept 
  264.  more clients.
  265.  
  266.  
  267.  
  268.  
  269. COMPILING THE SOURCECODE:
  270. -------------------------
  271.  
  272. The sourcecode of eMule is availible as seperate download at:
  273.  http://sourceforge.net/projects/emule
  274. You need Microsoft(C) Visual C++ .NET 2002 to compile eMule.
  275.  
  276. -Unzip the sources (with subdirs) into a new folder
  277.  
  278. Since eMule v0.29b the separate download and compilation of additional 
  279. libraries is required. These libs are 3rd party and therefore - as usual - not 
  280. within our distribution. You need the following libs:
  281.  
  282. 1. Crypto++ v5.1
  283.     http://www.eskimo.com/~weidai/cryptlib.html
  284.  
  285. 2. zlib v1.2.1
  286.     http://www.gzip.org/zlib/
  287.  
  288. 3. id3lib v3.8.3
  289.     http://sourceforge.net/projects/id3lib/
  290.  
  291. 4. (for MobileMule only!)
  292.     DirectX SDK
  293.     pnglib: http://www.libpng.org/pub/png/libpng.html
  294.  
  295. 5. ResizableLib 1.3
  296.    http://sourceforge.net/projects/resizablelib/    
  297.  
  298. Download and save their sourcecode one level above the eMule source code 
  299. folder and compile them (check the eMule-project file to learn about the 
  300. required foldernames, or adapt them to your needs!).
  301.  
  302.  
  303. -Open the emule.sln Visual Studio Solution
  304.  
  305. -If you get an error message like "wrong version of Visual C++", you have to 
  306. open emule.sln and emule.vcroj with an editor and change some values:
  307.  
  308.  emule.sln: "...Format Version 8.00" to 7.00 if you use Microsoft(C) Visual C++ .NET 2002
  309.  emule.vcproj: Version="7.10"  to 7.00 if you use Microsoft(C) Visual C++ .NET 2002
  310.  
  311. -Select "release" or "debug" build in the solution configuration manager
  312. -Build the solution. That's it :)
  313. -If the compile was successful, the emule.exe is either in the \Debug or 
  314.  \Release directory
  315. -When you build a debug dump version, you need the latest dbghelp.dll from
  316.  Microsoft to run the app
  317.  
  318. -IMPORTANT:
  319.  
  320.  If you make modifications to eMule and you distribute the compiled version of 
  321.  your build, be sure to obey the GPL license. You have to include the 
  322.  sourcecode, or make it availible for download together with the binary 
  323.  version.
  324.  
  325.  
  326.  
  327.  
  328. MISC. STUFF:
  329. ------------
  330.  
  331. The eMule staff would like to thank the following (no particular order)
  332.  
  333. -Jed "swamp" McCaleb and MetaMachine for bringing the eDonkey network to life
  334. -DrSiRiUs for the awesome artwork (splashscreen and icons)
  335. -OCBmaurice & Stillman for the serverlists and more (www.thedonkeynetwork.com)
  336.  
  337. -many people who sent us code parts, useful bug reports and useful suggestions :)
  338.  
  339.  
  340.  
  341.  
  342. STAFF:
  343. ------
  344.  
  345. Who are the guys that sacrifice so much time to bring you this wonderful 
  346. program?
  347.  
  348. -John aka. Unknown1 - Developer
  349. -Ornis - Developer
  350. -bluecow - Developer
  351. -zz - Developer
  352. -Monk - Testers
  353.  
  354. -Merkur (merkur-@users.sourceforge.net) - Master of the Mule - retired, we miss you :)
  355. -Tecxx - Developer (retired)
  356. -Pach2 - Developer (retired)
  357. -Juanjo - Developer (retired)
  358. -Dirus - Developer (retired)
  359. -Barry - Developer (retired)
  360. -Mr. Ozon, Sony, Myxin - Tester (retired)
  361.  
  362.  
  363.  
  364. LEGAL:
  365. ------
  366.  
  367. eMule Copyright (C)2002-2004 Merkur (merkur-@users.sourceforge.net)
  368.  
  369. eDonkey2000 (C)Jed McCaleb, MetaMachine (www.eDonkey2000.com)
  370.  
  371. Windows(TM), Windows 95(TM), Windows 98(TM), Windows ME(TM), Windows NT(TM), 
  372. Windows 2000(TM) and Windows XP(TM) are Copyright (C)Microsoft Corporation. 
  373. All rights reserved.
  374.  
  375.  
  376. Goodbye and happy sharing ;)
  377.