Numbers tracks sequentially beginning with Start.
The number you enter in Max Length After Padding will pad the track with extra zeroes until it’s of the same length. Eg. if a file has track number ‘12’, having a padding of 3 will return the number ‘012’, while a padding of 1 will leave the number unchanged since it’s length is already greater than the Max Length.
Restart Numbering at each directory will restart the numbering from Start for each directory encountered. A separate count will be kept for each directory.
There are three types of case conversion: UPPER CASE,** lower case** and** Mixed Case**. Upper and lower are self-explanatory. Mixed case capitalises each word starting after the characters you specify and converts the rest to lower case.
For instance, using Mixed Case with “.” as a delineator on “this is my name. and my surname. with a dot.here and there.” will return ‘This Is My Name. And My Surname. With A Dot.Here And There.’
If your files were written using non-standard encoding (eg cp1251 on Windows) you can use this Function to fix ‘em.
Saves all artwork found in an audio file using the desired Pattern. Extensions are added automatically.
If a picture file already exists ‘_1’ will be appended to the filename (before the extension). If that file already exists ‘_2’ will be appended and so on. This will not be done for cases where two or more files contain exactly the same picture data and are to be written to the same filename.
Usage of the following fields are allowed:
The description of the current image.
The number of images contained in the file.
The number current image being processed.
The mimetype of the current image.
The image type, eg. Cover (Front).
Consider a file /mnt/music/Thebe/Ungawa Kum.mp3 containing four images. The first two PNG images and the last two JPEG. Descriptions are ‘one’, ‘two’, etc. for each image.
Formats whatever is passed to it using the Format string.
Note
Extensions are not added if you modify filename related fields using this Function.
A Format string can be (almost) any string. Eg. for a file with the tag, artist=A Guy, album=Screeching, title=Excessively Emo, track=2
Loads the filename described by the Pattern into the field specified. Note that the files complete text is loaded into that field.
For the file with path /mnt/Music/artist/album/filename.mp3 and with the tag, artist=Black Eyed Peas, album=END
Loads the artwork in filenames to the specified file.
Filenames are a colon-separated list of shell-style wildcards, eg. *.jpg;*.png. Or just something like folder.jpg. The files will be loaded in order and the images.
Default description can be any pattern, eg. %artist%.
Match Case is pretty self-explanatory.
Be aware that for now that the directory that’ll be searched will be polled every single time this Function is called, so don’t use it on large directories.
Merges the values of a multiple-valued field into a single string, separated by Separator.
eg. Say the genre field contained Rock, Rap and Reggae as distinct values. Merging them using the separator ; (semi-colon) will replace whichever field you specify with the single value Rock;Rap;Reggae.
Removes all the fields in the file (including cover art) except the ones you specify. The list of fields you specify are separated by a semi-colon (;). Any spaces around the field names are trimmed, so artist;title and ** artist; title ** are equivalent.
Removes all duplicate values in a multiple-valued field. Case sensitively or not.
Eg. if a field has the following values Rap, Rock and rap. Using this function on it (without case-sensitivity) will leave Rap and Rock as the only values.
It works just as you’d expect from any text editor. The only caveat is that words are designated by these ,.() ! characters.
Matches a regular expression. Groups can then be retrieved using $group_number (counting starts from one) eg $2.
Some examples for the text, ‘concentricpuddle writes this’.
Sorts the values in a multiple-valued field using either Ascending or Descending order. Arguments are pretty self-explanatory.
Splits the strings found into multiple values using Separator.
Works as Tag To Filename (below), but renames/moves directories instead. Directories will only be moved if the destination dir resides on the same filesystem as the source.
Converts a tag to filename using the pattern (see above description for Format value).
If the filename contains any of the characters, \*?;”|:/, then they will be removed.
Files can also be moved, by specifying ‘/’ as a directory delimeter. Any forward slashes found in the fields used in constructing the pattern are ommitted (if the artist is AC/DC, it will not create an AC directory, rather the slash will be removed and ACDC will be used).
Intermediate directories will be created if they don’t exist.
Say you had a file named ‘track.mp3’ with the following tag, artist=Before The Fame, album=The Vinyl LP, title=Sounds Better Than Anything After, track=10 and invoked this function.
For a file with the tag, artist=Relatively Unknown, title=Horrible for everyone else, album=Fans like it, track=5 with path, /home/concentricpuddle/multimedia/music/Indie/unsorted/unknown.mp3
Converts any text from any text to any other text. It’s better explained by using:
Removes any whitespace before and after text. Using it on ” there’s a space before and one after “ will return “there’s a space before and one after”
Updates the fields specified with the values found in Tag type.
If your FLAC file has an ID3 tag, puddletag will read/write only the VorbisComment tag. However sometimes you want to update the FLAC tag with the ID3 tag’s contents. Specify the Field List, select the Tag Type (ID3 or APEv2).
After invocation, the current file’s tag will then be updated using the ID3/APEv2 tag’s fields.
Note
The tag will be not be changed in any manner.