puddletag requires the following dependencies. Visit the respective project’s page if you having trouble installing a component.

Install instructions follow below.

Installing from source

Install the dependencies as listed above. For Debian-based distros, you can run the following as root:

apt-get install python-qt4 python-pyparsing python-mutagen
  • Now download the source tarball puddletag-1.2.0.tar.gz (SHA1 255239ba572809d37caa14ad26c9ea8806c9fde0).
  • Unzip it.
  • You can run puddletag from that directory by typing ./puddletag from the unzipped directory in your console.
  • Alternatively install it by running python install as root in the unzipped directory.
  • puddletag should appear in your Multimedia (or Sounds etc.) menu. If not run desktop-file-install puddletag.desktop as root in the unzipped directory.


For AcoustID support in Ubuntu you will also need to fpcalc binary For Ubuntu 12.04 and later it is available in the libchromaprint-tools package.

For earlier versions and other distros please visit the AcoustID page for installation instructions.

Installing on Ubuntu

You can install puddletag from the Software Centre in recent versions of Ubuntu.

A Debian package is no longer provided, because of the complexity of generating a deb for different Ubuntu versions.

If you prefer using the latest version, WebUpd8 provide puddletag packages in their PPA.

Installing on Fedora 14 and later

Just run (as root):

yum install puddletag

Sometimes the latest version is still in the testing repo. Then you should use (also as root:)

yum --enablerepo=updates-testing install

Installing on OSX


The below section is outdated as Homebrew doesn’t support PyQt4 anymore and the Vortexbox links are broken. If you have further instructions on how to fix these, add an issue on GitHub.


  • Install the package manager from
  • Download and install puddletag by typing “brew install puddletag” in your console

From source

There’s a great article on the VortexBox wiki detailing the steps you need to follow.

You can also use Fink as reported by wgscott on the forum.

Development builds

Source control is done using Git. Use

git clone

to check it out. And

git pull origin master

in the previously cloned directory to update it a later stage.