Easy Installation

Install using ‘pip’

pip is a tool for installing Python packages from Python Package Index and is a replacement for easy_install. It will install the package using the first ‘python’ in your path so it is especially useful when used along with virtualenv, otherwise root access may be required.

$ pip install eyeD3
# Optional: To install the ultra powerful Display plugin (-P display)
$ pip install eyeD3[display-plugin]


eyeD3 0.8 has been tested with Python 2.7, >=3.3 (see the 0.7.x series for Python 2.6 support).

The primary interface for building and installing is Setuptools. For example, python install.

Development Dependencies

If you are interested in doing development work on eyeD3 (or even just running the test suite), you may also need to install some additional packages:

$ pip install -r requirements/test.txt $ pip install -r requirements/dev.txt

Download Source Archive

Source packages are available from the release archive in tar.gz and zip formats. After un-archiving the distribution file you can install in the common manner:

$ tar xzf eyeD3-X.Y.Z.tar.gz
$ cd eyeD3-X.Y.Z
# This may require root access
$ python install

Or you can run from the archive directory directly:

$ tar xzf eyeD3-X.Y.Z.tar.gz
$ cd eyeD3-X.Y.Z
$ python build
$ export PYTHONPATH=`pwd`/build/lib
$ export PATH=${PATH}:`pwd`/bin

Checking Out the Source Code

$ git clone


When submitting patches please base them on the ‘master’ branch.