Batch mode is ideal for creating multiple torrents in one go.
Configuration File (batch.yaml) Batch operations are defined in a YAML file, typically named batch.yaml.
Command
Example batch.yaml
mkbrr create -b /path/to/your/batch.yaml
While batch.yaml is a common convention, you can use any filename. Just be sure to specify it with -b.
Configuration Structure Movies Example
TV Shows Example
Mixed Content
jobs : - output : /torrents/movie1.torrent path : /media/movies/movie1.mkv trackers : - https://tracker-one.com/announce/abc private : true comment : "4K HDR Release" source : "UHD" - output : /torrents/movie2.torrent path : /media/movies/movie2.mkv trackers : - https://tracker-one.com/announce/abc private : true comment : "1080p Release" source : "BluRay" - output : /torrents/movie3.torrent path : /media/movies/movie3.mkv trackers : - https://tracker-one.com/announce/abc private : true comment : "720p Release" source : "WEB"
jobs : - output : /torrents/show_s01.torrent path : /media/tv/Show/Season 1/ trackers : - udp://tracker-two.org:6969/announce private : true piece_length : 18 # 256 KiB pieces comment : "Complete Season 1" exclude_patterns : - "*.nfo" - "*.jpg" - output : /torrents/show_s02.torrent path : /media/tv/Show/Season 2/ trackers : - udp://tracker-two.org:6969/announce private : true piece_length : 18 comment : "Complete Season 2" exclude_patterns : - "*.nfo" - "*.jpg"
jobs : - output : /torrents/album.torrent path : /media/music/Artist/Album/ trackers : - udp://tracker-three.org:6969/announce private : false piece_length : 18 webseeds : - http://seed.example.com/album/ exclude_patterns : - "*.log" - "folder.jpg" - output : /torrents/game.torrent path : /media/games/Game.iso trackers : - https://tracker-four.com/announce private : true piece_length : 22 # 4 MiB pieces source : "RETAIL" - output : /torrents/ebook.torrent path : /media/books/Book.pdf trackers : - https://tracker-five.com/announce private : true comment : "PDF + Extras"
Configuration Options
Required Fields
version : Must be 1jobs : List of torrent creation tasksoutput : Path for the .torrent filepath : Source file/directory path
Optional Settings
trackers : Announce URLs listwebseeds : Web seed URLs listprivate : Set to true or falsepiece_length : Piece size exponent
Additional Optional Settings
comment : Torrent comment stringsource : Source tag stringno_date : Set true to omit creation dateexclude_patterns : Glob patterns to exclude filesinclude_patterns : Glob patterns to include files You can find the formal JSON schema for validation here . You cannot provide a source path argument directly to mkbrr create when using the -b flag. All source paths must be defined within the batch file jobs.
