The mkbrr inspect command allows you to view the metadata and file structure contained within a .torrent file without needing the actual content files.

Arguments

torrent-file
string
required

The path to the .torrent file you want to inspect.

Flags

--verbose, -v
boolean
default:"false"

Show all metadata fields found in the torrent file, including non-standard ones in both the root and info dictionaries.

Use verbose mode when you need to inspect custom or non-standard metadata fields that might be present in the torrent.

Output

The command displays the following information by default:

Basic Information

For multi-file torrents, a file tree is displayed showing the path and size of each file within the torrent structure.

Examples

Inspect a torrent file with default output:

mkbrr inspect my-release.torrent
mkbrr inspect <torrent-file> [flags]

Arguments

  • <torrent-file>: (Required) The path to the .torrent file you want to inspect.

Flags

--verbose, -v
boolean
default:"false"

Show all metadata fields found in the torrent file, including non-standard ones in both the root and info dictionaries.

Output

The command displays the following information by default:

  • Name: The root name of the torrent content.
  • Hash: The info hash of the torrent.
  • Size: Total size of the content.
  • Piece length: Size of each piece.
  • Pieces: Total number of pieces.
  • Trackers: Announce URLs.
  • Web seeds: Any web seed URLs included.
  • Private: Whether the private flag is set.
  • Source: The source tag, if present.
  • Comment: The comment, if present.
  • Created by: The tool used to create the torrent, if specified.
  • Created on: The creation date, if specified.
  • Files: Number of files (for multi-file torrents).

If the torrent contains multiple files, a file tree is also displayed, showing the path and size of each file within the torrent structure.

Examples

Inspect a torrent file:

mkbrr inspect my-release.torrent

Inspect a torrent file with verbose output to see all metadata:

mkbrr inspect another.torrent -v