btpc create
Create canonical v1, v2, or hybrid metainfo from a file or directory
Parent: btpc
See Configuration and global flags and Exit codes and streams.
Synopsis
Usage: btpc create [OPTIONS] [INPUTS]...
Arguments
| Argument | Description |
|---|---|
<INPUTS> | Payload files or directories |
Options
| Option | Description |
|---|---|
--batch, <BATCH> | Versioned TOML batch manifest |
--mode, <MODE> | Torrent protocol representation Values: v1, v2, hybrid. |
-o, --output, <OUTPUT> | Destination .torrent path (defaults beside the payload) |
--output-dir, <OUTPUT_DIR> | Write batch outputs beneath this directory |
--jobs, <JOBS> | Maximum concurrent batch creation jobs Default: 1. |
--fail-fast | Stop scheduling batch jobs after the first failure Default: false. |
-f, --force | Replace an existing destination Default: false. |
--durable | Sync the destination directory after atomic publication where supported Default: false. |
--preset, <PRESETS> | Apply a named creation preset; may be repeated |
--piece-length, <PIECE_LENGTH> | Explicit piece length in bytes |
--target-pieces, <TARGET_PIECES> | Target approximate number of pieces for automatic selection |
--max-piece-length, <MAX_PIECE_LENGTH> | Cap target-based automatic piece length |
-a, --tracker, <TRACKERS> | Add a tracker as its own tier; may be repeated |
--clear-trackers | Clear configured and preset trackers before CLI additions Default: false. |
--tracker-tier, <TRACKER_TIER> | Add one comma-separated tracker tier; may be repeated |
--tracker-alias, <TRACKER_ALIASES> | Add a configured tracker alias; may be repeated |
--tracker-group, <TRACKER_GROUPS> | Add a configured tracker group; may be repeated |
--web-seed, <WEB_SEEDS> | Add a web seed URL; may be repeated |
--clear-web-seeds | Clear configured and preset web seeds before CLI additions Default: false. |
--node, <NODES> | Add a DHT node as HOST:PORT; may be repeated |
--private | Set the private flag Default: false. |
--public | Set the private flag to false Default: false. |
--source, <SOURCE> | Set the source field |
--clear-source | Remove configured or preset source metadata Default: false. |
--comment, <COMMENT> | Set the top-level comment |
--clear-comment | Remove configured or preset comment metadata Default: false. |
--created-by, <CREATED_BY> | Set the creator string |
--no-created-by, --clear-created-by | Omit the creator string instead of using the versioned default Default: false. |
--creation-date, <CREATION_DATE> | Include an explicit Unix creation timestamp |
--entropy, <ENTROPY> | Set deterministic, random, or omitted entropy policy |
--name, <NAME> | Override the torrent root name |
--exclude-hidden | Exclude dot-prefixed files and directories Default: false. |
--symlinks, <SYMLINKS> | Symbolic-link policy Values: reject, skip, follow. |
--special-files, <SPECIAL_FILES> | Special-file policy Values: reject, skip. |
--exclude-empty-files | Exclude zero-length files Default: false. |
--reject-empty-directories | Reject empty directories instead of ignoring them Default: false. |
--include, <INCLUDES> | Include only paths matching this glob; may be repeated |
--clear-includes | Clear configured and preset include patterns before CLI additions Default: false. |
--exclude, <EXCLUDES> | Exclude paths matching this glob; may be repeated |
--clear-excludes | Clear configured and preset exclude patterns before CLI additions Default: false. |
--threads, <THREADS> | v1 hashing threads; 0 selects a conservative automatic count, 1 is sequential |
--dry-run | Plan creation without hashing or writing metainfo Default: false. |
--print, <PRINT> | Print selected result fields; may be repeated Values: path, info-hash-v1, info-hash-v2, magnet. |
--json | Emit a versioned JSON result to stdout Default: false. |
--pretty | Use the expanded human completion renderer Default: false. |
-h, --help | Print help |
Global options
| Option | Description |
|---|---|
--config, <PATH> | Use this configuration file when configuration loading is enabled |
--no-config | Disable implicit and environment-selected configuration Default: false. |
--color, <COLOR> | Control colored terminal output Values: auto, always, never. |
-v, --verbose | Increase diagnostic verbosity; may be repeated Default: 0. |
-q, --quiet | Suppress human summaries, warnings, and progress Default: false. |
Example
$ btpc create --help