Tree [r462] /

File Date Author Commit
 puddlestuff 2011-07-23 cpuddle [r462] [fixed] Used undefined var in previous fix.
 translations 2011-06-02 cpuddle [r450] Added French Translation, changelog. Update NEW...
 HACKING 2010-04-14 cpuddle [r125] fixed patterncombo settings editor.
 LICENSE 2011-03-07 cpuddle [r400] LICENSE
 MANIFEST 2011-06-04 cpuddle [r452] puddlestuff/masstag/
 NEWS 2011-06-07 cpuddle [r454] Version bump to 0.10.6. Update pics, etc.
 README 2011-06-02 cpuddle [r450] Added French Translation, changelog. Update NEW...
 THANKS 2011-06-04 cpuddle [r452] puddlestuff/masstag/
 TODO 2011-01-17 cpuddle [r372] puddlestuff/
 changelog 2011-06-07 cpuddle [r454] Version bump to 0.10.6. Update pics, etc.
 console 2009-10-11 cpuddle [r57] 11 October 2009
 copyright 2011-04-06 cpuddle [r420] puddlestuff/ 2011-04-30 cpuddle [r428] Added to facilitate debugging.
 logo.svg 2011-06-11 cpuddle [r455] Version bump. Multiple disc support in masstagg...
 puddletag 2011-05-23 cpuddle [r443] puddlestuff/masstag/
 puddletag.1 2011-04-29 cpuddle [r424] Masstagging changes and improvement. First draf...
 puddletag.desktop 2010-11-05 cpuddle [r315] [added] Translation support and did a slight bi...
 puddletag.png 2010-09-02 cpuddle [r241] puddlestuff/ 2011-06-02 cpuddle [r450] Added French Translation, changelog. Update NEW...
 puddletag.xpm 2011-03-07 cpuddle [r400] LICENSE 2011-04-30 cpuddle [r426] puddlestuff/masstag/ 2011-05-22 cpuddle [r441] puddlestuff/masstag/

Read Me

What it is
puddletag is a audio tag editor for GNU/Linux similar to Windows program Mp3tag ( Unlike most taggers for GNU/Linux, it uses a spreadsheet-like layout so that all the tags you want to edit by hand are visible and easily editable.

The usual tag editor features are supported like extracting tag information from filenames, renaming files based on their tags by using patterns (that you define, not crappy, uneditable ones).

Then there're Functions, which can do things like replace text, trim, change the case of tags, etc. Actions can automate repetitive tasks. You can import your QuodLibet library, lookup tags using MusicBrainz, FreeDB or Amazon (though it's only good for cover art) and more, but I've reached my comma quota.

Supported formats: ID3v1, ID3v2 (mp3), MP4 (mp4, m4a, etc.), VorbisComments (ogg, flac), Musepack (mpc), Monkey's Audio (.ape) and WavPack (wv).

Why it is
Keeping an XP partition just for Mp3tag just wasn't feasible anymore.

How it's different
To Mp3tag, not that much. It has more or less the same UI and functionality. You'll feel right at home here for the most part. However, puddletag isn't a clone, so check the skim the docs section on the puddletag website ( for more details.

What you need

    At least Python 2.5 available from
    PyQt4 (4.5 or greater) ( for the GUI.
    PyParsing (1.5.1 or greater) ( takes care of the parsing...
    Mutagen (1.20 recommended, 1.14 required) ( is used as the tagging lib and...
    ConfigObj (4.5.0 or greater) ( takes care of saving settings.

    The following are recommended
      python-musicbrainz2 (0.6.0 or better) ( for MusicBrainz support.
      QuodLibet must be installed in order to edit a QuodLibet library.


From source:

    Install the dependencies listed above.
      For Debian-based distros, run the following as root to install them aptitude install python-qt4 python-pyparsing python-mutagen python-configobj python-musicbrainz2 python-imaging
    Download the source tarball from (If this file came from that tarball, ignore everything on this line.)
    Unzip it.
    You can run puddletag from that directory by typing ./puddletag 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.

Installing from the Debian package.

    This package has been created on and for Ubuntu 10.04, but has been reported to work on Ubuntu 10.10, Sabayon and Debian Squeeze.
    Download the package from
    Install using your distros preferred method (usually double clicking should suffice). Or:
    Run as root dpkg -i /path/to/puddletag-deb.
    Install dependencies using your favourite tool.
    Run puddletag from your Multimedia menu.

Development builds are available via svn:

    svn co puddletag

puddletag licensed under the GPLv3, which you can find in its entirety at

Release usually go out about once a month. Subscribe to the RSS feed at the website if you want to be updated.

Bugs go to the issue tracker at Google Code ( Feature requests and things of general concern go on the forum ( For anything else I can be contacted via email at

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

No, thanks