# 使用 Homebrew 安装 torf-cli

查看 torf-cli 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:torf-cli
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install torf-cli
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:torf-cli
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/torf-cli>
- **版本:** 5.2.1
- **来源摘要:** CLI tool for creating, reading and editing torrent files
- **主页:** <https://github.com/rndusr/torf-cli>
- **仓库:** <https://github.com/rndusr/torf-cli>
- **许可证:** GPL-3.0-or-later
- **源码归档:** <https://files.pythonhosted.org/packages/31/90/b67f5f73353f419b172c8d22ebaf744750fa22af9eb4b52adff52a7706f2/torf_cli-5.2.1.tar.gz>
- **已生成:** 2026-08-04T22:13:35+00:00

## 可执行文件

- torf (cli)
- torf (别名)

## 依赖

- python@3.14

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 all

## 版本和新鲜度

- 页面生成时间: 2026-08-04
- 管理器版本: 5.2.1
- 本地数据: OK
- 上游仓库: https://github.com/rndusr/torf-cli
- 信息: No package-manager update timestamp was available.
- 信息: No cached GitHub release or tag data was available.
## 项目历史与用法

torf-cli is a command-line interface around the Python torf library for creating, reading, editing, and verifying BitTorrent .torrent files and magnet URIs.

### 项目历史

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.

### 采用历史

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.

### 使用方式

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.

### 为什么软件包爱好者会关心

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.

### 时间线

- 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.

### 来源

- <https://github.com/rndusr/torf-cli#readme>
- <https://rndusr.github.io/torf-cli/torf.1.html>
- source_facts.package-manager


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals

## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** torf-cli
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## 相关链接

- [Source-control packages](https://pkg.so/zh-hans/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Language runtime packages](https://pkg.so/zh-hans/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://pkg.so/zh-hans/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [python@3.14](https://pkg.so/zh-hans/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [torrra](https://pkg.so/zh-hans/brew/torrra/) - Shares pkgdb curated category or tags: bittorrent, cli, networking, python.
- [aria2](https://pkg.so/zh-hans/brew/aria2/) - Shares pkgdb curated category or tags: bittorrent, cli, networking.
- [speedtest-cli](https://pkg.so/zh-hans/brew/speedtest-cli/) - Shares pkgdb curated category or tags: cli, networking, python.
- [magic-wormhole](https://pkg.so/zh-hans/brew/magic-wormhole/) - Shares pkgdb curated category or tags: cli, networking, python.
- [transmission-cli](https://pkg.so/zh-hans/brew/transmission-cli/) - Shares pkgdb curated category or tags: bittorrent, cli, networking.
- [rtorrent](https://pkg.so/zh-hans/brew/rtorrent/) - Shares pkgdb curated category or tags: bittorrent, cli, networking.
- [checkdmarc](https://pkg.so/zh-hans/brew/checkdmarc/) - Shares pkgdb curated category or tags: cli, networking, python.
- [gdown](https://pkg.so/zh-hans/brew/gdown/) - Shares pkgdb curated category or tags: cli, networking, python.
- [geoip2fast](https://pkg.so/zh-hans/brew/geoip2fast/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, networking, python, python-3-14.
- [mktxp](https://pkg.so/zh-hans/brew/mktxp/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, networking, python, python-3-14.

## Combined YAML source

View the package source record on GitHub. [combined/torf-cli.yml](https://github.com/mxcl/pkgdb/blob/main/combined/torf-cli.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- cross-ecosystem install command graph
