Quick Start

Common Use Cases

Private Trackers
Public Trackers

# Basic private tracker torrent (default)
mkbrr create "Movie.2024.1080p.BluRay.x264" -t https://your-tracker.com/announce

# With custom piece size
mkbrr create "Movie.2024.1080p.BluRay.x264" -t https://your-tracker.com/announce --piece-length 24

# With source and comment
mkbrr create "Movie.2024.1080p.BluRay.x264" -t https://your-tracker.com/announce --source "BluRay" --comment "Great quality!"

All torrents are private by default - perfect for private trackers.

# Basic public tracker torrent
mkbrr create "Linux.ISO" -t udp://tracker.opentrackr.org:1337/announce --private=false

# Multiple public trackers
mkbrr create "Linux.ISO" -t udp://tracker1.com -t udp://tracker2.com --private=false

Use --private=false for public trackers. Specify multiple trackers by repeating the -t flag.

Smart Defaults

mkbrr automatically handles many settings for you:

Piece Size

Automatically calculated based on content size for optimal performance

File Name

Generated from tracker domain and content name if not specified

Common Options

Frequently Used Flags

--tracker, -t     # Tracker URL
--output, -o      # Output file name
--piece-length    # Manual piece size (power of 2)
--source          # Source tag
--comment         # Torrent comment
--private         # Private flag (default: true)

Troubleshooting

Common Issues

Permission Denied

sudo chmod +x ./mkbrr  # Make binary executable

Invalid Piece Size

Piece size must be a power of 2 between 16 and 27 (14 to 27 for trackers with their own piece size table):

# Valid sizes: 16(64KiB), 17(128KiB), 18(256KiB)...27(128MiB)
# Trackers with custom piece ranges also allow 14(16KiB) and 15(32KiB)
mkbrr create data -t tracker.url --piece-length 16

Multiple Files

For directories, ensure you point to the parent folder:

mkbrr create "Season.1/" -t tracker.url  # Correct
mkbrr create "Season.1/*" -t tracker.url # Wrong

Get Started

Usage

Features

Performance

Development

Common Use Cases

Smart Defaults

Piece Size

File Name

Common Options

Troubleshooting

Permission Denied

Invalid Piece Size

Multiple Files

Next Steps

Creating Torrents

Tracker Rules

​Common Use Cases

​Smart Defaults

Piece Size

File Name

​Common Options

​Troubleshooting

​Permission Denied

​Invalid Piece Size

​Multiple Files

​Next Steps

Creating Torrents

Tracker Rules

Common Use Cases

Smart Defaults

Common Options

Troubleshooting

Permission Denied

Invalid Piece Size

Multiple Files

Next Steps