Skip to main content
mkbrr includes a graphical user interface built with Wails for users who prefer a visual experience over the command line.
mkbrr GUI - Create page

​
Features

The GUI provides the same core functionality as the CLI with additional usability enhancements:

Create

Create torrent files with tracker support, presets, and real-time progress tracking with hash rate display.

Inspect

View torrent metadata with a searchable, collapsible file tree.

Check

Verify torrent data integrity with detailed results showing good, bad, and missing pieces.

Modify

Edit torrent metadata without needing the original source files.

​
Settings

The Settings page allows you to:
  • Configure default worker count for hashing operations
  • Manage presets (create, edit, delete)
  • View and reload the preset file location
mkbrr GUI - Settings page

​
Additional Features

Choose between light, dark, or system appearance modes, plus five color themes: Default, Autobrr (the default), Nightwalker, Swizzin, and Amethyst Haze.
Drag a file or folder onto any page to fill its path automatically — drop content to set the source on Create, a .torrent or content on Check, or a .torrent to Inspect or Modify.
When creating torrents, the GUI automatically detects tracker-specific requirements and suggests optimal piece sizes based on your content size and tracker rules.
Form state is automatically saved across sessions. If you close the app while filling out a form, your inputs will be restored when you return.
Full preset management with validation. Create, edit, and delete presets directly from the GUI without manually editing YAML files.
The Inspect page features an advanced file tree viewer with:
  • Search functionality with auto-expand
  • Collapsible folder structure
  • File count per folder
  • Smart expansion for smaller torrents

​
Installation

Download the GUI binary for your platform from the GitHub Releases page.
Download mkbrr-gui_*_darwin_*.zip and extract the .app bundle.
The app is not notarized, so macOS will block it by default. Use one of these methods:
Option 1: Remove quarantine attribute (recommended)
Option 2: Right-click to open
  1. Right-click (or Control-click) on the app
  2. Select “Open” from the context menu
  3. Click “Open” in the dialog
Option 3: System Settings
  1. Try to open the app (it will be blocked)
  2. Open System Settings > Privacy & Security
  3. Click “Open Anyway” next to the mkbrr-gui message

​
Building from Source

If you prefer to build the GUI yourself:
The built application will be in gui/build/bin/.

​
GUI vs CLI

Both interfaces provide the same core torrent operations. Choose based on your workflow: