# 使用 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
- **版本:** 5.2.1
- **来源摘要:** CLI tool for creating, reading and editing torrent files
- **主页:** <https://github.com/rndusr/torf-cli>
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- torf (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 5.2.1
## 项目历史与用法

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


## 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
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph