使用 Homebrew, apk, apt, Nix, zypper 安装 eye-d3

项目链接

• 主页
• 仓库
• 上游文档
• 软件包管理器页面

命令和别名

• eyeD3

项目历史

The official release history starts with eyeD3 0.1.0 on 2002-07-31. Through the 0.6 series, the project accumulated practical ID3 and MP3-handling fixes: Unicode handling, ID3v1/v2 frame support, URL frames, lyrics, genre handling, safe rewrites, and command-line behavior.

Version 0.7.0 in 2012 was a larger internal shift: the command-line tool gained plugin support, the module name became the lower-case eyed3, the API was redesigned around tag properties, PyPI-friendly installation was added, and configuration-file support became part of the command-line workflow.

The 0.8 and 0.9 lines modernized the project for Python 3, GitHub development, plugin output formats, and current Python versions. The 2025 0.9.8 release lists Python 3.11, 3.12, and 3.13 support.

采用历史

eyeD3's adoption path is typical of durable Python CLI utilities: it is installable as a Python package, exposes an importable library, and is also packaged by operating-system package managers. The official README points users to PyPI-style installation and GitHub source development.

Its continued release history reflects maintenance for newer Python runtimes and real-world MP3 tag edge cases, including malformed frames, iTunes extensions, cover art, JSON/YAML output, and collection statistics.

使用方式

The default eyeD3 command edits common song fields such as artist, album, title, and track number, then displays the resulting ID3 tag. The same operations are available through Python by loading a file, mutating tag properties, and saving.

The documented feature set includes ID3 1.x, read-only ID3 2.2, ID3 2.3, ID3 2.4, MP3 audio details, plugins for display/fixup/art/stats/output formats, and custom command-line plugins.

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

eyeD3 is package-manager-friendly because it is both a Unix-style CLI and a reusable Python library. That makes it useful in scripts that batch-fix music libraries and in Python applications that need direct ID3 access.

Its long release history is a catalog of boring but valuable media-tag edge cases: encodings, malformed frames, version conversion, iTunes quirks, cover art, recursive scanning, and output formats.

时间线

• 2002: eyeD3 0.1.0 is released.
• 2012: eyeD3 0.7.0 adds plugin-oriented CLI behavior and a redesigned lower-case eyed3 module.
• 2017: eyeD3 0.8 adds Python 3 support and notes the project home on GitHub.
• 2020: eyeD3 0.9 drops Python 2.7 support and changes recursive scanning behavior.
• 2025: eyeD3 0.9.8 adds support for Python 3.11, 3.12, and 3.13.

Related projects

• ID3 is the metadata format family eyeD3 reads and writes.
• MP3 is the primary audio format exposed by eyeD3's command-line and library APIs.
• eyeD3 plugins such as classic, fixup, art, stats, JSON, YAML, and nfo form the project's extension surface.

来源

• https://eyed3.readthedocs.io/en/latest/
• https://eyed3.readthedocs.io/en/latest/history.html
• https://github.com/nicfit/eyeD3