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 python-configobj
  • Now download the source tarball puddletag-1.1.1.tar.gz (SHA1 b10d39225ae84b1790126f5e4ca58ee27efa9d58).
  • 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 from the Debian package

Download the deb, puddletag_1.1.1-1_all.deb (SHA1 c7c14f556327a8a7eb859aec0f62e04d451407ff) and install by double clicking it.

If that doesn’t work, first install the dependencies by running as root:

apt-get install python-qt4 python-pyparsing python-mutagen python-configobj

Then (also as root)

dpkg -i puddletag_1.1.1-1_all.deb

puddletag should be available from your Multimedia menu.

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


  • 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.