LinuxCommandLibrary

eyed3

View and modify MP3 ID3 metadata tags

TLDR

View information about an MP3 file

$ eyeD3 [filename.mp3]
copy

Set the title of an MP3 file
$ eyeD3 --title "[A Title]" [filename.mp3]
copy

Set the album of all the MP3 files in a directory
$ eyeD3 --album "[Album Name]" [*.mp3]
copy

Set the front cover art for an MP3 file
$ eyeD3 --add-image [front_cover.jpeg]:FRONT_COVER: [filename.mp3]
copy

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)

Copied to clipboard