The details pane

The details pane shows one torrent: the one selected. With several selected, it asks you to select one. Ctrl+Shift+D (View → Details Pane) shows or hides it.

Where it sits

The pane sits under the list, beside it on the right (running the full height of the window), or is collapsed. Use View → Details Pane on the Right / Details Pane at the Bottom, the palette’s Move Details Pane Between Bottom and Right, or Settings → General → Appearance → Details pane. Hiding the pane keeps its place, and each place keeps its own size. The tab you were on is remembered.

The header

At the top: a disc in the state’s colour, the torrent’s name and a line with its size, file count, category and how long ago it was added. Beside them are Pause (or Resume), Reannounce, Open folder and ··· for more actions. These run the same commands as the menus, with the same keys.

Overview

The diagnosis. When a torrent is not moving, an amber card says why, in plain words, and offers what can be done about it. The first rule that fits wins:

SituationThe card saysRemedies offered
An error stopped itwhat libtorrent reportedTry again, Open its folder
It is waiting in the queueits place and when it startsStart it now (force resume)
No peer is connectedno trackers, trackers not answering, or nobody sharing it right nowAdd trackers…, Ask the trackers again
Pieces are on no peer in the swarmhow many, how much, and the availabilityAdd trackers…; Skip that file and finish the rest, when the missing pieces all belong to one wanted file and there are others
Peers are connected but none is sendingthat they send when a slot frees; nothing to do but waitnone
Nothing has arrived for a whilehow long, though peers are connectedAsk the trackers again

The piece strip. A bar of the torrent’s pieces, bucketed to fit the width. Pieces you have are filled; pieces that are missing and that no connected peer has are amber. A seed shows no amber.

The sparkline. Download and upload over the last minute, or over as much history as the selection has.

The facts. Pieces (how many you have, of how many, and their size), peers connected and seeds, downloaded and uploaded with the ratio, the info-hash, the save path, and the rest, with a Copy button. At 760 pixels wide and up they are laid out in two columns, below that in one.

Files

The torrent’s files as a tree, each with its icon, progress and priority (Skip, Low, Normal or High). Change a priority in place; the change is sent to the engine at once. The right-click menu has Open File, Open Folder, Open Containing Folder and Rename… for files and folders.

A file’s icon comes from its extension: folder, video, audio, image, book (ebooks and comic archives), document, subtitle, archive (split archives such as .r00 or .001 included), disc image, data, program, or other.

The Files tab is empty until a magnet’s metadata arrives.

Peers

Every connected peer: address, client, flags, progress, download and upload rates, and how much has been downloaded from and uploaded to it. The right-click menu has Copy Address and Ban Peer, which adds the peer’s host to the manual bans of the IP filter at once.

Trackers

Each tracker’s URL, tier, status (working, updating, not contacted, error) and last message. Add Trackers… takes URLs separated by spaces or lines, Reannounce asks them all again, and Remove takes the selected tracker off. A torrent with no trackers still finds peers through DHT and PEX.

Under the trackers are the torrent’s web seeds (HTTP or HTTPS servers that hold the files), with Add Web Seeds… and Remove.

Log

The Event Log for this torrent alone: when it was added, when its metadata arrived, when it was checked or finished, its tracker and disk errors.

Speed

The torrent’s download and upload graph over the last minute, ten minutes, hour or day, with the current rate and the peak in the legend. Every torrent keeps its recent rates while it is in the list, so the graph is not empty the first time you open it. The same graph for the whole session is in View → Statistics (Ctrl+Shift+T).