Category List

The category list allows you to filter the torrent jobs displayed in the torrent jobs list. The category list's visibility can be toggled by selecting "Options" then "Show Category List" in the main menus, or by pressing F7 on the keyboard. The last selected category before BitTorrent Mainline is exited will be automatically selected on the next start. Numbers in the parentheses next to the category name indicate the number of torrent jobs there are listed under the respective category. The list is composed of the following default categories:

• All applies no filters on the torrent jobs list, so any (and all) torrent jobs on the list will be displayed.
• Downloading only shows torrent jobs that are not finished or completed.
• Completed displays all torrent jobs that have finished downloading.
• Active only shows torrent jobs that are actively being transferred, whether it is downloading or seeding. Downloading torrent jobs must be downloading at rates above the value specified by queue.slow_dl_threshold to be considered active. Seeding torrent jobs must be uploading at rates above the value specified by queue.slow_ul_threshold to be considered active.
• Inactive only shows torrent jobs that are not being actively transferred. This includes all torrent jobs that are stopped, waiting in the queue, or are started, but transferring at rates below queue.slow_dl_threshold (for downloading torrent jobs) or queue.slow_ul_threshold (for seeding torrent jobs).
   
• No Label will display all torrent jobs that have no labels set.
   
• All Feeds will display the RSS items from all RSS feeds.

Extra "categories" appearing in the category list immediately below "No Label" that you do not see listed above are a result of custom labels given to your torrent jobs. Torrent jobs with labels will be displayed under their corresponding label. Persistent labels are listed before non-persistent (temporary) labels. A temporary label is removed from the category list as soon as there are no torrent jobs using it.

Not all categories are mutually exclusive, so if you have a torrent job that has no labels, and is inactive, it will show up in both the "Inactive" category, and the "No Label" category. Multiple categories can be selected by holding Shift or Ctrl while left-clicking on a category. Holding Shift will select all categories in between the first selected category and the last selected one. Holding Ctrl allows you to select (or deselect) specific categories that aren't necessarily adjacent to each other. When multiple categories are selected, BitTorrent Mainline will filter the torrent jobs list to display all torrent jobs that match each of the selected categories' criterion. If multiple labels or RSS feeds are selected, any torrent jobs that fall under any of the selected labels will be displayed (assuming they pass the selected category filters).

RSS feeds are displayed at the bottom of the category list (below the labels). When an RSS feed is selected, the torrent jobs list is filled with torrents as listed in the RSS feed. Torrent jobs added from a feed are also listed in their respective source feeds.

Context Menu

If you right-click on an item in the category list, you'll see a context menu. They are described in the following list:

• 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 RSS Feed... opens up the Add RSS Feed dialog, where you can add RSS feeds for BitTorrent Mainline to monitor.
•  
• Torrent Options displays select menu items from the torrent jobs list context menu, and behave identically to their torrent jobs list context menu counterparts. These menu items show up only if there are torrent jobs selected in the torrent jobs list.
• RSS Feed Options displays options for the RSS feed, and show up only if RSS items are selected in the torrent jobs list. If "All Feeds" item is right-clicked, the selected action is applied on every feed.
  
  • RSS Downloader opens up the RSS Downloader dialog.
  •  
  • Update Feed allows you to perform a manual reload of the selected RSS feed(s). Refrain from using this repeatedly in rapid succession, as hammering the RSS feed's server won't make the feed be updated with new items any more quickly, and you run the chance of causing the server to fail. In short, do not abuse this feature.
  • Toggle Feed enables or disables the RSS feed updating for the selected feed(s).
  • Edit Feed... opens up the Edit RSS Feed dialog, where you can edit the properties of the selected RSS feed(s). If multiple feeds are selected, BitTorrent Mainline will open an edit dialog for each feed one at a time, opening another dialog for the next feed only after the current feed's edit dialog is closed.
  • Delete Feed removes the RSS feed from the list.
  • Clear Feed History removes all entries in the RSS Downloader's History tab that came from the selected feed(s).