Difference between revisions of "Usage Preferences"

Revision as of 10:47, 14 December 2005

Back to Index

Description

The Preferences window allows to easily 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 th apropiate 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 descritpion for each item follows:

• 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
• 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
  • Start minimized: Minimize aMule when it starts
  • Prompt on exit: When closing aMule ask for confirmation
  • Enable Tray Icon: Show a 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 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 article about tray icon)
• Browser Selection
• 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 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

Connection

This section contains options regarding connections aMule.

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

The descritpion 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 descritpion 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 no 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. This words must be separated with a coma (,) only (all other characters will be takes 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 descritpion for each item follows:

• Remove dead server: Enable this option to remove servers which aren't acessible (unable to connect or ping them)
• Remove dead server after X retries: If the above option is enabled, this specifies how many times a server has to fail to connect (or ping) before it is removed from the srevers list
• Auto-update serverlist at startup: Enable this option to have aMule download the serverlist set in the serverlists list window (see the List button)
• List: By clicking this a window will popup where you can enter the URLs to servers lists you want aMule to download an use at startup when the Auto-update serverlist at startup option is enabled
• Update serverlist when connecting to a server: When connecting to a server, sak this server for other servers it knows about and add them to the servers list
• Update serverlist when a client connect: When connecting to a client, ask this client what server it is connected to and add this server to the servers list
• Use priority system: When connecting to any server, use the priority system to decide which servers to attempt to connect first and which to attempt to conenct the last
• Use smart LowID check on connect: This option is ignored currently
• Safe connect: If ennabled, when aMule is asked to connect to any server, it will only try connecting to on server at a time. If disabled, it will try two at a time simoultaneosuly (although only one will be eventually connected)
• Autoconnect to servers in static list only: When setting aMule to connecto to any server, only attempt to connect to connect to those tagged as static
• Set manually added servers to High Priority: When a server is manually added thorugh the Networks window, set its priority to High

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: Enable AICH
• Add fiels 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 priotiy 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:

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

Directores

This section contains options regarding aMule's directories.

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

The descritpion 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 imcomplete 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
• Share hidden files: Share hidden files in the shared directories too
• Video Player: Command to execute when selectign to preview an audio or video file. The appropiate 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 suing, 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:
  • Default Permissions
    • Files:
    • Directories:
• IP-Filtering
  • Enable IP-Filtering:
  • Reload List:
  • Auto-update ipfilter at startup:
  • URL:
  • Update now:
  • Filtering Level:
  • Always filter LAN IPs:
• Use Secure Identification:

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 progressbar:
  • Progressbar Style:
• Skin Support
  • Use skin file to set aMule bitmaps:
  • Skin file:
• Auto-sort files in the download queue:
• Misc GUI Tweaks
  • Show Fast ED2K Links Handler:
  • Show extended info on categories tabs:
  • Show transfer rates on title:
  • Vertical toolbar orientation:

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:
• File Buffer Size:
• Upload Queue Size:
• Server connection refresh interval:

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.

Overview

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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