macOS
Homebrewverified · 100%
brew install eye-d3local Homebrew formula metadata
brew
Install eye-d3 with Homebrew, apk, apt, Nix, zypper
Work with ID3 metadata in .mp3 files. Version 0.9.9 via Homebrew; verified from local package data.
install
Additional install commands
Linux
Alpine Linux apkverified · 92%
sudo apk add eyed3Alpine Linux edge package indexes · eyed3 · source: dl-cdn.alpinelinux.org
Debian aptverified · 92%
sudo apt install eyed3Debian stable package indexes · eyed3 · source: deb.debian.org
Nixverified · 92%
nix profile install nixpkgs#eyed3nixpkgs package indexes · pkgs/by-name/ey/eyed3/package.nix · source: api.github.com
openSUSE zypperverified · 92%
sudo zypper install eyeD3openSUSE Tumbleweed package metadata · eyeD3 · source: download.opensuse.org
overview
Package summary
Work with ID3 metadata in .mp3 files
Project links
Commands and aliases
- eyeD3
history
Project history and usage
eyeD3 is a Python command-line tool and library for reading and writing ID3 metadata in MP3 files. It serves both shell users editing tags and Python developers building metadata-aware audio workflows.
The project has been released since 2002 and has evolved from a straightforward tag editor into a plugin-capable CLI and importable Python package.
Project history
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.
Adoption history
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.
How it is used
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.
Why package nerds care
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.
Timeline
- 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.
Sources
security posture
Risk level: green
narrow executable package without higher-risk signals.
Risk classifier
green risk · low confidence · appliance
Why
- narrow executable package without higher-risk signals
Signals
- metadata:no-higher-risk-signals
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 1 platform targets.
- Installs with 1 runtime dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
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
Config paths the tool may read or write during local use.
- Unix
~/.eyeD3/config.ini
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
eyeD3 | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-07-08
manager version0.9.9
manager updated
local dataok
upstreamnot checked
latest detectednot detected
https://eyed3.readthedocs.io/en/latest/
- infoNo package-manager update timestamp was available.low confidence
- infoRelease/tag comparison is only available for GitHub repositories.https://eyed3.readthedocs.io/en/latest/none confidence
install metadata
Package metadata
| Package key | brew:eye-d3 |
|---|---|
| Version | 0.9.9 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/eye-d3 |
| Homepage | https://eyed3.readthedocs.io/en/latest/ |
| Repository | https://github.com/nicfit/eyeD3 |
| Upstream docs | https://eyed3.readthedocs.io/en/latest |
| License | GPL-3.0-or-later |
| Source archive | https://files.pythonhosted.org/packages/ee/aa/5873b98fa5f570724a65757987c155dea68d27f0acae17da1b1ffc8cd0d2/eyed3-0.9.9.tar.gz |
| Dependencies | python@3.14 |
| Bottle | available (on all) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | eye-d3 |
| 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 |
|
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Debian apt92%
eyed3 0.9.7-2
Display and manipulate id3-tags on the command-line
sudo apt install eyed3- Section: sound
- Architecture: all
- 2 dependencies
- installed executable or alias match
- Matched by: Eyed3
Debian apt92%
python3-eyed3 0.9.7-2
Python module for id3-tags manipulation (Python 3 version)
sudo apt install python3-eyed3- Section: python
- Architecture: all
- Source Package: eyed3
- 3 dependencies
- 3 optional deps
- installed executable or alias match
- Matched by: Eyed3
Nix92%
eyed3
nix profile install nixpkgs#eyed3- installed executable or alias match
- Matched by: Eyed3
Ubuntu apt92%
eyed3 0.9.7-1
Display and manipulate id3-tags on the command-line
sudo apt install eyed3- Section: universe/sound
- Architecture: all
- 3 dependencies
- installed executable or alias match
- Matched by: Eyed3
Ubuntu apt92%
python3-eyed3 0.9.7-1
Python module for id3-tags manipulation (Python 3 version)
sudo apt install python3-eyed3- Section: universe/python
- Architecture: all
- Source Package: eyed3
- 3 dependencies
- 3 optional deps
- installed executable or alias match
- Matched by: Eyed3
apk92%
eyed3 0.9.7-r6
ID3 tag editor in Python
sudo apk add eyed3- License: GPL-3.0-or-later
- Architecture: x86_64
- Source Package: eyed3
- 1 dependencies
- 1 provides
- installed executable or alias match
- Matched by: Eyed3
apk92%
eyed3-pyc 0.9.7-r6
Precompiled Python bytecode for eyed3
sudo apk add eyed3-pyc- License: GPL-3.0-or-later
- Architecture: x86_64
- Source Package: eyed3
- 1 dependencies
- installed executable or alias match
- Matched by: Eyed3
zypper92%
eyeD3 0.9.9-1.3
Audio files and ID3 Manipulation Tool
https://eyed3.readthedocs.io/en/latest/
sudo zypper install eyeD3- License: GPL-2.0-or-later AND GPL-3.0-only
- Category: Productivity/Multimedia/Sound/Utilities
- Architecture: noarch
- Source Package: eyeD3
- 2 dependencies
- 1 provides
- installed executable or alias match
- Matched by: Eyed3
zypper92%
python311-eyed3 0.9.9-1.3
Component library of eyeD3, an ID3 tag manipulation tool
https://eyed3.readthedocs.io/en/latest/
sudo zypper install python311-eyed3- License: GPL-2.0-or-later AND GPL-3.0-only
- Category: Productivity/Multimedia/Sound/Utilities
- Architecture: noarch
- Source Package: eyeD3
- 3 dependencies
- 3 provides
- installed executable or alias match
- Matched by: Eyed3
zypper92%
python313-eyed3 0.9.9-1.3
Component library of eyeD3, an ID3 tag manipulation tool
https://eyed3.readthedocs.io/en/latest/
sudo zypper install python313-eyed3- License: GPL-2.0-or-later AND GPL-3.0-only
- Category: Productivity/Multimedia/Sound/Utilities
- Architecture: noarch
- Source Package: eyeD3
- 3 dependencies
- 4 provides
- installed executable or alias match
- Matched by: Eyed3
zypper92%
python314-eyed3 0.9.9-1.3
Component library of eyeD3, an ID3 tag manipulation tool
https://eyed3.readthedocs.io/en/latest/
sudo zypper install python314-eyed3- License: GPL-2.0-or-later AND GPL-3.0-only
- Category: Productivity/Multimedia/Sound/Utilities
- Architecture: noarch
- Source Package: eyeD3
- 3 dependencies
- 3 provides
- installed executable or alias match
- Matched by: Eyed3
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment