# Configure &ktorrent;

&ktorrent;'s configuration dialog can be found in the menu under Settings Configure &ktorrent;....

## Downloads

Downloads configuration dialog
Downloads configuration dialog

Queue Manager
  Maximum seeds:

    Here you can set the number of torrents Queue Manager will seed simultaneously. When a download of a queued torrent is finished and started seeding, last in the queue of the seeding torrents will be stopped.

  When disk space is running low:

    Here you can select should queued torrent be started when you are running out of disk space. You can choose one of the following options.

    - Don't start torrents
    - Ask if torrents can be started
    - Start torrents
  Stop torrents when free disk space is lower then:

    Select this option to stop all torrents when there is low disk space limit is reached.

  Decrease priority of torrents which are stalled for too long

    If the queued torrent has been stalled for a specified amount of time, its priority will decrease.

  Stalled timer:

    Here you can set the amount of time to wait before decreasing torrents priority.

Seeding
  Keep seeding after download is finished

    If this option is selected, when download of the torrent is finished &ktorrent; will continue to seed data. You should not disable this, since BitTorrent is a sharing protocol, unless you have an upload limit on your Internet connection.

  Number of upload slots

    This setting determines the number of peers you will connect to upload them data.

  Maximum share ratio

    This setting allows you to specify limit on how much data will you share. Ration of 1.00 means 100&percnt; will be shared, 1.25 means 125&percnt; &etc; This setting do not apply while downloading, only while seeding. When the ratio is reached, seeding of the torrent will stop.

  Maximum seed time

    This setting allows you to specify limit on how long will you share. Time is set in hours, that means 1.00 is 1 hour, 1.25 is 1 hour 15 minutes &etc; This setting apply only in seeding mode, and when the time is reached, seeding of the torrent will stop.

Preferences
  Port:

    Port configured here, is the port &ktorrent; will use to connect to other peers in the swarm. Normally, you do not need to change this setting, but some Internet Service Providers restrict traffic on known P2P ports (see Encryption). Use one in range 49152 to 65535 (unregistered, dynamic and/or private ports).

    If you are behind a router, you need to forward this port to accept incoming connections. UPnP plugin can do this for you.

  UDP tracker port:

    Port to use for connections with UDP trackers. These trackers are rarely used because they are supported in only few BitTorrent clients.

  Maximum connections per torrent:

    Here you can set maximum number of peers to connect to per single torrent. Setting 45 to 65 maximum connections per torrent is generally enough, though people with more bandwidth can configure this higher, together with a higher number of upload slots and a higher upload speed.

    Setting this high will not automatically improve your speeds. Speed is more dependent on the health of the torrent swarm and your own upload behavior.

  Global connection limit:

    Use this setting to limit the total number of peers (all torrents combined) that &ktorrent; will connect to. Keep in mind that this setting should ideally be high enough for the amount of torrents you want to run, while avoiding low responsiveness of your Internet connection or even worse — capping your own bandwidth.

  Maximum download speed:

    Here you can set a limit on download speed. For best BitTorrent performance, set this to 95&percnt; of your total bandwidth download speed, or lower if you want to share your bandwidth with other application.

  Maximum upload speed:

    Here you can set a limit on upload speed. Set this to 85–90&percnt; of your bandwidth upload speed. Setting this too high might compromise your download speed. If in doubt use recommended setting.

Advanced
  DSCP value for IP pockets:

    With this setting you can prioritize your &ktorrent; Internet traffic. This is useful when you want your other applications (&ie; web browser) to have priority over &ktorrent; or vise verse. Use one of the following numbers to describe priority.

    0 | Default
    1 | Low
    2 | Medium
    3 | High
    4 | Critical
    5 | Real-Time
    6 | Premium
    7 | Urgent
    any other number | Can be used with routers and IP tables to map traffic in network environment

  Maximum number of connection setups:

    This option allows you to set the number of outgoing connections that will be attempted simultaneously. If you are having a problem with &ktorrent; blocking your other Internet traffic, try setting this number a bit lower.

  Network Interface

    Here you can set which interface to use for Internet traffic. If you have more then one connection to Internet (&ie; Wireless, Satellite and/or Cable), you can use a specific one or all of them.

    This option requires a restart to take effect.

Recommended Options

  The Recommended Options button will open a window where you can calculate best Downloads and Queue Manager settings, based on your bandwidth. Use Apply button to automatically set the recommended options or Cancel to close the window without changing any settings.

  Available upload bandwidth:

    Here you should enter your Internet upload speed.

  Available download bandwidth:

    Here you should enter your Internet download speed.

  Average speed per slot:

    ...

  Number of torrents you usually download simultaneously:

    If you want recommended options to be calculated based on the number of torrents that you usually download, enter that number here.

  Slots per torrent:

    ...

## General

General configuration dialog
General configuration dialog

Folders
  Folder to store torrent information:

    This folder is used to store information for all currently opened torrents. If you run two operating system, you can share this folder between two &ktorrent;'s, to allow continues download when in either of them.

  Default save location:

    If enabled and set, this location will be default location for saving torrents data in all dialogs. Data of silently opened torrents will be saved to this location.

  Move completed downloads to:

    When completed downloading, torrents data can be moved to different folder. Use this setting to separate your finished from unfinished downloads.

  Copy torrent files to:

    When opened, torrent files can be saved in specified folder for backup, record or other purposes.

System Tray Icon
  Show system tray icon

    This option, when selected, shows a &ktorrent; icon in system tray. It also changes the behavior of Close button from exiting the program to hiding it. If you do not want this kind of behavior, disable this option.

  Show system tray popup messages

    Select this setting, if you want to see a small popup containing current speed and transferred data information, when your mouse is over the &ktorrent; icon in system tray.

    System tray popup message
    System tray popup message

    This setting also determines whether you will be notified of torrent events (&ie; download completed, share ratio reached, torrent stopped by an error &etc;).

Miscellaneous
  Use a list of files when displaying files of a torrent

    When selected, this setting will show all files in a flat list, while hiding all the folders. This affects all dialogs and plugins where torrent file listing is used.

  Open multiple torrents silently

    Use this setting to skip all dialogs when opening more than one torrent. Opening one torrent, will still show the dialog.

  Suppress sleep when torrents are running

    Enable this option to prevent your computer from going into Hibernation or Stand by mode, when there are running torrents.

DHT
  Use DHT to get addition peers

    DHT is a way of gathering additional peers from other peers in the swarm. There are some torrents that do not use trackers to get the list of peers, but rely only on DHT. These are know as Trackerless Torrents. You will be unable to download these torrents, If this option is disabled.

  UDP port for DHT communication:

    Here you can set the port on which to search for additional peers. This port can be same as the port configured in the Downloads tab.

Encryption
  Use protocol encryption

    Some Internet Service Providers throttle (slowdown) their customers BitTorrent traffic. Encryption is designed to hide BitTorrent traffic so that detection and therefore throttling would fail. It is not designed to make data secure, but only to get around bandwidth throttling.

    If you select only this option, you will be unable to connect to peers that do not use protocol encryption.

  Allow unencrypted connections

    Even if your Internet Service Provider is not throttling your connection, you may still find that enabling encryption allows some peers to send you data (peers that use encryption and do not allow unencrypted connections). Selecting this options will enable you to connect both ways.

## Advanced

Advanced configuration dialog
Advanced configuration dialog

Data Checking
  Recheck chunks during uploading

    This will verify a chunk when it is loaded into memory, preventing upload of bad data.

  Don't recheck when chunks are bigger then:

    Here you can set maximum size of the chunk that are to be rechecked during uploading. Bigger chunks that specified will not be checked.

  Do a full data check after corrupted chunks

    Full data check will be started, if the specified number of corrupted chunks has been detected. If you regularly experience errors during downloads, enable this option.

  Check data when download is finished

    When torrent has finished downloading, data will be fully checked. Chunks that failed to download correctly, will be downloaded again.

Data Checking
  GUI update interval:

    Set here the interval of the GUI updates. If &ktorrent; is using much of your CPU, try decreasing this setting.

  Downloads sleep interval:

    Here you can set the time network threads will sleep when they are speed limited. Setting this to high can lead to lower speeds in high bandwidth situations, such as Local Area Networks. Setting this to low will increase your CPU usage.

Disk Space
  Reserve disk space before starting a download

    This will reserve disk space when starting a torrent. It is faster then full allocation but will fragment data on your disk.

  Fully reserve disk space (avoids fragmentation)

    Will this setting you can fully allocate data on the disk. This is slower, but will prevent data fragmentation on the disk.

  Disk space reservation method:

    Here you can select the method of allocation. Basic method will work with all file systems, but it is slow. Filesystem Specific method is faster, but will only work with some specific file systems.

Miscellaneous
  Time estimation algorithm:

    The algorithm selected here will be used to guess how much time is left for download to finish. Choose one of the following.

    KTorrent

      Automatically choose appropriate algorithm based on current situation.

    Current speed

      Bytes left to download divided by torrent current speed.

    Average speed

      Bytes left to download divided by torrent average speed.

    Moving of X

      Bytes left to download divided by average speed of the last 20 samples.

    Moving average

      Bytes left to download divided by moving average speed of the last 20 samples.

  Preview size for audio files:

    Selected amount of data, at the beginning and end of the file, that will be downloaded first. This will enable you to preview audio files.

  Preview size for video files:

    Selected amount of data, at the beginning and end of the file, that will be downloaded first. This will enable you to preview quality and content of video files.

## Plugins

Plugins configuration dialog
Plugins configuration dialog

In this tab you can enable or disable plugins. Plugins that are configurable, when enabled, will add their tab in the configuration dialog.