Difference between revisions of "Usage Preferences"

From AMule Project FAQ
Jump to: navigation, search
m (Removed Version Tag)
 
(34 intermediate revisions by 11 users not shown)
Line 2: Line 2:
  
 
== Description ==
 
== Description ==
 
+
The Preferences window allows you to set aMule's settings.
The Preferences window allows to easily set aMule's settings.
+
  
 
http://www.amule.org/dev-up/window_prefs1.jpg
 
http://www.amule.org/dev-up/window_prefs1.jpg
  
 
== Usage ==
 
== Usage ==
 
+
The preferences options are divided into sections. Each section groups options with similar targets. You can view the available options by clicking the appropriate section in the list by the left side of the window.  
The preferences options are divided into sections. Each section groups options with similar targets.
+
 
+
You can view the available options by clicking th apropiate section in the list by the left side of the window.  
+
  
 
http://www.amule.org/dev-up/window_prefs32.jpg
 
http://www.amule.org/dev-up/window_prefs32.jpg
  
 
=== General ===
 
=== General ===
 
 
This section contains options regarding general aspects of aMule.
 
This section contains options regarding general aspects of aMule.
  
 
http://www.amule.org/dev-up/window_prefs2.jpg
 
http://www.amule.org/dev-up/window_prefs2.jpg
  
The descritpion for each item follows:
+
The description for each item follows:
*'''Nick''': [[Username]] to use
+
*'''Nick''': [[Username]] to use;
*'''Language''': Language in which text will be displayed(it requires to have the appropiate LC_ALL (or LC_MESSAGES) variable on UNIX systems). ''System default'' sets the system's language
+
*'''Language''': the language in which the text will be displayed (on UNIX systems, this requires the appropiate LC_ALL (or LC_MESSAGES) variable). ''System default'' sets the system's language
*'''Misc Options'''
+
*'''Misc Options''';
**'''Check for new versions at startup''': If checked, when aMule start it will check f new aMule releases are available and show a message if there are
+
**'''Check for new versions at startup''': if ticked, when aMule starts it will check whether new aMule releases are available; if this is the case, it will show a message to that effect;
**'''Start minimized''': Minimize aMule when it starts
+
**'''Start minimized''': this will minimize aMule when it starts;
**'''Prompt on exit''': When closing aMule ask for confirmation
+
**'''Prompt on exit''': when closing aMule, you'll then be asked for confirmation;
**'''Enable Tray Icon''': Show a [[Usage Tray icon|tray icon]] for aMule
+
**'''Enable Tray Icon''': you'll be shown a [[Usage Tray icon|tray icon]] for aMule;
**'''Minimize to trayicon''': When minimizing aMule, hide the window completely so it can only be unminimized from the systray icon (see the [[usage tray icon|usage article about tray icon]]). This option will only be available when '''Enable Tray Icon''' option is enabled
+
**'''Minimize to trayicon''': when minimizing aMule, this will hide the window completely so it can only be unminimized from the systray icon (see the [[usage Tray icon|usage article about tray icon]]). This option will only be available when '''Enable Tray Icon''' option is enabled;
**'''Tooltip Delay Time in secs''': Seconds it takes for the systray tooltip to appear (see the [[usage tray icon|usage article about tray icon]])
+
**'''Tooltip Delay Time in secs''': the number of seconds it takes for the systray tooltip to appear (see the [[usage Tray icon|usage article about tray icon]])
*'''Browser Selection'''
+
*'''Browser Selection''': Select the browser you want aMule to use when opening web sites
*'''Browser Selection''': Select the browser yuo want aMule to use when opening web sites
+
*'''Custom Browser''': When selecting ''Custom browser'' in the browser selection list, this box will be active so you can enter the browser command to use to start a browser. Use the '''Browse''' button to browse the filesystem for the browser
*'''Custom Browser''': When selecting ''Custom browser'' in the browser selection list, this box will be active so yuo can enter the browser command to use to start a browser. Use the '''Browse''' button to browse the filesystem for the browser
+
 
*'''Open in new tab if possible''': Some browsers allow for pages to be started in new tabs rather than overriding the web site it was viewing so, if possible, when this option is enabled, open web sites in a new tab
 
*'''Open in new tab if possible''': Some browsers allow for pages to be started in new tabs rather than overriding the web site it was viewing so, if possible, when this option is enabled, open web sites in a new tab
  
 
=== Connection ===
 
=== Connection ===
 
 
This section contains options regarding connections aMule.
 
This section contains options regarding connections aMule.
  
 
http://www.amule.org/dev-up/window_prefs3.jpg
 
http://www.amule.org/dev-up/window_prefs3.jpg
  
The descritpion for each item follows:
+
The description for each item follows:
  
 
*'''Bandwidth Limits'''
 
*'''Bandwidth Limits'''
Line 66: Line 59:
  
 
=== Proxy ===
 
=== Proxy ===
 
 
This section contains options regarding connection aMule through a proxy.
 
This section contains options regarding connection aMule through a proxy.
  
Line 74: Line 66:
  
 
*'''General'''
 
*'''General'''
**'''Enable Proxy''':  
+
**'''Enable Proxy''': Enable the use of a proxy
**'''Proxy type''':  
+
**'''Proxy type''': Select the type of proxy it is
**'''Proxy host''':  
+
**'''Proxy host''': The proxy's address
**'''Proxy port''':  
+
**'''Proxy port''': The port through which the proxy should be accessed
*'''Authentication''':
+
*'''Authentication'''
**'''Enable authentication''':  
+
**'''Enable authentication''': Enable this option to use a username and password to log into the proxy. If disabled, anonymous log in will be performed
**'''Username''':  
+
**'''Username''': Username to use to log into the proxy
**'''Password''':  
+
**'''Password''': Password to use to log into the proxy
*'''Automatic server connect without proxy''':  
+
*'''Automatic server connect without proxy''': <font color="red">This option is ignored currently</font>
  
 
=== Message Filter ===
 
=== Message Filter ===
 
 
This section contains options regarding messages filtering in aMule.
 
This section contains options regarding messages filtering in aMule.
  
 
http://www.amule.org/dev-up/window_prefs5.jpg
 
http://www.amule.org/dev-up/window_prefs5.jpg
  
The descritpion for each item follows:
+
The description for each item follows:
  
*'''Filter incoming messages''':  
+
*'''Filter incoming messages''': Filter incoming messages with the rules set underneath. Messages which are already open (in the [[Usage_Messages|Messages]] window) will not be closed
 
*'''Filtering Options'''
 
*'''Filtering Options'''
**'''Filter all messages''':  
+
**'''Filter all messages''': Ignore all incoming messages
**'''Filter messages from people not on your friend list''':  
+
**'''Filter messages from people not on your friend list''': Ingore all messages coming from users not in the friends list in Messages window)
**'''Filter messages from unknown clients''':  
+
**'''Filter messages from unknown clients''': Ignore messages coming from clients which aren't in any of your upload or download queues
**'''Filter messages containing''':  
+
**'''Filter messages containing''': Ignore all messages containing the strings listed in the box below. These words must be separated with a comma ('','') only (all other characters will be taken as part of the string to filter)
  
 
=== Remote Controls ===
 
=== Remote Controls ===
 
 
This section contains options regarding controling aMule remotely.
 
This section contains options regarding controling aMule remotely.
  
Line 108: Line 98:
  
 
*'''Webserver Parameters'''
 
*'''Webserver Parameters'''
**'''Webserver port''':  
+
**'''Webserver port''': Port where the swebserver will be listening for incoming connections
**'''page Refresh Time''':  
+
**'''page Refresh Time''': Time between refreshes in the web pages
**'''Enable Gzip compression''':  
+
**'''Enable Gzip compression''': Compress packets transfered from/to aMule from/to aMuleWeb
**'''Enable Low rights User''':  
+
**'''Enable Low rights User''': Enable the use of a low rights account to log into the webserver with view capabilities but no administration rights
**'''Full rights password''':  
+
**'''Full rights password''': Password for administration from the webserver
**'''Low rights password''':  
+
**'''Low rights password''': Password users with low rights can use to log into the websever
**'''Web template''':  
+
**'''Web template''': Template to use for the webserver (also known as webserver skins)
 
*'''External Connection Parameters'''
 
*'''External Connection Parameters'''
**'''Accept external connections''':  
+
**'''Accept external connections''': Allow aMule to accept [[External Connections]] requests from remote applications (such as aMuleWeb, aMuleGUI or aMuleCMD)
**'''IP of the listening interface''':  
+
**'''IP of the listening interface''': [[IP address|IP]] of the host running aMule. This field is optional
**'''TCP port''':  
+
**'''TCP port''': TCP port where aMule will listen for external connections
**'''Password''':  
+
**'''Password''': Password remote applications must supply to succesfully perform External Connections requests
  
 
=== Online Signature ===
 
=== Online Signature ===
 
+
This section contains options regarding aMule's [[Signature|Online Signature]].
This section contains options regarding aMule's [[Online Signature]].
+
  
 
http://www.amule.org/dev-up/window_prefs7.jpg
 
http://www.amule.org/dev-up/window_prefs7.jpg
Line 129: Line 118:
 
The descritpion for each item follows:
 
The descritpion for each item follows:
  
*'''Enable Online-Signature''':  
+
*'''Enable Online-Signature''': Enable aMule to write the [[Signature|Online Signature]]
*'''Update Frequency''':  
+
*'''Update Frequency''': Refresh interval aMule waits to update the Online Signature
*'''Online Signature Directory''':  
+
*'''Online Signature Directory''': Locations where the Online Signature must be written to
  
 
=== Server ===
 
=== Server ===
 
 
This section contains options regarding connecting aMule to [[server]]s.
 
This section contains options regarding connecting aMule to [[server]]s.
  
 
http://www.amule.org/dev-up/window_prefs8.jpg
 
http://www.amule.org/dev-up/window_prefs8.jpg
  
The descritpion for each item follows:
+
The description for each item follows:
  
*'''Remove dead server''':
+
*'''Remove dead server after ''n'' retries''': If enabled,  this is the number of times a server is allowed to either fail a connection attempt or fail to respond to a ping. After ''n''+1 attempts, it is removed from the serverlist.
*'''Remove dead server after X retries''':
+
*'''Auto-update serverlist at startup; List''': Adding a check-mark to this box causes aMule to download its serverlist from one or more of the URLs in the ''List'' text-entry box. The box is accessed by clicking on the '''List''' button (see next entry).
*'''Auto-update serverlist at startup''':  
+
*'''List''': Clicking will cause a text-entry box to appear. In it, one may enter one or more URLs which link to external serverlists. When the '''Auto-update serverlist at startup''' option is enabled, aMule will download the remote lists at startup.
*'''List''':  
+
*'''Update serverlist when connecting to a server''': After a connection to a server is established, make a request for its list of all known servers. If any of the server's entries do not appear in your list, they will be added.
*'''Update serverlist when connecting to a server'''
+
*'''Update serverlist when a client connects''': When connecting to a client, request the ID of the client's server. If it is not already on your list, it will be added.
*'''Update serverlist when a client connect'''
+
*'''Use priority system''': Priority system levels are set with a contextual menu which appears when a user right/ctrl-clicks on server list entries. The user assigns one of three levels of rank--Low, Normal or High--to one, some, or all of the servers in his serverlist. These priority rankings determine the order in which aMule will attempt to contact and connect to the servers in the list.
*'''Use priority system'''
+
*'''Use smart LowID check on connect''': <font color="brown">Preference not in use</font>
*'''Use smart LowID check on connect'''
+
*'''Safe connect''': When enabled, aMule will try to connect to one server at a time. Disabling the option results in two simultaneous connection attempts, although, of course, only one will connect successfully.
*'''Safe connect'''
+
*'''Autoconnect to servers in static list only''': aMule will attempt to connect only to those servers tagged as static. Adding or removing a server's name from the static list is done using the same contextual menu described in '''Use priority system''', above.
*'''Autoconnect to servers in static list only'''
+
*'''Set manually added servers to High Priority''': Refers to servers you have personally added to the serverlist, in contrast to the ones which come from external update sources. Note that the priority level can be changed later.
*'''Set manually added servers to High Priority'''
+
  
 
=== Files ===
 
=== Files ===
 
 
This section contains options regarding aMule's downloading [[file]]s.
 
This section contains options regarding aMule's downloading [[file]]s.
  
Line 162: Line 148:
  
 
*'''Intelligent Corruption Handling'''
 
*'''Intelligent Corruption Handling'''
**'''I.C.H. active'''
+
**'''I.C.H. active''': Enable [[ICH]]
**'''AICH trusts every hash'''
+
**'''AICH trusts every hash''': [[AICH]] is enabled by default. This option asks if aMule should blindly trust every hash it receives. Since other clients can contribute hashes, potentially bad hashes, it is recommended this option be left unchecked. When this is unchecked aMule applies various sanity checks to hashes it receives.
*'''Add fiels to download in pause mode'''
+
*'''Add files to download in pause mode''': When a new file is added to download, add it [[pause]]d
*'''Add files to download with auto priority'''
+
*'''Add files to download with auto priority''': Whe a new file is added to download, set its [[priority]] to ''Auto''
*'''Try to download first and last chunks first'''
+
*'''Try to download first and last chunks first''': When downloading a file, always try to download the beginning and the end of the file first. This is useful to quickly be able to preview the audio and video files
*'''Add new shared files with auto priority'''
+
*'''Add new shared files with auto priority''': When a file is added to any of the shared directories or whne a file is completly downloaded, set its share priority to ''Auto''
*'''Try to transfer full chunks to all uploads'''
+
*'''Try to transfer full chunks to all uploads''': When this option is enabled (recommended) once you begin uploading to a client no other client can gain its slot until it gets the whole chunk size. Ff disabled, the client with the highest score in the upload queue will always be given an upload score
*'''Start next paused file when a file completed'''
+
*'''Start next paused file when a file completed''': If enabled, when a file is completed, the highest priority paused file will be resumed
*'''From the same category'''
+
*'''From the same category''': When enabled, if '''Start next paused file when a file completed''' is enabled, it will resume the highest priority file in the same category (if there is any paused file in the same category, just any other paused file if there isn't)
*'''Save 5 sources on rare files'''
+
*'''Save 10 sources on rare files''': When closing aMule save 10 sources for those files which have few sources, so those sources can be reused on next startup (if it is quickly restarted)
 
*'''Disk space'''
 
*'''Disk space'''
**'''Check Disk Space''':  
+
**'''Check Disk Space''': If enabled, aMule will stop files when the free disk space in the filesystem would be lower than the value set in '''Min Disk Space'''
**'''Min Disk Space''':  
+
**'''Min Disk Space''': If '''Check Disk Space''' is enabled, this is, in MB, the minimum free disk space that should remain
 
*'''Execute command on file completion'''
 
*'''Execute command on file completion'''
**'''Enable command execution''':  
+
**'''Enable command execution''': If enabled, when a file is completed the command in '''Command''' will be executed
**'''Command''':  
+
**'''Command''': If '''Enable command execution''' is enabled, the command in this box will be executed when a file is completed. The following substitutions will be performed in the string provided:
  
=== Sources Dropping ===
+
{|+ Command execution keys
 +
| '''''Key''''' || '''Description'''
 +
|-
 +
| ''%FILE'' || File's path and filename
 +
|-
 +
| ''%NAME'' || File's filename (without path)
 +
|-
 +
| ''%SIZE'' || File's size
 +
|-
 +
| ''%HASH'' || File's hash
 +
|}
  
 +
=== Sources Dropping ===
 
This section contains options regarding aMule source dropping algorithm.
 
This section contains options regarding aMule source dropping algorithm.
  
Line 187: Line 184:
 
The descritpion for each item follows:
 
The descritpion for each item follows:
  
*'''Sources with no needed file-parts''':  
+
*'''Sources with no needed file-parts''': Decide what aMule should do with those sources which are in a file for which you already have the parts of the file those sources have
*'''Enable auto drop Full Queue Sources''':  
+
*'''Enable auto drop Full Queue Sources''': If a source's queue is full, ignore it
*'''High Queue Rating Sources Handling'''
+
*'''Enable auto drop High Queue Rating Sources''': Ingore sources who have given you a [[queue rank]] higher than the value in '''High Queue Rating value'''
**'''Enable auto drop High Queue Rating Sources''':  
+
*'''Auto Drop Sources Timer''': Time a source can be known before it is ignored
*'''High Queue Rating value''':
+
*'''Auto Drop Sources Timer''':  
+
 
+
=== Directores ===
+
  
 +
=== Directories ===
 
This section contains options regarding aMule's directories.
 
This section contains options regarding aMule's directories.
  
 
http://www.amule.org/dev-up/window_prefs11.jpg
 
http://www.amule.org/dev-up/window_prefs11.jpg
  
The descritpion for each item follows:
+
The description for each item follows:
  
*'''Incoming Directory''':  
+
*'''Incoming Directory''': Directory where the completed files will be stored. You can use the '''Browse button by its side to select the directory
*'''Temporary Directory''':  
+
*'''Temporary Directory''': Directory where incomplete files will be or are placed. You can use the '''Browse button by its side to select the directory
*'''Shared Directories''':  
+
*'''Shared Directories''': Select the directories who's files you want to share. To select a directory, double click over its icon. To select all its contents recursively right-click over its icon. The following codes are used to display the shared status of a directory:
*'''Share hidden files''':  
+
**''Normal font'': The directory is not marked as shared
*'''Video Player''':  
+
**''Bold font'': The directory is marked as shared
 +
**''Yellow folder icon'': The directory does not contain any subdirectory marked as shared (this doesn't mean this directory isn't marked as shared either)
 +
**''Red folder icon'': The directory contains subdirectories which are marked as shared
 +
*'''Share hidden files''': Share hidden files in the shared directories too
 +
*'''Video Player''': Command to execute when selecting to preview an audio or video file. The appropriate filename will be appended at the end of the command line
 +
*'''Create Backup to preview''': When previewing a file, do not preview directly the file aMule is using, but instead copy it to a temporary file and preview this other file
  
 
=== Statistics ===
 
=== Statistics ===
 
 
This section contains options regarding aMule's statistics.
 
This section contains options regarding aMule's statistics.
  
Line 217: Line 215:
  
 
*'''Graphs'''
 
*'''Graphs'''
**'''Update delay''':  
+
**'''Update delay''': Refresh interval for the statistics graphs
**'''Time for average graph''':  
+
**'''Time for average graph''': Time interval used to calculate the average values in the statistics graphs (the ''Running Average'')
**'''Connections Graph Scale''':  
+
**'''Connections Graph Scale''': Amount of connections the connections graph can repersent
**'''Select Statistcs Colors''':  
+
**'''Select Statistcs Colors''': Here yo can select the colours used in the statistics. Select the item from the menu and then select the colour from the '''Select''' button
 
*'''Statistics Tree'''
 
*'''Statistics Tree'''
**'''Update delay''':  
+
**'''Update delay''': Refresh interval for the statistics tree
**'''Number of Client Versions shown''':  
+
**'''Number of Client Versions shown''': Maximum amount of clients versions to be displayed for each client application listed in the tree
  
 
=== Security ===
 
=== Security ===
 
 
This section contains options regarding aMule's security.
 
This section contains options regarding aMule's security.
  
Line 234: Line 231:
  
 
*'''File Options'''
 
*'''File Options'''
**'''Who can see shared files''':  
+
**'''Who can see shared files''': Select who can see your shared files. It is recommended to hide them to everyone
 
**'''Default Permissions'''
 
**'''Default Permissions'''
***'''Files''':  
+
***'''Files''': Permissions newly created files will be given. Please note that this may collision with your ''umask'' system value see [[AMule_problems#Downloaded_files_don't_get_the_permissions_I_set_in_Preferences._Why?|this article]] for more information
***'''Directories''':  
+
***'''Directories''': Permissions newly created directories will be given. Please note that this may collision with your ''umask'' system value see [[AMule_problems#Downloaded_files_don't_get_the_permissions_I_set_in_Preferences._Why?|this article]] for more information
 
*'''IP-Filtering'''
 
*'''IP-Filtering'''
**'''Enable IP-Filtering''':  
+
**'''Enable IP-Filtering''': Enable filtering IPs known to be bad
**'''Reload List''':  
+
**'''Reload List''': Reload the list of filtered IPs and check that all connections are properly filtered
**'''Auto-update ipfilter at startup''':  
+
**'''Auto-update ipfilter at startup''': Make aMule download the url in the '''URL''' box at startup
**'''URL''':
+
**'''Update now''': Update the list of filtered IPS now from the url in the '''URL''' box
**'''Update now''':  
+
**'''Filtering Level''': Select the filtering level, See the [[IPFilter|IP Filter]] article
**'''Filtering Level''':  
+
**'''Always filter LAN IPs''': Always filter IPs claiming to be in your local LAN
**'''Always filter LAN IPs''':  
+
*'''Use Secure Identification''': Use the [[Secure User Identification]] protocol to identify against other clients (recommended)
*'''Use Secure Identification''':  
+
  
 
=== GUI Tweaks ===
 
=== GUI Tweaks ===
 
 
This section contains advanced options regarding aMule's GUI.
 
This section contains advanced options regarding aMule's GUI.
  
Line 257: Line 252:
  
 
*'''Download Queue Files Progress'''
 
*'''Download Queue Files Progress'''
**'''Show percentage''':  
+
**'''Show percentage''': Show the completed percentage value for every file in the downloads queue (over the progress bar if the progress bar is also visible)
**'''Show progressbar''':  
+
**'''Show progressbar''': Show a progress bar displayed the availability of the chuns for every file in the downloads queue
**'''Progressbar Style''':  
+
**'''Progressbar Style''': Select the styl of the progress bar when '''Show progressbar''' is enabled
 
*'''Skin Support'''
 
*'''Skin Support'''
**'''Use skin file to set aMule bitmaps''':  
+
**'''Use skin file to set aMule bitmaps''': <font color="red">Not yet supported</font>
**'''Skin file''':  
+
**'''Skin file''': <font color="red">Not yet supported</font>
*'''Auto-sort files in the download queue''':  
+
*'''Auto-sort files in the download queue''': When enabled, the downlods list will be resorted more frequently (not recommended, consumes many CPU cycles)
 
*'''Misc GUI Tweaks'''
 
*'''Misc GUI Tweaks'''
**'''Show Fast ED2K Links Handler''':  
+
**'''Show Fast ED2K Links Handler''': Show the [[Usage_ED2K Link Handler|ED2K Link Handler]] in all the windows, not only in the [[Usage_Searches|Searches]] window
**'''Show extended info on categories tabs''':  
+
**'''Show extended info on categories tabs''': When enabled, the tabs titles for categories in the [[Usage_Transfer|Transfer]] window will also display the amount of downloading files in the category and the total amount of files in the category
**'''Show transfer rates on title''':  
+
**'''Show transfer rates on title''': Show transfer speeds in the title text
**'''Vertical toolbar orientation''':  
+
**'''Vertical toolbar orientation''': Show the toolbar horizontally (disabled) or vertically (enabled)
  
 
=== Core Tweaks ===
 
=== Core Tweaks ===
 
 
This section contains advanced options regarding aMule's core system.
 
This section contains advanced options regarding aMule's core system.
  
Line 278: Line 272:
 
The descritpion for each item follows:
 
The descritpion for each item follows:
  
*'''Max new connections / 5 secs''':  
+
*'''Max new connections / 5 secs''': Maximum amount of new connections to establish per every 5 seconds
*'''File Buffer Size''':  
+
*'''File Buffer Size''': Maximum amount of memory each file can take
*'''Upload Queue Size''':  
+
*'''Upload Queue Size''': Maximum amount of clients to be queued in the uload queue
*'''Server connection refresh interval''':  
+
*'''Server connection refresh interval''': Ping intervals to the server (to avoid being disconnected because of lack of transmission)
  
 
=== Debugging ===
 
=== Debugging ===
 
 
This section contains advanced options for debugging aMule.
 
This section contains advanced options for debugging aMule.
  
Line 295: Line 288:
 
This whole debugging preferences window '''should not be touched''' unless you know what you are doing. Therefore, its options will not be described.
 
This whole debugging preferences window '''should not be touched''' unless you know what you are doing. Therefore, its options will not be described.
  
== Overview ==
+
=== Events ===
 +
Here you can configure aMule's behaviour like eMail-notification when several [[events]] (like completed downloads or new chatsessions) occur as described [[events|here]].
  
http://www.amule.org/dev-up/window_prefs17.jpg
+
http://www.amule.org/wiki/images/a/a9/Events1.png
  
{|
 
|+ General preferences quick Reference
 
| '''Number''' || '''''Description'''''
 
|-
 
| 1 || ''''
 
|}
 
  
http://www.amule.org/dev-up/window_prefs18.jpg
 
 
{|
 
|+ Connection preferences quick Reference
 
| '''Number''' || '''''Description'''''
 
|-
 
| 1 || ''''
 
|}
 
 
http://www.amule.org/dev-up/window_prefs19.jpg
 
 
{|
 
|+ Proxy preferences quick Reference
 
| '''Number''' || '''''Description'''''
 
|-
 
| 1 || ''''
 
|}
 
 
http://www.amule.org/dev-up/window_prefs20.jpg
 
 
{|
 
|+ Message Filter preferences quick Reference
 
| '''Number''' || '''''Description'''''
 
|-
 
| 1 || ''''
 
|}
 
 
http://www.amule.org/dev-up/window_prefs21.jpg
 
 
{|
 
|+ Remot Controls preferences quick Reference
 
| '''Number''' || '''''Description'''''
 
|-
 
| 1 || ''''
 
|}
 
 
http://www.amule.org/dev-up/window_prefs22.jpg
 
 
{|
 
|+ Online Signature preferences quick Reference
 
| '''Number''' || '''''Description'''''
 
|-
 
| 1 || ''''
 
|}
 
 
http://www.amule.org/dev-up/window_prefs23.jpg
 
 
{|
 
|+ Server preferences quick Reference
 
| '''Number''' || '''''Description'''''
 
|-
 
| 1 || ''''
 
|}
 
 
http://www.amule.org/dev-up/window_prefs24.jpg
 
 
{|
 
|+ Files preferences quick Reference
 
| '''Number''' || '''''Description'''''
 
|-
 
| 1 || ''''
 
|}
 
 
http://www.amule.org/dev-up/window_prefs25.jpg
 
 
{|
 
|+ Sources Dropping preferences quick Reference
 
| '''Number''' || '''''Description'''''
 
|-
 
| 1 || ''''
 
|}
 
 
http://www.amule.org/dev-up/window_prefs26.jpg
 
 
{|
 
|+ Directories preferences quick Reference
 
| '''Number''' || '''''Description'''''
 
|-
 
| 1 || ''''
 
|}
 
 
http://www.amule.org/dev-up/window_prefs27.jpg
 
 
{|
 
|+ Statistics preferences quick Reference
 
| '''Number''' || '''''Description'''''
 
|-
 
| 1 || ''''
 
|}
 
 
http://www.amule.org/dev-up/window_prefs28.jpg
 
 
{|
 
|+ Security preferences quick Reference
 
| '''Number''' || '''''Description'''''
 
|-
 
| 1 || ''''
 
|}
 
 
http://www.amule.org/dev-up/window_prefs29.jpg
 
 
{|
 
|+ GUI Tweaks preferences quick Reference
 
| '''Number''' || '''''Description'''''
 
|-
 
| 1 || ''''
 
|}
 
 
http://www.amule.org/dev-up/window_prefs30.jpg
 
 
{|
 
|+ Core Tweaks preferences quick Reference
 
| '''Number''' || '''''Description'''''
 
|-
 
| 1 || ''''
 
|}
 
 
http://www.amule.org/dev-up/window_prefs31.jpg
 
 
{|
 
|+ General preferences quick Reference
 
| '''Number''' || '''''Description'''''
 
|-
 
| 1 || ''''
 
|}
 
  
<center>[[Usage aMule|Back to Index]]</center>
+
http://www.amule.org/wiki/images/3/3d/Events2.png

Latest revision as of 10:26, 29 June 2008

Back to Index

Description

The Preferences window allows you to set aMule's settings.

http://www.amule.org/dev-up/window_prefs1.jpg

Usage

The preferences options are divided into sections. Each section groups options with similar targets. You can view the available options by clicking the appropriate section in the list by the left side of the window.

http://www.amule.org/dev-up/window_prefs32.jpg

General

This section contains options regarding general aspects of aMule.

http://www.amule.org/dev-up/window_prefs2.jpg

The description for each item follows:

  • Nick: Username to use;
  • Language: the language in which the text will be displayed (on UNIX systems, this requires the appropiate LC_ALL (or LC_MESSAGES) variable). System default sets the system's language
  • Misc Options;
    • Check for new versions at startup: if ticked, when aMule starts it will check whether new aMule releases are available; if this is the case, it will show a message to that effect;
    • Start minimized: this will minimize aMule when it starts;
    • Prompt on exit: when closing aMule, you'll then be asked for confirmation;
    • Enable Tray Icon: you'll be shown a tray icon for aMule;
    • Minimize to trayicon: when minimizing aMule, this will hide the window completely so it can only be unminimized from the systray icon (see the usage article about tray icon). This option will only be available when Enable Tray Icon option is enabled;
    • Tooltip Delay Time in secs: the number of seconds it takes for the systray tooltip to appear (see the usage article about tray icon)
  • Browser Selection: Select the browser you want aMule to use when opening web sites
  • Custom Browser: When selecting Custom browser in the browser selection list, this box will be active so you can enter the browser command to use to start a browser. Use the Browse button to browse the filesystem for the browser
  • Open in new tab if possible: Some browsers allow for pages to be started in new tabs rather than overriding the web site it was viewing so, if possible, when this option is enabled, open web sites in a new tab

Connection

This section contains options regarding connections aMule.

http://www.amule.org/dev-up/window_prefs3.jpg

The description for each item follows:

  • Bandwidth Limits
    • Download: Maximum download speed to allow
    • Upload: Maximum upload speed to allow
    • Slot Allocation: Define speed for every allocated slot
  • Line Capacities
    • Download: Download speed your line is capable of performing. This is only used for Statistics and the speed bar in the SysTray icon
    • Upload: Upload speed your line is capable of performing. This is only used for Statistics and the speed bar in the SysTray icon
  • Standard client TCP Port: Standard client TCP port aMule will use
  • Extended client UDP Port
    • Extended client UDP Port: Extended client UDP port aMule will use
    • disable: Disable the Extended client UDP port. This will decrease aMule's performance and usage in some apsects, but will free a port
  • UDP port for extended server requests: This field cannot be modified. It is there only so that the user remembers about the extended server requests UDP port's existence and easily knows which numbre it is assigned
  • Max Sources per File: Maximum amount of sources that will be remembered for every file
  • Connection Limits: Maximum amount of simoultanous connections
  • Networks
    • ED2K: Enable the ED2K network. If disabled, it will only be possible to connect by explicitly doing so from the Networks window
    • Kademlia: Enable the Kademlia network. If disabled, it will only be possible to connect by explicitly doing so from the Networks window
  • Autoconnect on startup: Connect aMule to the enabled netwrks when it starts
  • Reconnect on loss: Atempt to connect to a server when disconnected. If it was disconnected because of an error, it will attempt to connect to the same server it was connected to. Otherwise, if it was explicitly disconnected by the server, it will attempt to connect to just any other server
  • Show overhead bandwidth: Show in the Status bar the bandwidth that control packets take

Proxy

This section contains options regarding connection aMule through a proxy.

http://www.amule.org/dev-up/window_prefs4.jpg

The descritpion for each item follows:

  • General
    • Enable Proxy: Enable the use of a proxy
    • Proxy type: Select the type of proxy it is
    • Proxy host: The proxy's address
    • Proxy port: The port through which the proxy should be accessed
  • Authentication
    • Enable authentication: Enable this option to use a username and password to log into the proxy. If disabled, anonymous log in will be performed
    • Username: Username to use to log into the proxy
    • Password: Password to use to log into the proxy
  • Automatic server connect without proxy: This option is ignored currently

Message Filter

This section contains options regarding messages filtering in aMule.

http://www.amule.org/dev-up/window_prefs5.jpg

The description for each item follows:

  • Filter incoming messages: Filter incoming messages with the rules set underneath. Messages which are already open (in the Messages window) will not be closed
  • Filtering Options
    • Filter all messages: Ignore all incoming messages
    • Filter messages from people not on your friend list: Ingore all messages coming from users not in the friends list in Messages window)
    • Filter messages from unknown clients: Ignore messages coming from clients which aren't in any of your upload or download queues
    • Filter messages containing: Ignore all messages containing the strings listed in the box below. These words must be separated with a comma (,) only (all other characters will be taken as part of the string to filter)

Remote Controls

This section contains options regarding controling aMule remotely.

http://www.amule.org/dev-up/window_prefs6.jpg

The descritpion for each item follows:

  • Webserver Parameters
    • Webserver port: Port where the swebserver will be listening for incoming connections
    • page Refresh Time: Time between refreshes in the web pages
    • Enable Gzip compression: Compress packets transfered from/to aMule from/to aMuleWeb
    • Enable Low rights User: Enable the use of a low rights account to log into the webserver with view capabilities but no administration rights
    • Full rights password: Password for administration from the webserver
    • Low rights password: Password users with low rights can use to log into the websever
    • Web template: Template to use for the webserver (also known as webserver skins)
  • External Connection Parameters
    • Accept external connections: Allow aMule to accept External Connections requests from remote applications (such as aMuleWeb, aMuleGUI or aMuleCMD)
    • IP of the listening interface: IP of the host running aMule. This field is optional
    • TCP port: TCP port where aMule will listen for external connections
    • Password: Password remote applications must supply to succesfully perform External Connections requests

Online Signature

This section contains options regarding aMule's Online Signature.

http://www.amule.org/dev-up/window_prefs7.jpg

The descritpion for each item follows:

  • Enable Online-Signature: Enable aMule to write the Online Signature
  • Update Frequency: Refresh interval aMule waits to update the Online Signature
  • Online Signature Directory: Locations where the Online Signature must be written to

Server

This section contains options regarding connecting aMule to servers.

http://www.amule.org/dev-up/window_prefs8.jpg

The description for each item follows:

  • Remove dead server after n retries: If enabled, this is the number of times a server is allowed to either fail a connection attempt or fail to respond to a ping. After n+1 attempts, it is removed from the serverlist.
  • Auto-update serverlist at startup; List: Adding a check-mark to this box causes aMule to download its serverlist from one or more of the URLs in the List text-entry box. The box is accessed by clicking on the List button (see next entry).
  • List: Clicking will cause a text-entry box to appear. In it, one may enter one or more URLs which link to external serverlists. When the Auto-update serverlist at startup option is enabled, aMule will download the remote lists at startup.
  • Update serverlist when connecting to a server: After a connection to a server is established, make a request for its list of all known servers. If any of the server's entries do not appear in your list, they will be added.
  • Update serverlist when a client connects: When connecting to a client, request the ID of the client's server. If it is not already on your list, it will be added.
  • Use priority system: Priority system levels are set with a contextual menu which appears when a user right/ctrl-clicks on server list entries. The user assigns one of three levels of rank--Low, Normal or High--to one, some, or all of the servers in his serverlist. These priority rankings determine the order in which aMule will attempt to contact and connect to the servers in the list.
  • Use smart LowID check on connect: Preference not in use
  • Safe connect: When enabled, aMule will try to connect to one server at a time. Disabling the option results in two simultaneous connection attempts, although, of course, only one will connect successfully.
  • Autoconnect to servers in static list only: aMule will attempt to connect only to those servers tagged as static. Adding or removing a server's name from the static list is done using the same contextual menu described in Use priority system, above.
  • Set manually added servers to High Priority: Refers to servers you have personally added to the serverlist, in contrast to the ones which come from external update sources. Note that the priority level can be changed later.

Files

This section contains options regarding aMule's downloading files.

http://www.amule.org/dev-up/window_prefs9.jpg

The descritpion for each item follows:

  • Intelligent Corruption Handling
    • I.C.H. active: Enable ICH
    • AICH trusts every hash: AICH is enabled by default. This option asks if aMule should blindly trust every hash it receives. Since other clients can contribute hashes, potentially bad hashes, it is recommended this option be left unchecked. When this is unchecked aMule applies various sanity checks to hashes it receives.
  • Add files to download in pause mode: When a new file is added to download, add it paused
  • Add files to download with auto priority: Whe a new file is added to download, set its priority to Auto
  • Try to download first and last chunks first: When downloading a file, always try to download the beginning and the end of the file first. This is useful to quickly be able to preview the audio and video files
  • Add new shared files with auto priority: When a file is added to any of the shared directories or whne a file is completly downloaded, set its share priority to Auto
  • Try to transfer full chunks to all uploads: When this option is enabled (recommended) once you begin uploading to a client no other client can gain its slot until it gets the whole chunk size. Ff disabled, the client with the highest score in the upload queue will always be given an upload score
  • Start next paused file when a file completed: If enabled, when a file is completed, the highest priority paused file will be resumed
  • From the same category: When enabled, if Start next paused file when a file completed is enabled, it will resume the highest priority file in the same category (if there is any paused file in the same category, just any other paused file if there isn't)
  • Save 10 sources on rare files: When closing aMule save 10 sources for those files which have few sources, so those sources can be reused on next startup (if it is quickly restarted)
  • Disk space
    • Check Disk Space: If enabled, aMule will stop files when the free disk space in the filesystem would be lower than the value set in Min Disk Space
    • Min Disk Space: If Check Disk Space is enabled, this is, in MB, the minimum free disk space that should remain
  • Execute command on file completion
    • Enable command execution: If enabled, when a file is completed the command in Command will be executed
    • Command: If Enable command execution is enabled, the command in this box will be executed when a file is completed. The following substitutions will be performed in the string provided:
Key Description
%FILE File's path and filename
%NAME File's filename (without path)
%SIZE File's size
%HASH File's hash

Sources Dropping

This section contains options regarding aMule source dropping algorithm.

http://www.amule.org/dev-up/window_prefs10.jpg

The descritpion for each item follows:

  • Sources with no needed file-parts: Decide what aMule should do with those sources which are in a file for which you already have the parts of the file those sources have
  • Enable auto drop Full Queue Sources: If a source's queue is full, ignore it
  • Enable auto drop High Queue Rating Sources: Ingore sources who have given you a queue rank higher than the value in High Queue Rating value
  • Auto Drop Sources Timer: Time a source can be known before it is ignored

Directories

This section contains options regarding aMule's directories.

http://www.amule.org/dev-up/window_prefs11.jpg

The description for each item follows:

  • Incoming Directory: Directory where the completed files will be stored. You can use the Browse button by its side to select the directory
  • Temporary Directory: Directory where incomplete files will be or are placed. You can use the Browse button by its side to select the directory
  • Shared Directories: Select the directories who's files you want to share. To select a directory, double click over its icon. To select all its contents recursively right-click over its icon. The following codes are used to display the shared status of a directory:
    • Normal font: The directory is not marked as shared
    • Bold font: The directory is marked as shared
    • Yellow folder icon: The directory does not contain any subdirectory marked as shared (this doesn't mean this directory isn't marked as shared either)
    • Red folder icon: The directory contains subdirectories which are marked as shared
  • Share hidden files: Share hidden files in the shared directories too
  • Video Player: Command to execute when selecting to preview an audio or video file. The appropriate filename will be appended at the end of the command line
  • Create Backup to preview: When previewing a file, do not preview directly the file aMule is using, but instead copy it to a temporary file and preview this other file

Statistics

This section contains options regarding aMule's statistics.

http://www.amule.org/dev-up/window_prefs12.jpg

The descritpion for each item follows:

  • Graphs
    • Update delay: Refresh interval for the statistics graphs
    • Time for average graph: Time interval used to calculate the average values in the statistics graphs (the Running Average)
    • Connections Graph Scale: Amount of connections the connections graph can repersent
    • Select Statistcs Colors: Here yo can select the colours used in the statistics. Select the item from the menu and then select the colour from the Select button
  • Statistics Tree
    • Update delay: Refresh interval for the statistics tree
    • Number of Client Versions shown: Maximum amount of clients versions to be displayed for each client application listed in the tree

Security

This section contains options regarding aMule's security.

http://www.amule.org/dev-up/window_prefs13.jpg

The descritpion for each item follows:

  • File Options
    • Who can see shared files: Select who can see your shared files. It is recommended to hide them to everyone
    • Default Permissions
      • Files: Permissions newly created files will be given. Please note that this may collision with your umask system value see this article for more information
      • Directories: Permissions newly created directories will be given. Please note that this may collision with your umask system value see this article for more information
  • IP-Filtering
    • Enable IP-Filtering: Enable filtering IPs known to be bad
    • Reload List: Reload the list of filtered IPs and check that all connections are properly filtered
    • Auto-update ipfilter at startup: Make aMule download the url in the URL box at startup
    • Update now: Update the list of filtered IPS now from the url in the URL box
    • Filtering Level: Select the filtering level, See the IP Filter article
    • Always filter LAN IPs: Always filter IPs claiming to be in your local LAN
  • Use Secure Identification: Use the Secure User Identification protocol to identify against other clients (recommended)

GUI Tweaks

This section contains advanced options regarding aMule's GUI.

http://www.amule.org/dev-up/window_prefs14.jpg

The descritpion for each item follows:

  • Download Queue Files Progress
    • Show percentage: Show the completed percentage value for every file in the downloads queue (over the progress bar if the progress bar is also visible)
    • Show progressbar: Show a progress bar displayed the availability of the chuns for every file in the downloads queue
    • Progressbar Style: Select the styl of the progress bar when Show progressbar is enabled
  • Skin Support
    • Use skin file to set aMule bitmaps: Not yet supported
    • Skin file: Not yet supported
  • Auto-sort files in the download queue: When enabled, the downlods list will be resorted more frequently (not recommended, consumes many CPU cycles)
  • Misc GUI Tweaks
    • Show Fast ED2K Links Handler: Show the ED2K Link Handler in all the windows, not only in the Searches window
    • Show extended info on categories tabs: When enabled, the tabs titles for categories in the Transfer window will also display the amount of downloading files in the category and the total amount of files in the category
    • Show transfer rates on title: Show transfer speeds in the title text
    • Vertical toolbar orientation: Show the toolbar horizontally (disabled) or vertically (enabled)

Core Tweaks

This section contains advanced options regarding aMule's core system.

http://www.amule.org/dev-up/window_prefs15.jpg

The descritpion for each item follows:

  • Max new connections / 5 secs: Maximum amount of new connections to establish per every 5 seconds
  • File Buffer Size: Maximum amount of memory each file can take
  • Upload Queue Size: Maximum amount of clients to be queued in the uload queue
  • Server connection refresh interval: Ping intervals to the server (to avoid being disconnected because of lack of transmission)

Debugging

This section contains advanced options for debugging aMule.

http://www.amule.org/dev-up/window_prefs16.jpg

You may enable extra debugging output to your aMule log by enabling the Enable Verbose Debug-Logging. checkbox.

Once enabled, you may define what exact debug messages you want to get in the log by enabling/disabling the options in the Message Categories list.

This whole debugging preferences window should not be touched unless you know what you are doing. Therefore, its options will not be described.

Events

Here you can configure aMule's behaviour like eMail-notification when several events (like completed downloads or new chatsessions) occur as described here.

http://www.amule.org/wiki/images/a/a9/Events1.png


http://www.amule.org/wiki/images/3/3d/Events2.png