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 theme modes.
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)
xattr -cr /path/to/mkbrr-gui.app
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: 
# Clone the repository
git clone https://github.com/autobrr/mkbrr.git
cd mkbrr

# Install Wails CLI (one-time requirement)
make install-wails

# Build GUI for your current platform
make gui-build

# Or build for all platforms
make gui-build-all
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:
FeatureCLIGUI
Create torrentsYesYes
Inspect metadataYesYes
Check integrityYesYes
Modify metadataYesYes
Batch operationsYesNo
Preset supportYesYes
Preset managementManual YAMLVisual editor
Progress displayTextVisual with progress bar
File tree viewTextInteractive & searchable
Scripting/automationYesNo
Theme customizationNoYes