Skip to main content

​
Usage

Existing metadata is preserved during modification — only the fields you explicitly change are updated.

​
Arguments

  • [torrent files...]: (Required) One or more paths to the .torrent files to modify.

​
Flags

​
Input & Output

​
string[]
Tracker URLs (can be specified multiple times).
​
string
Set the torrent’s internal name.
​
string
Output directory for modified files.
​
string
Custom output filename (without extension).
When modifying multiple torrents, using --output with a fixed filename will cause subsequent files to overwrite the previous ones. Use --output-dir instead for batch modifications to preserve all modified files with unique names.

​
Advanced Input (Presets)

​
string
Use preset from config.
For reusing common settings across torrents. See the Presets documentation for details.
​
string
Preset config file (default ~/.config/mkbrr/presets.yaml).
Set custom path to presets.yaml. See the Presets documentation for details.

​
Torrent Internals

​
boolean
default:true
Make torrent private.
Private flag is enabled by default for tracker compliance. Only disable if you’re creating a public torrent.
​
boolean
default:false
Remove the private flag entirely.
​
boolean
default:false
Randomize the torrent’s info hash by adding or updating a unique, random entropy key in the info dictionary before hashing.
Cross-seeding is the practice of seeding the same content on multiple trackers. Using the entropy flag helps avoid conflicts between trackers.

​
Seeding & Metadata

​
array
Specify web seed URLs. Can be used multiple times.
Web seeds provide an HTTP fallback source for the torrent content, improving availability.
​
string
Specify the source string.
Some trackers require or recommend specific source tags. Check your tracker’s rules.
​
string
Specify a comment.
​
boolean
default:false
Omit the creation date from the torrent metadata.
If omitted, the creation date is updated to the current time during modification.
​
boolean
default:false
Omit the creator string from the torrent metadata.

​
Execution & Output Control

​
boolean
default:false
Be verbose.
​
boolean
default:false
Enable quiet mode, printing only the final torrent file path upon success. Useful for scripts.
​
boolean
default:false
Don’t add tracker domain prefix to output filename.
​
boolean
default:false
Show what would be modified without making changes.
When modifying multiple torrents, using --output with a fixed filename will cause subsequent files to overwrite the previous ones. Use --output-dir instead for batch modifications to preserve all modified files with unique names.