Toolbar

The buttons on the toolbar at the top of the BitTorrent Mainline interface allows you perform some basic functions, most of which apply to the currently selected torrent(s). The order of the list here reflects the order of the buttons in the toolbar. If you are unsure, you can place your mouse cursor over a button, and a tooltip should pop up providing the description of the button. The toolbar's visibility can be toggled by selecting "Options" then "Show Toolbar" in the main menus, or by pressing F4 on the keyboard.

  • Add Torrent prompts you for the location of the .torrent file that you are trying to open on disk. If you set a default download location, the torrent job will automatically be added to the torrent jobs list and started (if you did not set BitTorrent Mainline to start torrent jobs in stopped mode). If you did not set a default download location, you will be prompted where you would like to save the torrent contents, with the Add New Torrent dialog being shown by default.
  • Add Torrent from URL allows you to open a .torrent file directly from URL without having saved the it to your hard disk. Depending on the method used by the website for authenticating users (if any), the URL may have to be entered in a specific format. Magnet URIs may be used here, and BitTorrent Mainline will attempt to download the info dictionary from the corresponding .torrent file from any other client that also supports the URI scheme.
  • Add RSS Feed opens up the Add RSS Feed dialog, where you can add RSS feeds for BitTorrent Mainline to monitor.
  •  
  • Create New Torrent lets you create .torrent files that you can use to share your data with other people.
  •  
  • Remove will remove the selected torrent job(s) using the default action when left-clicked. This default action can be set by right-clicking the button and left-clicking one of the four possible options. The default remove action can also be performed by pressing Delete on the keyboard.
    • Remove removes the selected torrent job(s) from the list, but all related files are left intact on the disk.
    • Delete .torrent removes the selected torrent job(s) from the list and the corresponding .torrent file(s) from the .torrent file storage location.
    • Delete .torrent + Data removes the selected torrent job(s) from the list, the corresponding .torrent file(s) from the .torrent file storage location, and all content downloaded from the torrent job(s). This action can also be performed by pressing Shift+Delete on the keyboard.
    • Delete Data removes the selected torrent job(s) from the list and all content downloaded from the torrent job(s).
    •  
    • Move to trash if possible tells BitTorrent Mainline to attempt to move any deleted file to the Recycle Bin first rather than deleting it immediately off the disk. This works only if the Recycle Bin has enough space allocated.
  •  
  • Start will start the selected torrent job(s), or add it onto the queue if the number of active torrent jobs has reached the maximum set in the Preferences.
  • Pause will pause the selected torrent job(s), but won't actually stop it. This tells BitTorrent Mainline to attempt to retain connections to peers without having to re-establish them like starting stopped torrent jobs would require. It is useful for when you need quick access to bandwidth. Realize that while BitTorrent Mainline won't drop the connections on its own accord, the connection can still get dropped by the client on the other end of the connection.
  • Stop will stop the selected torrent job(s). All connections with peers are dropped.
  •  
  • Move Up Queue will decrease the selected torrent's queue number, thus bringing it closer to the top of the queue (meaning it will become active sooner than those with higher queue numbers). Holding Shift while pressing this button will move the selected torrent job to the top of the queue. Note that this button will not visually move the torrent job up the list unless you sort the list by the "#" column. Pressing Ctrl+Alt+Up on the keyboard is equivalent to pressing this button when a torrent job is selected in the torrent jobs list.
  • Move Down Queue will increase the selected torrent's queue number, thus bringing it further from the top of the queue (meaning it will become active later than those with lower queue numbers). Holding Shift while pressing this button will move the selected torrent job to the bottom of the queue. Note that this button will not visually move the torrent job down the list unless you sort the list by the "#" column. Pressing Ctrl+Alt+Down on the keyboard is equivalent to pressing this button when a torrent job is selected in the torrent jobs list.
  •  
  • Preferences opens up the Preferences dialog, where you can configure most of BitTorrent Mainline's options.
  •  
  • The Search button displays a popup menu that allows you to select the search engine you wish to use. The search engines can be configured in the Preferences. To search, type your query into the given field, and press Enter on the keyboard. Note that the search button and search field will be hidden if the search engine list is empty.

© 2001-2009. BitTorrent, Inc. All rights reserved. BitTorrent, the BitTorrent Logo, and Torrent are trademarks of BitTorrent, Inc.