# 使用 Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper 安装 beets

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

## 安装

```sh
sudo av install brew:beets
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install beets
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install beets
```

  证据: MacPorts ports tree: audio/beets/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add beets
```

  证据: Alpine Linux edge package indexes: beets from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install beets
```

  证据: Debian stable package indexes: beets from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install beets
```

  证据: Fedora Rawhide package metadata: beets from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#beets
```

  证据: nixpkgs package indexes: pkgs/by-name/be/beets/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S beets
```

  证据: Arch Linux sync databases: beets from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install beets
```

  证据: openSUSE Tumbleweed package metadata: beets from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

## 软件包事实

- **软件包键:** brew:beets
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/beets>
- **版本:** 2.12.0
- **来源摘要:** Music library manager and tagger
- **主页:** <https://beets.io/>
- **仓库:** <https://github.com/beetbox/beets>
- **上游文档:** <https://beets.readthedocs.io/>
- **许可证:** MIT
- **源码归档:** <https://files.pythonhosted.org/packages/1c/40/056537114e0c6df4374371341301c74b8519b571f3e67ec64f5547479a16/beets-2.12.0.tar.gz>
- **最后更新:** 2026-07-12T13:05:05-07:00
- **已生成:** 2026-07-25T07:20:51+00:00

## 可执行文件

- beet (cli)
- beet (别名)

## 依赖

- certifi
- libyaml
- llvm
- numpy
- python@3.14
- scipy
- zstd

## 构建依赖

- cmake
- cython
- python-setuptools
- rust

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-07-25
- 管理器版本: 2.12.0
- 管理器更新时间: 2026-07-12
- 本地数据: OK
- 上游仓库: https://beets.io/
- 信息: Release/tag comparison is only available for GitHub repositories.
## 项目历史与用法

beets is a Python command-line music library manager and MusicBrainz tagger for users who want a curated, queryable, correctly tagged local music collection.

### 项目历史

beets was created by Adrian Sampson and the GitHub repository was opened in August 2010. The project describes itself as a media library management system for obsessive music users, with automatic metadata improvement as the core import workflow.

The changelog records the early beta series beginning with 1.0b1 on June 17, 2010, followed by many beta releases and two release candidates before 1.0.0 shipped on January 29, 2013.

The 1.0 release marked beets as stable while new development continued. The plugin system became central to the project's identity, with plugins for album art, lyrics, ReplayGain, acoustic fingerprints, transcoding, duplicates, web access, MPD, and several metadata sources.

The project reached 2.0.0 in May 2024 and continued active 2.x releases through 2026, including 2.12.0 in June 2026.

### 采用历史

The supplied package metadata lists beets across Alpine, Homebrew, Debian, Fedora, MacPorts, Nix, Arch, Ubuntu, and openSUSE package names. The README also notes PyPI installation and distribution repository packaging.

beets adoption grew around the MusicBrainz-centered local-music workflow: import files, correct tags, move or copy into a library layout, then query and manipulate the collection through the beet CLI and plugins.

### 使用方式

The standard workflow is beet import followed by interactive metadata matching, file organization, and database-backed querying. Users customize behavior with config.yaml, path templates, plugins, and metadata-source credentials where individual plugins require them.

beets is especially useful for large local music collections because it combines tagging, library layout, duplicate checks, album art, lyrics, ReplayGain, transcoding, and scripting-friendly command-line access.

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

beets is package-nerd significant because it is one of the enduring examples of a personal-data CLI that wraps a rich Python application, a SQLite-ish local library model, a plugin ecosystem, external metadata services, and distro packaging into one command called beet.

It sits at the intersection of package managers and hobbyist media preservation: PyPI, Linux distributions, Homebrew, and Nix all carry it because music-library users want the same tool available on servers, laptops, and long-lived archival machines.

For CLI collectors, beets also has the satisfying trait of turning messy filesystem culture into explicit configuration: tags, templates, metadata sources, plugins, and output paths are all package-managed and scriptable.

### 时间线

- 2010: 1.0b1 released and GitHub repository created.
- 2013: 1.0.0 released after fifteen betas and two release candidates.
- 2024: 2.0.0 released.
- 2026: 2.12.0 released.

### Related projects

- MusicBrainz is the central metadata source named throughout beets' documentation and README.
- Discogs, Beatport, ReplayGain, MPD, and acoustic-fingerprint tooling are related services or workflows exposed through plugins.
- Picard is a related MusicBrainz-oriented tagger, while beets occupies the scriptable command-line library-manager niche.

### 来源

- <https://api.github.com/repos/beetbox/beets>
- <https://beets.readthedocs.io/en/stable/changelog.html>
- <https://beets.readthedocs.io/en/stable/reference/config.html>
- <https://github.com/beetbox/beets#readme>
- <https://github.com/beetbox/beets/releases>
- source_facts.package-manager


## 安全说明

没有找到 beets 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.config/beets/config.yaml
- Windows: %APPDATA%\beets\config.yaml, C:\Users\You\AppData\Roaming\beets\config.yaml, macos?
## 源数据库详情

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

## 其他软件包管理器记录

- Debian apt - beets - 2.2.0-3: normalized package name match | Debian stable package indexes: beets from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | music tagger and library organizer | https://beets.io/
- Debian apt - beets-doc - 2.2.0-3: normalized package name match | Debian stable package indexes: beets-doc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | music tagger and library organizer - documentation | https://beets.io/
- Nix - beets: normalized package name match | nixpkgs package indexes: pkgs/by-name/be/beets/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - beets - 1.6.0-8: normalized package name match | Ubuntu 24.04 LTS package indexes: beets from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | music tagger and library organizer | https://beets.io/
- Ubuntu apt - beets-doc - 1.6.0-8: normalized package name match | Ubuntu 24.04 LTS package indexes: beets-doc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | music tagger and library organizer - documentation | https://beets.io/
- apk - beets - 2.11.0-r1: normalized package name match | Alpine Linux edge package indexes: beets from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Music library manager and MusicBrainz tagger | https://beets.io
- apk - beets-doc - 2.11.0-r1: normalized package name match | Alpine Linux edge package indexes: beets-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Music library manager and MusicBrainz tagger (documentation) | https://beets.io
- apk - beets-pyc - 2.11.0-r1: normalized package name match | Alpine Linux edge package indexes: beets-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for beets | https://beets.io
- apk - beets-zsh-completion - 2.11.0-r1: normalized package name match | Alpine Linux edge package indexes: beets-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh completions for beets | https://beets.io
- dnf - beets - 2.11.0-3.fc45: normalized package name match | Fedora Rawhide package metadata: beets from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Music library manager and MusicBrainz tagger | http://pypi.org/project/beets/
- dnf - beets-doc - 2.11.0-3.fc45: normalized package name match | Fedora Rawhide package metadata: beets-doc from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Documentation for beets | http://pypi.org/project/beets/
- pacman - beets - 2.11.0-1: normalized package name match | Arch Linux sync databases: beets from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Flexible music library manager and tagger | https://beets.io/
- zypper - beets - 2.11.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: beets from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Music tagger and library organizer | http://beets.io/
- MacPorts - beets: normalized package name match | MacPorts ports tree: audio/beets/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## 相关链接

- [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/zh-hans/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Media and graphics packages](https://www.automicvault.com/zh-hans/pkg/media-graphics-tools/) - Matched media, image, audio, video, or graphics metadata.
- [Homebrew utility packages](https://www.automicvault.com/zh-hans/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [llvm](https://www.automicvault.com/zh-hans/pkg/brew/llvm/) - Runtime dependency declared by Homebrew.
- [numpy](https://www.automicvault.com/zh-hans/pkg/brew/numpy/) - Runtime dependency declared by Homebrew.
- [python@3.14](https://www.automicvault.com/zh-hans/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [zstd](https://www.automicvault.com/zh-hans/pkg/brew/zstd/) - Runtime dependency declared by Homebrew.
- [cmake](https://www.automicvault.com/zh-hans/pkg/brew/cmake/) - Build dependency declared by Homebrew.
- [cython](https://www.automicvault.com/zh-hans/pkg/brew/cython/) - Build dependency declared by Homebrew.
- [rust](https://www.automicvault.com/zh-hans/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [flactag](https://www.automicvault.com/zh-hans/pkg/brew/flactag/) - Shares av.db curated category or tags: cli, media, metadata, musicbrainz, tagging.
- [cd-discid](https://www.automicvault.com/zh-hans/pkg/brew/cd-discid/) - Shares av.db curated category or tags: cli, media, metadata, musicbrainz.
- [glyr](https://www.automicvault.com/zh-hans/pkg/brew/glyr/) - Shares av.db curated category or tags: cli, media, metadata, music.
- [rsgain](https://www.automicvault.com/zh-hans/pkg/brew/rsgain/) - Shares av.db curated category or tags: cli, media, metadata, tagging.
- [sacad](https://www.automicvault.com/zh-hans/pkg/brew/sacad/) - Shares av.db curated category or tags: cli, media, metadata, music.
- [abcde](https://www.automicvault.com/zh-hans/pkg/brew/abcde/) - Shares av.db curated category or tags: cli, media, musicbrainz.
- [atomicparsley](https://www.automicvault.com/zh-hans/pkg/brew/atomicparsley/) - Shares av.db curated category or tags: cli, media, metadata.
- [aubio](https://www.automicvault.com/zh-hans/pkg/brew/aubio/) - Shares av.db curated category or tags: cli, media, music.
- [bandcamp-dl](https://www.automicvault.com/zh-hans/pkg/brew/bandcamp-dl/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, media, music, python.

## Combined YAML source

View the package source record on GitHub. [combined/beets.yml](https://github.com/automic-vault/db/blob/main/combined/beets.yml)


## 来源

- Nucleus package database
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
