Magic File Renamer Help


Rename List Fields

These fields can be shown as columns in the Rename List. Use Select fields… to choose visible columns. Many fields also appear as formatting tokens - see Formatting Tokens.

+ in the Write column means you can change the field. Empty means read-only.

Audio Group

Audio Tag

Everyday tags such as title, artist, and album. They work across common audio formats, not only one tag type.

Matching tokens are under Audio Tag formatting tokens. For one tag type only, use ID3v1, ID3v2, or Xiph.

Field Write Description
Album + Album / release title.
Album Artist + Album-level credit (compilations / Various Artists). Distinct from Artist. Multiple values joined with ;.
Album Artist (first) First Album Artist value before ;.
Artist + Track performers. Multiple values joined with ;.
Artist (first) First Artist value before ;.
ASIN + Amazon Standard Identification Number.
BPM + Tempo in beats per minute.
Comment + Free-text comment / notes.
Composer + Composer(s). Multiple values joined with ;.
Composer (first) First Composer value before ;.
Conductor + Conductor or musical director.
Copyright + Copyright notice for the recording or release.
Disc + Disc number in a multi-disc set.
Disc Count + Total number of discs in a multi-disc set.
Genre + Genre. Multiple values joined with ;.
Genre (first) First Genre value before ;.
Grouping + Content group / work set.
Lyrics + Song lyrics text.
MusicBrainz Album Artist Id + MusicBrainz release artist (album artist) UUID.
MusicBrainz Album Id + MusicBrainz release (album) UUID.
MusicBrainz Album Release Country + MusicBrainz release country code.
MusicBrainz Album Status + MusicBrainz release status (e.g. official, promotion).
MusicBrainz Album Type + MusicBrainz release type (e.g. album, single, EP).
MusicBrainz Artist Id + MusicBrainz artist UUID.
MusicBrainz Disc Id + MusicBrainz disc ID (TOC fingerprint).
MusicBrainz Track Id + MusicBrainz recording / track UUID.
MusicIP PUID + MusicIP acoustic fingerprint PUID.
Tag Types Present tag blocks (e.g. Id3v2;Xiph).
Title + Track title.
Track + Track number within the album (or disc).
Track Count + Total number of tracks on the album (or disc).
Year + Release or recording year.

ID3v1

ID3v1 columns on MP3 files. Everyday title / artist / album still uses Audio Tag.

ID3v2

ID3v2 columns on MP3 files. Everyday title / artist / album still uses Audio Tag.

Xiph

Xiph comment columns on FLAC, Ogg, and Opus files. Everyday title / artist / album still uses Audio Tag.

MP3 Properties

Read-only MPEG audio-header properties for MP3 files. See MP3 Properties formatting tokens.

Field Write Description
Bitrate MPEG header bitrate.
VBR Whether the stream is VBR / encoding flag.
Frequency Sample rate in Hz (MPEG header).
Duration MPEG header duration as h:mm:ss.
Duration (Seconds) Same MPEG header duration as a whole-second number.
Layer MPEG audio layer (I / II / III).
Level MPEG version (e.g. Version 1).
Mode Channel mode.
Copyright MPEG header copyright bit - not the audio-tag Copyright text.
Original MPEG header original/copy bit.
Protection MPEG header CRC protection bit.

Document Group

PDF Document

Read-only PDF Info dictionary fields and page count. See PDF Document tokens.

Field Write Description
Title PDF Info Title.
Author Document author from the PDF Info dictionary.
Subject PDF Info Subject.
Keywords PDF Info Keywords.
Creator Application that created the original document before it was converted to PDF.
Producer Application that produced/converted this PDF file.
Created PDF Info CreationDate.
Modified PDF Info ModDate.
Page Count Number of pages.

EPUB Document

Read-only EPUB package fields. See EPUB Document tokens.

Field Write Description
Title Title.
Creator Creator / author (person or organization), not a creating application.
Publisher Publisher.
Language Language.
Date Date (as stored).
Identifier Package unique-identifier when set; otherwise the first non-blank identifier.
Subject Subject.
Description First non-blank description from the EPUB package.

Office Document

Read-only Office document fields for readable DOCX, XLSX, and PPTX files. See Office Document tokens.

Field Write Description
Title Document title.
Author Document author, not a creating application.
Subject Document subject.
Keywords Keywords.
Category Document category.
Description Document description.
Last Modified By Name of the user who last saved the document.
Created Created date.
Modified Modified date.

File Name Group

Basic path and name information.

Field Write Description
File Name + Name without extension.
File Extension + Extension without a leading dot.
Full File Name + Name including extension.
Full Path + Absolute path including full name.
Parent Directory + Absolute path of the containing folder. Changing it moves the item; missing folders are created when you press GO.
File/Folder Whether this item is a file or a folder. The cell shows File or Folder.
File Name Numeric Value First number found in the full name, or 0. Useful for sorting.
File Name Length Character length of Full File Name.
Full Path Length Character length of Full Path.

File Properties Group

Field Write Description
Creation Date + Filesystem creation time.
Last Write Date + Filesystem last-write time.
Last Access Date + Filesystem last-access time.
Size File size in bytes (0 for folders).
Attributes + Attribute flags in the form RHAS (Read-only, Hidden, Archive, System); - means unset.
Folder File Count Count of files in the item's folder (parent folder for file rows; the folder itself for folder rows). Does not include subfolders.

Image Group

Properties

Read-only basic image properties for JPEG, PNG, GIF, TIFF, BMP, ICO, WebP, and HEIF/HEIC. See Image Properties tokens.

Field Write Description
Format Image format name.
Width Width in pixels.
Height Height in pixels.
Bit Depth Bits per pixel.
Horizontal Resolution Horizontal DPI.
Vertical Resolution Vertical DPI.
Frames Count Frame count (e.g. animated GIF).

Image Tag

Simple photo fields for JPEG and PNG (one Title, one Caption, and so on). Matching tokens are under Image Tag formatting tokens. Write with Image Tag Setter.

Field Write Description
Title + JPEG and PNG. Writes XMP Title. JPEG also writes Windows Title. Explorer shows XMP Title first.
Caption + Photo description. JPEG and PNG. Writes XMP Comment. JPEG also writes EXIF Comment.
Author + JPEG and PNG. Writes XMP Creator. JPEG also writes EXIF Artist and Windows Author.
Keywords + JPEG and PNG. Writes XMP Keywords. JPEG also clears Windows Keywords. Separate keywords with ;.
Copyright + JPEG and PNG. Writes XMP Copyright. JPEG also writes EXIF Copyright.
Date Taken + JPEG only. EXIF shot date.
Rating + JPEG and PNG. XMP Rating 0-5. JPEG also writes Windows Rating so Explorer Details updates. Empty or 0 clears.

Other apps may still show an old IPTC caption or keywords after you edit Caption, Keywords, or Author.

EXIF

EXIF columns for photos.

Field Write Description
Windows Title + Windows XP Title. JPEG only for write. Not XMP Title.
Windows Subject + Windows XP Subject. JPEG only for write.
Windows Author + Windows XP Author (distinct from EXIF Artist). JPEG only for write.
Windows Keywords + Windows XP Keywords, separated with ;. JPEG only for write.
Windows Comments + Windows XP Comments. JPEG only for write.
Windows Rating + Windows photo rating, 1-5 stars. JPEG only for write. Explorer Details uses this.
Artist + EXIF Artist (photographer). JPEG only for write. Not the audio-tag Artist field.
Copyright + EXIF Copyright. JPEG only for write.
Date Taken + EXIF DateTimeOriginal. JPEG only for write.
Comment + EXIF Image Description. JPEG only for write.
Software + Software that wrote the EXIF, for example Lightroom. JPEG only for write.
DateTime + EXIF DateTime (when the file was last changed). Not Date Taken. JPEG only for write.
DateTimeDigitized + EXIF DateTimeDigitized (when the photo was digitized). Not Date Taken. JPEG only for write.
Make Camera make.
Model + Camera model. JPEG only for write.
Image Number + EXIF Image Number. JPEG only for write. Whole number.
Exposure Time + Shutter speed. JPEG only for write. Use 1/60, 1/60 sec, or 0.016667.
FNumber + Aperture f-number. JPEG only for write. Use f/8, f/8.0, or 8.
ISO Speed Ratings + ISO speed. JPEG only for write. Whole number.
Focal Length + Focal length. JPEG only for write. Use 50 or 50 mm.
Focal Length In 35mm Film + 35mm-equivalent focal length. JPEG only for write. Whole number from 1 to 10000, or 50 mm.

XMP

Adobe XMP columns for JPEG and PNG.

Field Write Description
Title + XMP Title. JPEG and PNG. Explorer Title when this is set.
Creator + XMP Creator. JPEG and PNG. Explorer Authors when this is set.
Keywords + XMP Keywords, separated with ;. JPEG and PNG.
Comment + XMP Comment. JPEG and PNG.
Copyright + XMP Copyright. JPEG and PNG.
Date Taken + XMP Date Taken. JPEG and PNG.
Rating + XMP Rating 0-5. JPEG and PNG. Empty or 0 clears.

PNG

PNG text columns.

Field Write Description
Title + PNG Title. PNG only. Explorer ignores this; use XMP Title for Explorer.
Author + PNG Author. PNG only.
Copyright + PNG Copyright. PNG only.
Comment + PNG Comment. PNG only.
Date Taken + PNG Date Taken (Creation Time). PNG only.

JPEG Comment

The JPEG comment stored in the file. Editable on JPEG. This is not EXIF Comment. See JPEG Comment token.

Field Write Description
Comment + JPEG comment. JPEG only.

GIF Comment

The GIF comment stored in the file. Editable on GIF. See GIF Comment token.

Field Write Description
Comment + GIF comment. GIF only.

Geo

Image → Geo in Select fields. Read-only GPS and nearby place names.

Field Write Description
Latitude GPS latitude in decimal degrees when present; otherwise empty (no network).
Longitude GPS longitude in decimal degrees when present; otherwise empty (no network).
Nearby Place Nearby place name from GeoNames for the GPS coordinates.
Nearby Region Nearby region from GeoNames for the GPS coordinates.
Nearby Country Nearby country from GeoNames for the GPS coordinates.

Media Properties Group

Read-only stream properties for audio and video. Raster size is under Image. See also Media formatting tokens.

Field Write Description
MIME Type Internet media type.
Possibly Corrupt Whether the file was flagged as possibly corrupt.
Duration Formatted duration (h:mm:ss).
Duration (Seconds) Same duration as a whole-second number.
Media Types Media-type flags text.
Description Codec / media description.
Audio Bitrate Audio stream bitrate when present.
Audio Channels Audio channel count when present.
Audio Sample Rate Audio sample rate when present.
Bits Per Sample Bits per sample when present.
Video Width Video stream width in pixels (not still-image / cover art).
Video Height Video stream height in pixels (not still-image / cover art).