# Install torf-cli with Homebrew CLI tool for creating, reading and editing torrent files. Version 5.2.1 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:torf-cli ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install torf-cli ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:torf-cli - **Package manager:** Homebrew - **Package manager page:** - **Version:** 5.2.1 - **Source summary:** CLI tool for creating, reading and editing torrent files - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-3.0-or-later - **Source archive:** - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - torf (cli) - torf (alias) ## Dependencies - python@3.14 ## Install behavior - Post-install hook: not defined - Bottle: available on all ## Freshness - Page generated: 2026-07-08 - Package-manager version: 5.2.1 - Local data: ok - Upstream repository: https://github.com/rndusr/torf-cli - info: No package-manager update timestamp was available. - info: No cached GitHub release or tag data was available. ## Project history and usage torf-cli is a command-line interface around the Python torf library for creating, reading, editing, and verifying BitTorrent .torrent files and magnet URIs. ### Project history The official README presents torf-cli as a focused packaging of torrent metadata operations for terminal users. It depends only on torf and pyxdg, provides both human-readable output and parseable output for standard CLI tools, and ships documentation as a man page mirrored on the project's GitHub Pages site. The tool's history is best understood as part of the BitTorrent metainfo tooling niche: rather than being a downloader, it handles the .torrent metadata layer, including creating torrents, inspecting existing torrents, editing fields such as comments, verifying files against torrent metadata, and reusing existing piece hashes to avoid rehashing. ### Adoption history Official installation notes say the latest release is available on PyPI and AUR, and recommend pipx as the cleanest install method. The input package facts add Homebrew packaging, which places torf-cli in the package-manager niche for users who want a single torf executable rather than writing Python against the torf library. ### How it is used The README examples show creating private torrents with trackers and fixed creation dates, displaying torrent information, editing an existing torrent into a revised output file, verifying a filesystem path against torrent contents with detailed errors, and emitting JSON/metainfo that can be piped into tools such as grep, cut, and jq. For package nerds, torf-cli is useful because it makes BitTorrent metadata reproducible and scriptable. It can fit into release pipelines, archival workflows, tracker/private-torrent preparation, and integrity checks without opening a graphical torrent client. ### Why package nerds care torf-cli is significant in a narrow but real CLI niche: it turns torrent metainfo into inspectable, editable, and automatable terminal output. Its package-manager value is strongest for users who manage torrent files as artifacts and want predictable command output and JSON for shell pipelines. ### Timeline - Project docs: README defines torf-cli as a tool to create, read, edit, and verify torrent files and magnet URIs. - Packaging: README documents PyPI and AUR availability; input facts add Homebrew. - Current docs: Project documentation is published as an online torf(1) man page at rndusr.github.io/torf-cli. ### Related projects - The README names torf, the underlying Python library, and pyxdg as its only dependencies. It also positions jq, grep, and cut as useful companion tools for parseable output. ### Sources - - - source_facts.package-manager ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** torf-cli - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [torrra](https://www.automicvault.com/pkg/brew/torrra/) - Shares av.db curated category or tags: bittorrent, cli, networking, python. - [intermodal](https://www.automicvault.com/pkg/brew/intermodal/) - Shares av.db curated category or tags: bittorrent, cli, networking. - [mabel](https://www.automicvault.com/pkg/brew/mabel/) - Shares av.db curated category or tags: bittorrent, cli, networking. - [mkbrr](https://www.automicvault.com/pkg/brew/mkbrr/) - Shares av.db curated category or tags: bittorrent, cli, networking. - [mktorrent](https://www.automicvault.com/pkg/brew/mktorrent/) - Shares av.db curated category or tags: bittorrent, cli, networking. - [qbittorrent-cli](https://www.automicvault.com/pkg/brew/qbittorrent-cli/) - Shares av.db curated category or tags: bittorrent, cli, networking. - [rqbit](https://www.automicvault.com/pkg/brew/rqbit/) - Shares av.db curated category or tags: bittorrent, cli, networking. - [rtorrent](https://www.automicvault.com/pkg/brew/rtorrent/) - Shares av.db curated category or tags: bittorrent, cli, networking. ## Combined YAML source View the package source record on GitHub. [combined/torf-cli.yml](https://github.com/automic-vault/db/blob/main/combined/torf-cli.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph