eyed3
View and modify MP3 ID3 metadata tags
TLDR
View information about an MP3 file
Set the title of an MP3 file
Set the album of all the MP3 files in a directory
Set the front cover art for an MP3 file
SYNOPSIS
eyed3 [options] file(s)
PARAMETERS
--help
Display help message and exit.
--version
Display version information and exit.
--verbose
Be verbose.
--quiet
Be quiet.
--no-color
Disable color output.
--v1
Process ID3v1 tags only.
--v2
Process ID3v2 tags only.
--remove-v1
Remove ID3v1 tags.
--remove-v2
Remove ID3v2 tags.
--remove-all
Remove all ID3 tags (both v1 and v2).
--title title
Set the title tag.
--artist artist
Set the artist tag.
--album album
Set the album tag.
--track track
Set the track number tag.
--genre genre
Set the genre tag.
--year year
Set the year tag.
--comment comment
Set the comment tag.
--art image_file[:description]
Add album art from the specified image file. An optional description can be given.
DESCRIPTION
eyed3 is a command-line tool and Python library for working with ID3 tags in audio files, primarily MP3 files.
It allows users to view, edit, create, and delete ID3 metadata such as artist, title, album, track number, genre, and cover art.
eyed3 supports both ID3v1 and ID3v2 versions, offering a comprehensive solution for managing audio metadata on Linux and other platforms.
The tool is often used for batch processing of audio files to ensure consistent and accurate tagging across large music libraries.
Beyond simple tag manipulation, eyed3 can also display audio file information, including bitrate, sample rate, and duration.
The eyed3 library provides Python developers with programmatic access to its functionalities, enabling integration into custom applications and scripts for automated audio file management.
It is actively developed and widely adopted within the audio processing community. It supports a wide range of audio formats.
CAVEATS
eyed3 relies on having the appropriate dependencies installed to function correctly. In particular, handling album art may require specific image libraries.
Be cautious when batch processing files, as incorrect commands can lead to data loss.
The command might exhibit unpredictable behaviour when dealing with corrupted or non-standard ID3 tags.
RETURN CODES
eyed3 usually exits with a return code 0 when everything is ok. A non-zero return code means an error.
EXAMPLES
1. Display ID3 tag information:
eyed3 my_song.mp3
2. Set the title and artist tags:
eyed3 --title "My Song" --artist "The Artist" my_song.mp3
3. Add album art:
eyed3 --art cover.jpg:"Album Cover" my_song.mp3
4. Remove all ID3 tags:
eyed3 --remove-all my_song.mp3
HISTORY
eyed3 was created to provide a more robust and feature-rich alternative to existing ID3 tag manipulation tools.
Development has been ongoing for several years, with a focus on supporting a wide range of ID3 features and audio formats.
Originally conceived as a command-line utility, it has since evolved into a versatile Python library, enabling broader integration and customization options.
SEE ALSO
id3v2(1)