# 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 ```sh sudo av install brew:eye-d3 ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install eye-d3 ``` Evidence: local Homebrew formula metadata ### Linux - apk (92%): ```sh sudo apk add eyed3 ``` Evidence: Alpine Linux edge package indexes: eyed3 from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Debian apt (92%): ```sh sudo apt install eyed3 ``` Evidence: Debian stable package indexes: eyed3 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - Nix (92%): ```sh nix profile install nixpkgs#eyed3 ``` Evidence: nixpkgs package indexes: pkgs/by-name/ey/eyed3/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - zypper (92%): ```sh sudo zypper install eyeD3 ``` Evidence: openSUSE Tumbleweed package metadata: eyeD3 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ## Package facts - **Package key:** brew:eye-d3 - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.9.9 - **Source summary:** Work with ID3 metadata in .mp3 files - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-3.0-or-later - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - eyeD3 (cli) - eyeD3 (alias) ## Dependencies - python@3.14 ## Install behavior - Post-install hook: not defined - Bottle: available on all ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.9.9 - Local data: ok - Upstream repository: https://eyed3.readthedocs.io/en/latest/ - info: No package-manager update timestamp was available. - info: Release/tag comparison is only available for GitHub repositories. ## 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 Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## 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: ~/.eyeD3/config.ini ## 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:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Debian apt - eyed3 - 0.9.7-2: installed executable or alias match | Debian stable package indexes: eyed3 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Display and manipulate id3-tags on the command-line | http://eyed3.nicfit.net/ - Debian apt - python3-eyed3 - 0.9.7-2: installed executable or alias match | Debian stable package indexes: python3-eyed3 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Python module for id3-tags manipulation (Python 3 version) | http://eyed3.nicfit.net/ - Nix - eyed3: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/ey/eyed3/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - eyed3 - 0.9.7-1: installed executable or alias match | Ubuntu 24.04 LTS package indexes: eyed3 from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Display and manipulate id3-tags on the command-line | http://eyed3.nicfit.net/ - Ubuntu apt - python3-eyed3 - 0.9.7-1: installed executable or alias match | Ubuntu 24.04 LTS package indexes: python3-eyed3 from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Python module for id3-tags manipulation (Python 3 version) | http://eyed3.nicfit.net/ - apk - eyed3 - 0.9.7-r6: installed executable or alias match | Alpine Linux edge package indexes: eyed3 from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | ID3 tag editor in Python | https://eyed3.nicfit.net/ - apk - eyed3-pyc - 0.9.7-r6: installed executable or alias match | Alpine Linux edge package indexes: eyed3-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for eyed3 | https://eyed3.nicfit.net/ - zypper - eyeD3 - 0.9.9-1.3: installed executable or alias match | openSUSE Tumbleweed package metadata: eyeD3 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Audio files and ID3 Manipulation Tool | https://eyed3.readthedocs.io/en/latest/ - zypper - python311-eyed3 - 0.9.9-1.3: installed executable or alias match | openSUSE Tumbleweed package metadata: python311-eyed3 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Component library of eyeD3, an ID3 tag manipulation tool | https://eyed3.readthedocs.io/en/latest/ - zypper - python313-eyed3 - 0.9.9-1.3: installed executable or alias match | openSUSE Tumbleweed package metadata: python313-eyed3 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Component library of eyeD3, an ID3 tag manipulation tool | https://eyed3.readthedocs.io/en/latest/ - zypper - python314-eyed3 - 0.9.9-1.3: installed executable or alias match | openSUSE Tumbleweed package metadata: python314-eyed3 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Component library of eyeD3, an ID3 tag manipulation tool | https://eyed3.readthedocs.io/en/latest/ ## Related links - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Media and graphics packages](https://www.automicvault.com/pkg/media-graphics-tools/) - Matched media, image, audio, video, or graphics metadata. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [abcde](https://www.automicvault.com/pkg/brew/abcde/) - Popular package that depends on this formula. - [id3lib](https://www.automicvault.com/pkg/brew/id3lib/) - Shares av.db curated category or tags: cli, id3, media, mp3. - [id3v2](https://www.automicvault.com/pkg/brew/id3v2/) - Shares av.db curated category or tags: cli, id3, media, mp3. - [mp3info](https://www.automicvault.com/pkg/brew/mp3info/) - Shares av.db curated category or tags: cli, id3, media, mp3. - [mp3unicode](https://www.automicvault.com/pkg/brew/mp3unicode/) - Shares av.db curated category or tags: cli, id3, media, mp3. - [taglib](https://www.automicvault.com/pkg/brew/taglib/) - Shares av.db curated category or tags: cli, id3, media, mp3. - [bandcamp-dl](https://www.automicvault.com/pkg/brew/bandcamp-dl/) - Shares av.db curated category or tags: cli, media, python. - [clamz](https://www.automicvault.com/pkg/brew/clamz/) - Shares av.db curated category or tags: cli, media, mp3. - [pdfly](https://www.automicvault.com/pkg/brew/pdfly/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, files, media, metadata, python. ## Combined YAML source View the package source record on GitHub. [combined/eye-d3.yml](https://github.com/automic-vault/db/blob/main/combined/eye-d3.yml) ## Sources - Nucleus package database - Geiger risk classifier - 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