Understanding the UI
The Patchy UI is designed to be easy to use and intuitive. Let's look at the main window:
There are several parts to the interface. We have the main menu, with "File", "View", etc, which is used for various purposes. The yellow bar is the quick add bar, which appears when you have copied a magnet link to your clipboard. Underneath, we see the torrent grid, with a list of all your active torrents. Below that is the torrent details, which shows you information about the selected torrent.
The available menu items change from time to time depending on the application state. Here is the full list of available actions:
-
File
- Add Torrent: Adds a torrent from a magnet link or a .torrent file
- Create Torrent: Launches the torrent creation window
- Exit: Shuts down all torrents and exits Patchy
-
View:
- Torrent Details: Toggles the detail panel's visibility
- RSS Feeds: Toggles the RSS feed panel's visibility
-
Torrent
- Stop: Stops the selected torrents
- Pause: Pauses the selected torrents
- Resume: Resumes the selected torrents
- Move: Moves the selected torrent to a new directory
- Rehash: Forces a hash check of the selected torrent
-
Remove
- Torrent: Removes the torrent from Patchy
- Torrent and data: Removes the torrent from Patchy and deletes downloaded files
- Set Label: Sets the label for the selected torrents
-
Options
- Preferences: Opens the user preference window
-
Help
- Documentation: Launches a web browser to view documentation online
- Report Bug: Launches a web browser to create a GitHub issue
- Source Code: Launches a web browser to view Patchy's source code
On the far right is the torrent filter, which lets you change which torrents are displayed.
Changing the selection will change which torrents appear in the torrent list.
The torrent list displays all torrents currently tracked by Patchy.
The "Label" column only appears when there are torrents with labels listed.
Details describing the selected torrent in the torrent list will be shown in the detail pane below. You may select multiple torrents by holding down Ctrl or Shift while clicking them. When right clicked, the following options are presented:
- Open Folder: Opens the folder the torrent is being downloaded to
- Copy Magnet Link: Copies a magnet link to the clipboard for sharing with others
- Stop: Stops the selected torrents
- Pause: Pauses the selected torrents
- Resume: Resumes the selected torrents
- Move: Moves the selected torrent to another directory
- Rehash: Forces a hash check on the selected torrents
-
Remove
- Torrent: Removes the selected torrents from Patchy
- Torrent and data: Removes the torrent from Patchy and deletes downloaded files
- Set Label: Sets the label for the selected torrents
You may click on the headers of any column to sort torrents by that column. Double clicking a torrent opens the containing folder by default, though this action may be customized in the user preferences.
The detail pane shows information about the selected torrent in the torrent list.
The information tab shows you statistics and other information about the selected torrent.
The strange looking bar shows you the progress of individual pieces in the torrent.
The file tab shows you each file included in the torrent.
By clicking the drop down on the right, you may set the priority of each file. You may also do this by right clicking a file. When you double click a file, it will be opened by the system. You can also right click and select "Open containing folder" if you wish to do so.
The peers tab shows you a list of peers that you are currently connected to for this torrent.
No peers are shown here for the sake of privacy.
The options tab will allow you to edit connection settings for specific torrents.
The default values may be set in user preferences.