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.

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

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"

​
Configuration Options

Required Fields

  • version: Must be 1
  • jobs: List of torrent creation tasks
  • output: Path for the .torrent file
  • path: Source file/directory path

Optional Settings

  • trackers: Announce URLs list
  • webseeds: Web seed URLs list
  • private: Set to true or false
  • piece_length: Piece size exponent

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.

Was this page helpful?