modify
Modify existing torrent files using a preset or flags.
Usage
Note: All unnecessary metadata will be stripped during modification.
Arguments
[torrent files...]: (Required) One or more paths to the.torrentfiles to modify.
Flags
Input & Output
Set a new tracker URL (replaces existing).
Output directory for modified files.
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)
Use preset from config.
For reusing common settings across torrents. See the Presets documentation for details.
Preset config file (default ~/.config/mkbrr/presets.yaml).
Set custom path to presets.yaml. See the Presets documentation for details.
Torrent Internals
Make torrent private.
Private flag is enabled by default for tracker compliance. Only disable if you’re creating a public torrent.
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.
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
Specify web seed URLs. Can be used multiple times.
Web seeds provide an HTTP fallback source for the torrent content, improving availability.
Specify the source string.
Some trackers require or recommend specific source tags. Check your tracker’s rules.
Specify a comment.
Omit the creation date from the torrent metadata.
Omit the creator string from the torrent metadata.
Execution & Output Control
Be verbose.
Enable quiet mode, printing only the final torrent file path upon success. Useful for scripts.
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.