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 d8b010b17e61214d30edb1008ffe1aa088cde4bd).
  • 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 fadfcb20bd10457174fd00f2e2da616f475b196d) 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 Git. Use

git clone

to check it out. And

git pull origin master

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.

  • Dutch (Nederlands) by Fabian Bakkum.
  • French by Raphaël Rochet.
  • German by Ralf Sarholz.
  • Portuguese (Brazilian) by Alan Gomes.
  • Russian by Viktor Yu. Kovalskiy.
  • Czech by Pavel Fric.