Jump to content


From Wikipedia, the free encyclopedia
Initial releaseJuly 13, 2008; 15 years ago (2008-07-13)[1]
Stable release2.0.1 (August 29, 2020; 3 years ago (2020-08-29)[2]) [±]
Written inPython[3]
Operating systemUnix-like
Available inEnglish, Dutch, French, German, Portuguese (Brazilian), Russian, Czech
TypeTag editor
Websitedocs.puddletag.net Edit this on Wikidata

Puddletag is a graphical audio file metadata editor ("tagger") for Unix-like operating systems.

It is free and open-source software subject to the terms of the GNU General Public License (GPL) version 3.[4] In most major desktop Linux distributions, it is available from standard package repositories. Under Arch Linux(-based ones) it can be obtained from user repositories.[5]

The user interface is modeled after the popular Windows freeware Mp3tag. It uses a spreadsheet-like layout so that all the tags a user may want to edit by hand are visible and easily editable. All the other audio taggers available for Linux take a different approach to user interface design. The interface elements can be freely arranged.

In July 2008, the first version (0.1) was released via SourceForge.[6] The website counted several thousand downloads for each release before the project finally left the platform in early 2016[7] and was included in the package sources of most major Linux distributions. Version 1.0 was released in 2012, introducing support for AcoustID.

Puddletag is written in Python and uses Qt 5 (through PyQt) for its graphical user interface. As backend it utilizes Mutagen, a Python module to handle audio metadata.


Mutagen supports ASF, FLAC, M4A, APE, MP3, MPC, Ogg Opus, Ogg FLAC, Ogg Speex, Ogg Theora, Ogg Vorbis, True Audio, WavPack, OptimFROG, and AIFF audio files. All versions of ID3v2 are supported, and all standard ID3v2.4 frames are parsed. It can read Xing headers to accurately calculate the bitrate and length of MP3s. ID3 and APEv2 tags can be edited regardless of audio format. It can also manipulate Ogg streams on an individual packet/page level.

Puddletag includes support for the following audio formats: AAC, MP4 (mp4/m4a/m4b/iTunes compatible), OGG, OptimFROG OFR, OFS, SPX, TAK, TTA, WMA, WV.

  • Batch Tag Editing. Write ID3v1.1, ID3v2.3, ID3v2.4, MPEG-4, WMA, APEv2 Tags and Vorbis comments to multiple files at once.
  • Full Unicode support
  • Support for embedded album cover art
  • Automatically creates playlists
  • Recursive subfolder support
  • User-defined field mappings
  • Remove parts of a tag or the entire tag from multiple files
  • Rename and/or move files and folders based on the tag information
  • Import tags from filenames, text files and clipboard
  • Quick search and replace text in highlighted tracks/fields without having to resort to actions
  • Format tags and filenames
  • Replace characters or words from tags and filenames
  • Regular expressions
  • Export tag information to user-defined formats (i.e. HTML, RTF, CSV, XML, TXT AND JSON)
  • Import tag information from online databases like freedb, Discogs, MusicBrainz AcoustID or Amazon (also by text-search)
  • Full AcoustID integration
  • Import tag information from local freedb databases
  • Support for ID3v2.3 (ISO-8859-1 and UTF-16) and ID3v2.4 with UTF-8
  • Automated Mass Tagging of multiple albums including the ability to enrich existing metadata using one or more metadata sources in a single operation
  • Single Album and Mass Album Tagging results can be accepted/edited/rejected at track and/or field level

See also[edit]


  • Liane M. Dubowy (2012-08-24). "Audio-Tag-Editor Puddletag mit AcoustID-Support". Heise Online (in German). Retrieved 2019-02-23.
  • Team, Addictivetips (2018-09-06). "The 5 Best MP3 Tag Editing Tools For Linux". AddictiveTips. Retrieved 2019-02-24.
  • Author: Andrew (2011-01-09). "Puddletag – Awesome mp3tag-like Editor For Linux". WebUpd8. Retrieved 2019-02-24. {{cite web}}: |last= has generic name (help)
  • Umair (2012-08-23). "Install PuddleTag Audio Tag Editor on Ubuntu or Linux Mint". Technology Linux World. Retrieved 2019-02-24.
  • "Puddletag – A Powerful Mp3 tag editor for Ubuntu Linux". Ubuntu Sharing. 2011-02-18. Retrieved 2019-02-24.

External links[edit]