Filtering

Use glob patterns with --include and --exclude flags to precisely control which files are included in your torrent.

Built-in Exclusions

mkbrr automatically excludes these common system files and directories (case-insensitive):

.torrent
.ds_store
thumbs.db
desktop.ini
zone.identifier
@eadir (Synology NAS metadata directory)

Specify patterns for files to exclude from the torrent:

mkbrr create . -t ... --exclude "*.nfo"

mkbrr create . -t ... --exclude "*.nfo" --exclude "*sample*"

mkbrr create . -t ... --exclude "*.nfo,*sample*,*.txt"

Exclude patterns are useful when you want to keep most files but skip specific types.

Specify patterns for files to include in the torrent:

mkbrr create . -t ... --include "*.mkv"

mkbrr create . -t ... --include "*.mkv" --include "*.mp4"

mkbrr create . -t ... --include "*.mkv,*.mp4,*.avi"

Using --include activates whitelist mode - only matching files will be considered for inclusion.

Preset and Batch Support

Both filtering options can be defined in configuration files:

presets.yaml

presets:
  movies:
    include_patterns:
      - "*.mkv"
      - "*.mp4"
    exclude_patterns:
      - "*sample*"
      - "*.nfo"

batch.yaml

jobs:
  - output: movie.torrent
    path: /path/to/movie/
    include_patterns:
      - "*.mkv"
    exclude_patterns:
      - "*sample*"

Command-line flags (--include, --exclude) will add to any patterns defined in your preset or batch configuration.