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.0.5.tar.gz (SHA1 e9d44c6d8a4d4f1042ee42c153dd74c5a2611aa3).
  • 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.0.5-1_all.deb (SHA1 4d5e9e3eac52f060c4a47ef2ab63cd016ad2f006) 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.0.5-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

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 Mercurial. Use

hg clone puddletag-hg

to check it out. And

hg pull -u

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


I’ve created two plugins that might be useful. To install, unzip the downloaded file into ~/.puddletag/plugins. Then enable it in Edit->Preferences->Plugins.

Both require at least puddletag 0.10.1

Extended Tags

All does is add the Extended Tags dialog as a dockable window. Uses Ctrl+Shift+S (Tools->Save Extended) to save.

I created this with the intention of replacing the Tag Panel, but I found it way too click-heavy.

  • extended-1.2.tar.gz (SHA1 340494d0d01efde6fd416a3cb6d464440bec61fc) for puddletag 0.10.4 and later.
  • extended-1.1.tar.gz (SHA1 8694232652f538b7b9c02ed0a2c9cb8ee0a599df) for puddletag 0.10.3 and earlier.

ID3 Tools

Adds options to convert an ID3 tag to UTF-8 and to ID3v2.4 to the Plugins menu. Only works for files that have ID3 as their default tag (= mp3 files).

Download id3_tools.tar.gz (SHA1 bb01bbf0be54e1850fb4505c1d530240cab85c70).


To install, place the downloaded translation in ~/.puddletag/translations (you’ll probably need to create it). The translation will be listed in the Preferences dialog. Some if these are incomplete, so if if you’d like contribute a translation, see Translating.