Imports a folder into puddletag. All files with supported/valid tags are read. Reading subfolders is turned off by default (use the Preferences dialog to enable).
Works as Open Folder, but instead of replacing the File-Views’s contents, appends the newly loaded files.
Opens a dialog to import an m3u playlist into puddletag.
Save’s the contents of the File_view to a playlist. The format to write for the extended info can be set in Preferences.
Save’s whatever’s currently entered in the Tag Panel to the selected files. Be aware if previews have been enabled (for eg. via tag sources) then nothing will get written. Only the preview will get updated.
Play’s the currently selected files using the player defined in Preferences.
Deletes the selected files permanently.
Deletes the selected files permanently, but doesn’t even bother confirming first.
Refreshes the files currently loaded in the File-View. If any directories are loaded, they’ll be re-read and checked for new files.
Clear’s the File-View and unloads any files/directories that have been imported.
Undo’s the last edit. Note that the undo history is cleared when a new folder is imported using Open Folder and some things like deleting files cannot be undone.
Open’s the Extended Tags Dialog. With it you can edit/see all the supported fields in a file.
Shows the first selected file’s format information like filetype, version, etc.
Works like Copy Selection, but removes the selected fields.
Copies the selected cells to the clipboard.
Copies the complete tag of the selected files. Note that only supported fields (I’m looking at you ID3) are copied.
Pastes the copied/cut fields onto the selected files. If you have more files selected than the number of tags copied, then the pasting restarts from the first tag copied. E.g say you copied the artist and title fields of ten files before.
Works just like Paste, but with an important caveat. The tags you copied will be pasted onto the selected cells. If, for example, you’d copied the artist and album fields of a single file before, but now have the title and originalartist fields selected. The copied value in artist field will get to written to the title field and the copied album value will get written to the originalartist field.
The same rules apply as with Paste, but the pasting isn’t restarted for individual files. ie. If you’ve copied two fields before, but have four cells selected. The values will only get written to the first two selected cells.
Removes the tags of selected files. Note that although this operation can be undone, the tag is not restored as it was before. A new one will be created only supported fields be restored.
Select a file. Invoke this menu item. All the files with the same __dirpath will be selected. Invoke this menu item again, then puddletag will pick the first file (going down in the File-View) with a different __dirpath to those selected and select all files with that __dirpath.
If you have multiple files with differing __dirpaths selected then puddletag will select all the files belonging to those __dirpaths. It will not do anything if you invoke this menu item again though.
Does what the previous menu item does except it checks for the first differing file by going up in the File-View.
Selects all the cells that aren’t currently selected. Deselects those that are.
Select’s the column of whichever cell you last selected.
It’s obvious if you think about it.
Moves the selected files up one row in the File-View.
Moves the selected files down one row in the File-View.
Increases the File-View font.
Increases the File-View font, but in reverse.
Opens the Preferences dialog.
Convert the selected files to tags using the pattern in the Pattern Combo. Some examples:
Directory names are delimited with the forward slash (‘/’) character.
Applies the Format Value function to the selected files using the pattern in the Pattern Combo.
Be careful if you have a filename cell selected, because the file will be renamed using the Pattern Combo’s pattern without preserving extensions. So using the %artist% - %title% pattern as before will result in the file being renamed to ‘Before The Fame - Sounds Better Than Anything After’ (<- note the absence of an extension).
Renames the selected files’ directories based on the pattern in Pattern Combo.
It’s also a shortcut for Tag->Dir.
Asks you to open a Text File with which you can then use patterns to extract tags.
Uses the same dialog as Text File->Tag, but preloaded with text from the clipboard.
Opens the actions dialog, with which you can edit actions. Briefly described in Tutorial 2.
Opens the Quick Actions dialog. Quick Actions differ from Actions in that all the functions in an action is applied to the selected cells.
Eg. If you have an action that converts the artist, album and title fields to Mixed Case. Now you want to apply that action to the originalartist and band fields. All you have to do is select the originalartist and band fields in the File-View, apply the Quick Action and the action will be applied to each field respectively.
Opens a dialog allowing to automatically number tracks in a sequence. It’s pretty self explanatory.
Output field: Instead of writing to the track field you can write the sequency to any non-file (ie. filename, path, etc) field.
Group tracks using pattern: Enter a pattern to group the tracks by.
Increase counter only on group change: If checked, the counter will only be increased when the group changes.
Eg if you split the tracks by %__dirpath% and output field %discnumber%. The discnumber field in each folder will be the same, increasing for each folder.
All tracks in the first folder will have discnumber=1. All tracks in folder 2 will have discnumber=2 and so on.
Open’s a dialog to allow you to import a supported Music Library into puddletag to edit its tags. Only QuodLibet is supported for now.
Enables/Disables preview mode. When enabled any changes you make will not get written. Instead any values you change that differ from the original will be shown as emboldened text in the File-View and Extended Tags dialog. Values that you’ve changed, but are the same as the underlying value will be shown in italics.
Use Write Previews to save the changes to file.
Deleting tags is not allowed from within Preview Mode.
If you’ve cleared any previews (but not exited Preview Mode), the last one will be undone.
If preview mode has been enabled and some changes were made, they’ll get written to the files.
Clears the selected files’ previews.
Clears the selected cells’ previews.
Please note that if you delete a tag not considered the ‘official’ tag (eg. When you delete APEv2 from and mp3 file) there’ll be no way to undo that action. Deleting ‘official’ tags can be undone though. And by undo, I don’t mean the tag will be restored as before. A new tag will be created with the fields puddletag remembers.
Removes the APEv2 Tags in the selected files if present. Undoable for files that use APEv2 as the default tag (ie. Musepack, Wavpack and Monkey’s Audio).
Removes any ID3 tags found in the selected files. Undoable only for mp3 files.
Removes the ID3v2 tag from the selected files. Undoable only for mp3 files.
Removes the ID3v1 tag from the selected files. Undoable only for mp3 files.
Select some files, fill in some text and save the changes (File->Save). Configure the fields in Edit->Preferences->Tag Panel.
Displays the filesystem window which lists directories. Right click on a directory and click on Refresh to refresh it. Also in that context menu, Show Header will show the Filesystem header which displays extra info.
The Stored Tags dialog displays the Tags of the currently selected files as stored on disk. Useful for when you have previews and want to see the underlying tags.
Note that the files are reloaded each time the selection changes. This almost always has a performance penalty associated with it.
Currently displays extra info from Tag Sources.
Shows/Hides the Logs dialog. Currently shows debugging information for Tag Sources. Will be expanded to include more information in future.
Shows the Functions dialog as a tool window. Click Apply to apply changes to the selected files.
Shows the Actions dialog as a tool window. Click Apply to apply changes to the selected files.