id       = "torrra"
name     = "torrra"
homepage = "https://torrra.readthedocs.io/en/latest/"
description = "Find and download torrents without leaving your CLI."
executables   = ["torrra"]

[dotfiles]

# The project's configuration guide documents ~/.config/torrra/config.toml on
# Linux/macOS and %APPDATA%\\torrra\\config.toml on Windows. It contains
# Jackett/Prowlarr API keys, so the whole file is secret.
# https://github.com/stabldev/torrra/blob/main/docs/configuration.md
paths = []
exclude = []
secret = ["~/.config/torrra/config.toml", "%APPDATA%/torrra/config.toml"]

[commands]
format = 1
label = "Search or download torrents"
description = "Direct search through the default indexer, or download a magnet URI, URL or .torrent file. Indexer connection options are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "readme"
kind = "manual"
url = "https://github.com/stabldev/torrra"
revision = "2026-10-27"
evidence = """
torrra search "arch linux iso"
torrra search "arch linux iso" --no-cache
torrra download "magnet:?xt=urn:btih:..."
torrra download "/path/to/file.torrent"
torrra download "magnet:?xt=urn:btih:..." --save-path /downloads/linux
"""

[[commands.subcommand]]
path = ["search"]
label = "Search"

[[commands.subcommand.source]]
id = "readme"
kind = "manual"
url = "https://github.com/stabldev/torrra"
revision = "2026-10-27"
evidence = """
torrra search "arch linux iso"
torrra search "arch linux iso" --no-cache
"""

[[commands.subcommand.field]]
id = "query"
label = "Search query"
type = "string"
position = 0
min = 1
sources = ["readme"]

[[commands.subcommand.field]]
id = "no_cache"
label = "Skip cache"
type = "boolean"
option = ["--no-cache"]
sources = ["readme"]

[[commands.subcommand.task]]
id = "search"
label = "Search"
fields = ["query", "no_cache"]
required = ["query"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["query", "no_cache"]

[[commands.subcommand]]
path = ["download"]
label = "Download"

[[commands.subcommand.source]]
id = "readme"
kind = "manual"
url = "https://github.com/stabldev/torrra"
revision = "2026-10-27"
evidence = """
torrra download "magnet:?xt=urn:btih:..."
torrra download "/path/to/file.torrent"
torrra download "magnet:?xt=urn:btih:..." --save-path /downloads/linux
"""

[[commands.subcommand.field]]
id = "source"
label = "Magnet URI, URL or .torrent file"
type = "string"
position = 0
min = 1
sources = ["readme"]

[[commands.subcommand.field]]
id = "save_path"
label = "Save to"
type = "path"
path = { kind = "directory", role = "output" }
option = ["--save-path"]
sources = ["readme"]

[[commands.subcommand.task]]
id = "download"
label = "Download"
fields = ["source", "save_path"]
required = ["source"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["source", "save_path"]