Projects / puddletag

puddletag

puddletag is a tag editor for Linux loosely based on mp3tag. It uses a table layout so that all the tags you want to edit by hand are visible and easily editable. puddletag excels at automating repetitive tasks like extracting tag information from filenames, tagging files from a text file or the clipboard, renaming or moving files and folders based on tags by using patterns, and manipulating tags using actions and regular expressions. Supported formats include id3v1, id3v2 (.mp3), AAC (.m4a), VorbisComments (.ogg, .flac), and APEv2 (.ape). Much of mp3tag's functionality has been replicated with added enhancements and tweaks.

Tags
Licenses
Operating Systems
Implementation
Translations

Recent releases

  •  05 Oct 2012 01:20

    Release Notes: This release fixes issue 189, a puddletag.desktop file installation error with the .deb file, and a Python 2.6 incompatibility. The AcoustID tag source is not loaded now if the fpcalc binary is not found.

    •  05 Oct 2012 01:19

      Release Notes: This release adds German and Russian translations, an updated .desktop file (as per issue 186), an updated icon, and options in the .desktop file which will make it possible to right-click in FM and open in puddletag. It fixes cutting tags, encoding for the genre field, filtering not working with filename fields like __filename, multiple files being selected in file-view and edited, and, when changing focus, the new cell being opened and remaining with the value as before after the change.

      •  10 Mar 2011 18:11

        Release Notes: New Cover art support for all formats (except ASF) Loading master releases in the Discogs.com tag source. For ID3 tags, UFID frames are only loaded if data can be decoded to UTF-8. MusicBrainz artist search retrieves 100 albums by default. Initial reading of a directory can be canceled now. Uncaught errors for Tag Sources shouldn't leave the Tag Sources window disabled anymore. Discogs artist/albums are parsed correctly instead of looking weird. Amazon keyword search wasn't working at all. Having periods in the Tag->Dir function were causing problems.

        •  27 Dec 2010 06:32

          Release Notes: The "Tag -> Dir" feature can move directories. Incorrectly encoded files are corrected. Selected files can be moved up or down in file-view. The MusicBrainz tag source now retrieves more fields. The Discogs.com tag source was added, including artwork. The "Select All in Dir" function supports "Select All" in the previous or next directory. Tentative support was added for Mp3tag's tag sources. Language translations were added. The "~" notation can now be used to exclude fields in function calls. Separate options were added to remove ID3v1 and ID3v2 tags. Matches optionally can be automatically retrieved using Tag Sources. Shortcuts were assigned to Actions. The default file sort order is now remembered.

          •  17 Oct 2010 06:19

            Release Notes: A host of additional features and enhancements were added.

            Recent comments

            18 Oct 2010 14:27 audiomuze

            As someone that loves music, listens constantly and is always adding to my collection by purchasing and then ripping CDs, a decent tag editor is an essential tool. I’ve been using Linux for the past seven years or so and the only drawback that I was constantly faced with was the lack of a great audio tag editor - basically a Linux based equivalent to mp3tag. After trying every Linux tagger I could get my hands on (Ex Falso, EasyTag, Pinkytagger, Jaikoz, Picard, etc. etc.) I finally settled on running mp3tag under Wine. Whilst it works, it’s still a compromise because it cannot handle case sensitivity, cannot rename folders and filenames and path lengths are limited to Windows file system restrictions. In addition, there were a number of functional enhancements and additions I wanted to see in mp3tag, but didn’t seem like they’d see the light of day.

            Enter puddletag

            In December 2009 after again being frustrated with mp3tag’s restrictions whilst tagging some albums I’d ripped I fired up Google and searched again for a Linux tagger. To cut a long story short I stumbled on puddletag…open source, coded in Python and as luck would have it, loosely based on mp3tag. Since then puddletag’s been very actively developed to not only incorporate mp3tag’s functionality, but also to add a host of features the author and I wanted to see in a tagger of choice. Today, I’d go as far as to say that puddletag’s probably the best tag editor out there, regardless of operating system.

            How is puddletag different from other Linux taggers?

            Well, for starters, if you’re familiar with mp3tag, you’re going to be right at home with puddletag…from the user interface, through to Extended Tags, Actions, regular expressions, Tag Sources etc. In addition, puddletag offers a host of functionality you’re not likely to find in a single tagger, including:

            * Retrieving tags from clipboard - why copy track data from a website, save it to a file and only then write it… pop it into the clipboard and write it from memory?
            * Fully customisable screen layout. Drag and drop windows to where you’d like them or turn them off altogether.
            * Fully customiseable Tag Panel.
            * Extended Tags view/editing including visual confirmation of what’s going to be added/ edited and/ or deleted - no more guessing what you’ve put in train…changes are colour coded according to the nature of the changes you make (distinguishing between additions, edits and deletions).
            * Drag and drop columns in main view to reorder them
            * Right click on a column header to add additional columns
            * A spreadsheet-like layout that enables selection of individual tags/cells across multiple files and performing operations on the selected tags only
            * Copy and paste any combination of tags to multiple files in a single operation
            * Quick search and replace of text across selected tags/ cells or entire tracks using Ctrl-H (no need to write an action for a quick search/ replace operation)
            * ability to see stored tags as written to file (i.e. without tagname translation) to help resolve pesky issues like ID3 and Vorbis tag types in a single file
            * ability to tag single tracks using tag sources (handy when the album you’re looking for doesn’t exist in tag sources, but the songs do exist in other albums found in tag sources (why tag by hand when you can just take track metadata from other albums)
            * easily select all tracks in a folder using a hotkey (Ctrl-Shift-S) (no more dragging the mouse cursor around and shift-clicking)
            * resize/ relocate/ close windows (configure your workspace to suit you, and puddletag will remember window locations when you reactivate them)
            * realtime results feedback when defining actions (takes the guessing out of whether an action or a function is going to do what you’re hoping it will do…you see the results an action will generate as you define it)
            * dynamically change main window font size to suit your needs
            * launch puddletag with a predefined font size designed to suit your needs
            * (optionally) dynamically size columns to match tag metadata
            * predefined and readily editable tag patterns always available to you through a pulldown menu
            * customisable hotkeys

            * Why should you have to process each album manually or be tied to your keyboard when most of the work can be automated for your later review and approval? A fundamentally different approach to using Tag Sources based on convenience, speed, accuracy, flexibility and ease of use:

            1. Ability to tag your entire library in unattended batch mode using multiple tag sources whereby you can specify which fields to retrieve from which tag sources, which tag sources take precedence, and optionally add only new metadata, thus preserving existing tags.
            2. When masstagging is completed you’re presented with the proposed changes - additions/ changes are formatted in bold whilst tags/fields that won’t change are formatted in italics. Hover your mouse cursor over a bold formatted field and the current and proposed values are shown in a tooltip.
            3. Changes can be accepted/ rejected for a single/ multiple fields and track(s).
            4. Not only that, you can edit the proposed tags, make any changes you like and then write the final results when you’re satisfied with them
            5. Easily tag individual tracks when track order differs from that provided via a Tag Source
            6. Ability to remap data retrieved from tag sources to fields of your choosing e.g. to have the Artist info retrieved from MusicBrainz written as the Performer tag, add the following to Preferences/Mappings: Tag=MusicBrainz, Source=artist,Target=performer
            7. All your tagging preferences can be saved to a tagging profile and reused at will…you can configure as many profiles as you have tagging preferences.

            I could go on and on about all the great features you’ll find in puddletag, but the best way to appreciate it is to experience it. puddletag’s homepage is http://puddletag.sourceforge.net/, download the latest build from http://sourceforge.net/projects/puddletag/files/puddletag_0.9.6-1_all.deb and refer to its documentation at http://puddletag.sourceforge.net/docs.html

            If you’re in need of any assistance or have suggestions, please post them on the puddletag forum: http://sourceforge.net/apps/phpbb/puddletag/

            17 Oct 2010 13:12 audiomuze

            puddletag 0.96 has been released and includes a host of additional features and enhancements.

            Highlights include:

            * Ability to accept/ reject changes to existing tag metadata at a track and/or field level when using Tag Sources (including Masstagging). Fields that will be changed are formatted bold and can be viewed/edited in main view, Tag Panel or Extended Tags view. Unchanged fields are shown in italics
            * Ability to remove ID3 and APEv2 tags from files that shouldn't contain these tag types.
            * Ability to toggle confirmations for Renaming Directories, Exiting Preview Mode and Deleting files.
            * Ability to rename folders via an action specifying a value for the __dirname field.
            * Support for UFID frames for ID3v2 Tags.
            * Monkey's Audio File's are now fully supported.
            * The Actions and Functions dialogs can now be tool windows too (See Windows Menu).
            * Actions and Functions now operate and write multiple-valued fields.
            * Two new scripting functions copied straight from Mp3tag: $meta_sep and $meta. See the Scripting page for details.

            Numerous new functions that can be used on a standalone basis or used in actions. These include ability to:

            * import text file to field
            * embed artwork
            * merge fields
            * remove specified fields
            * remove ALL BUT specified fields
            * remove duplicate values in a field
            * sort multivalue fields (ascending, descending and with or without case sensitivity)
            * rename file using tag values

            See the Functions page for a detailed listing and description of each.

            All documentation has been updated. If you're in need of any assistance or have suggestions, please post them on the puddletag forum.

            Last, but not least, puddletag can now be downloaded as a .deb file meaning installation on Debian based Linux systems is as simple as double-clicking on the file to get it and all dependencies installed. In Ubuntu it will appear in the Applications/Sound & Video menu.

            16 Sep 2010 04:47 audiomuze

            With Masstagging now complete and fully operational we've shifted out focus to enhancing under the hood functionality. Work is currently underway to include the following capabilities within puddletag:

            Removing incorrect tag types
            puddletag will enable you to consolidate metadata from various tag types, remove incorrect tag types and rewrite the consolidated metadata using the correct tag type e.g. a FLAC file containing ID3v2 and Vorbis tags will yield consolidated tag metadata and the ID3v2 tags will be removed, without duplicating metadata.

            Splitting, merging and de-duping tags
            You will be able to merge, split and/or de-duplicate tag metadata e.g. if you have a genre tag as follows: genre=Rock\\Hard Rock\\Rock :
            Split tags: genre=Rock, genre=Hard Rock
            Merge tags: genre=Rock\\Hard Rock

            De-duplication will occur automatically when merging or splitting tags.

            Other functions you'll be able to use in Actions include: adding/ saving artwork to disc; removing specified fields/tags and removing all tags/fields EXCEPT those you stipulate.

            20 Jul 2010 20:42 audiomuze

            Just a quick update regarding upcoming features:

            Masstagging and tag source combining is now in unit testing. Once this is released you will be able to batch tag a directory tree simply by loading it into puddletag and telling it to get going with masstagging.

            puddletag will then do its best to figure out the artist/album in each folder (yes, it does assume each album resides in a folder of its own) and retrieve and combine tags from the tag source(s) you specify. For puddletag to figure out artist/album for masstagging, puddletag will consult existing tags first, then, if necessary, foldername, and finally FreeDB (if you use FreeDB) - in effect this means that if you have meaningful foldernames or make use of freedb, there's a good chance puddltag will find the correct album metadata without a single tag being present in any of the tracks.

            When combining tags you'll be able to merge and/or replace tag data retrieved from multiple tag sources and you're also able to specify what tag data you want retrieved from which tag source. This way you'll be able to source specific tags from specific tag sources.

            14 Jul 2010 19:55 audiomuze

            Whilst puddletag is loosely based on mp3tag (and incorporates most of the functionality available in mp3tag) it also incorporates many enhancements we wanted to see and allows efficient tag handling in ways not possible with most editors we'd tried.
            Examples include:

            * a spreadsheet-like layout that enables selection of individual tags/cells across multiple files and performing operations on the selected tags only
            * copying selected tag(s) from one track to many tracks in a single operation
            * quick search and replace of text across selected tags/ cells or entire tracks using Ctrl-H (no need to write an action for a quick search/ replace operation)
            * extended tags view that uses colour feedback to show you what will be added, altered and edited on hitting OK
            * ability to see stored tags as written to file (i.e. without tagname translation) to help resolve pesky issues like id3 and vorbis tag types in a single file
            * ability to tag single tracks using tag sources (handy when the album you're looking for doesn't exist in tag sources, but the songs do exist in other albums found in tag sources (why tag by hand when you can just take track metadata from other albums)
            * ability to include/ exclude specific tags from tag sources
            * easily select all tracks in a folder using a hotkey (Ctrl-Shift-S) (no more dragging the mouse cursor around and shift-clicking)
            * resize/relocate/close windows (configure your workspace to suit you)
            * realtime results feedback when defining actions (so you can see the results an action will generate as you define it)
            * importing tags from clipboard (in much the same way one would from text file (why copy track data from a website, save it to a file and only then write it... pop it into the clipboard and write it from memory)
            * dynamically change main window font size to suit your needs
            * launch puddletag with a predefined font size
            * (optionally) dynamically size columns to match tag metadata
            * drag and drop tag columns in main view to reorder them
            * predefined and readily editable tag patterns always available to you through a pulldown menu
            * customisable hotkeys
            * ability to import and edit tags directly in the QuodLibet library

            Last, but not least, puddletag's been developed using Python and is free as in free by being licencsed under GPLv2.

            Screenshot

            Project Spotlight

            OpenStack4j

            A Fluent OpenStack client API for Java.

            Screenshot

            Project Spotlight

            TurnKey TWiki Appliance

            A TWiki appliance that is easy to use and lightweight.