The following fields are common to almost all music files.
__appThe application name: puddletag v0.10.4 depending on version number.
__bitrateThe bitrate of the file in kb/s. Note that it’s a string with kb/s appended as in ‘213 kb/s’ and not ‘213’. For Lossless formats this is always ‘0 kb/s’
__createdThe creation date of the file in YYYY-MM-DD HH:MM:SS format.
__dirpathThe path of the directory the file resides in. /media/Multimedia/Music/myfile.mp3 has __dirpath /media/Multimedia/Music/
__extExtension of the file. /media/Multimedia/Music/myfile.mp3 has extension mp3
__file_accessed_dateThe date the file was accessed in YYYY-MM-DD format
__file_accessed_datetimeThe date including the time the file was accessed in YYYY-MM-DD HH:MM:SS format
__file_accessed_datetime_rawUNIX time of the file’s last access eg. 1234567890.
__file_create_dateCreation date of the file in YYYY-MM-DD format.
__file_create_datetimeFile’s creation date in YYYY-MM-DD HH:MM:SS format.
__file_create_datetime_rawUNIX time of file creation date eg. 1234567890.
__file_mod_dateDate the file was last modified in YYYY-MM-DD format.
__file_mod_datetimeTime the file was last modified in YYYY-MM-DD HH:MM:SS format.
__file_mod_datetime_rawUNIX time of file’s last modification date.
__file_sizeThe file’s size in human-readable format.
__file_size_bytesThe file’s size in bytes.
__file_size_kbThe file’s size in KB.
__file_size_mbThe file’s size in MB (to two decimal places).
__filenameThe filename of the file with the folder stripped. e.g. the __filename of /media/Multimedia/Music/myfile.mp3 is myfile.mp3
__filename_no_extThe file’s filename without extension.
__filetypeThe format of the file. Currently the info is very sparse.
__frequencyThe sample rate of the file in kHz. Note that it’s a string with kHz appended as in ‘213 kHz’ and not ‘213’
__imageRefers to the album art present in the file.
__image_mimetypeMimeType of the first cover image in the file.
__image_sizeSize in bytes of the first cover image in the file.
__lengthThe length of the file in “minutes: seconds” format.
__length_secondsLength of the file in seconds.
__modeOne of, Mono, Stereo, Joint-Stereo or Dual Channel.
__modifiedThe last time the file was modified in YYYY-MM-DD HH:MM:SS format .
__num_imagesNumber of cover images found in the file.
__parent_dirThe name of the parent directory of the directory the file’s contained in. Cannot be written to.
__pathThe absolute filename of a file including directories. e.g /media/Multimedia/Music/myfile.mp3
__sizeThe size of the file in bytes.
__tagComma-Separated list of tags found in file. Eg. VorbisComment, ID3v2.4, ID3v1.1
__tag_readThe tag that’ll get written to in the file.
__totalIf the track field is of track/numtracks format, returns numtracks. Can also be written to.
Only available for Functions is:
__selectedHaving __selected as the field will apply the selected function to the selected cells. So if you have the album field selected in one file and artist in another. The function’ll be applied to the album field of the first file and artist of the other respectively.
Cover art can be accessed using the __image field. Use it only in Function like Remove Fields as album cannot be displayed anywhere other than the Artwork window and Extended Tags dialog.
The table below lists ID3v2.4 frames and MP4 Atoms with their respective puddletag fields. This page lists ID3 Frames and the various ways to edit them in puddletag.
Any MP4 atoms not in this list will be assumed to be freeform frames, written using ‘:com.apple.iTunes:fieldname‘ as the atom. ID3 frames not found will be written as TXXX frames of the form TXXX:fieldname frame.
| puddletag field | ID3v2.4 Frame | MP4 Atom |
|---|---|---|
| album | TALB | alb |
| albumartist | TPE2 | |
| albumsortorder | TSOA | soal |
| arranger | TPE4 | |
| artist | TPE1 | ART |
| audiodelay | TDLY | |
| audiolength | TLEN | |
| audiosize | TSIZ | |
| author | TOLY | |
| bpm | TBPM | tmpo |
| comment | COMM | cmt |
| composer | TCOM | wrt |
| conductor | TPE3 | |
| copyright | TCOP | cprt |
| date | TDAT | |
| discnumber | TPOS | |
| encodedby | TENC | too |
| encodingsettings | TSSE | |
| encodingtime | TDEN | |
| filename | TOFN | |
| fileowner | TOWN | |
| filetype | TFLT | |
| genre | TCON | gen |
| grouping | TIT1 | grp |
| initialkey | TKEY | |
| involvedpeople | TIPL | |
| isrc | TSRC | |
| itunesalbumsortorder | TSO2 | |
| itunescompilationflag | TCMP | |
| itunescomposersortorder | TSOC | |
| language | TLAN | |
| lyricist | TEXT | |
| mediatype | TMED | |
| mood | TMOO | |
| musiciancredits | TMCL | |
| organization | TPUB | |
| originalalbum | TOAL | |
| originalartist | TOPE | |
| originalreleasetime | TDOR | |
| originalyear | TORY | |
| performersortorder | TSOP | |
| popularimeter | POPM | |
| producednotice | TPRO | |
| radioowner | TRSO | |
| radiostationname | TRSN | |
| recordingdates | TRDA | |
| releasetime | TDRL | |
| setsubtitle | TSST | |
| taggingtime | TDTG | |
| time | TIME | |
| title | TIT2 | nam |
| titlesortorder | TSOT | sonm |
| track | TRCK | |
| unsyncedlyrics | USLT | |
| ufid | UFID | |
| version | TIT3 | |
| wwwartist | WOAR | |
| wwwcommercialinfo | WCOM | |
| wwwcopyright | WCOP | |
| wwwfileinfo | WOAF | |
| wwwpayment | WPAY | |
| wwwpublisher | WPUB | |
| wwwradio | WORS | |
| wwwsource | WOAS | |
| year | TDRC | day |