Magic File Renamer Help

Image Fields

Photo columns and related metadata. Matching tokens are under Formatting Tokens → Image.

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

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

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

Image Tag Setter updates every place the photo already stores a field. If the photo stores it nowhere, it adds it in the Main field.
Also when present lists extra fields that are updated only when they already exist (never created).

Field	Read	Write	Main field	Also when present	Notes
Title	JPEG PNG	JPEG PNG	XMP Title	Windows Title	Explorer shows XMP Title first.
Caption	JPEG PNG	JPEG PNG	XMP Comment	EXIF Comment	Photo description most apps show. Not the file's plain Comment.
Comment	JPEG GIF PNG	JPEG GIF PNG	JPEG COM GIF comment PNG Comment	Windows Comments	File's plain comment. Not Caption.
Author	JPEG PNG	JPEG PNG	XMP Creator	EXIF Artist Windows Author	Explorer shows XMP Creator as Authors.
Keywords	JPEG PNG	JPEG PNG	XMP Keywords	Clears Windows Keywords	Separate keywords with ;. Clearing Windows Keywords avoids duplicate Explorer Tags.
Copyright	JPEG PNG	JPEG PNG	XMP Copyright	EXIF Copyright	Explorer shows XMP Copyright.
Date Taken	JPEG PNG HEIC TIFF WebP	JPEG PNG	JPEG: EXIF Date Taken PNG: XMP Date Taken	XMP Date Taken (JPEG) PNG Creation Time	Shot date. Use yyyy-MM-dd HH:mm:ss or ISO 8601 when writing.
Rating	JPEG PNG	JPEG PNG	XMP Rating	Windows Rating	Stars 0-5. Empty or 0 clears. Windows Rating keeps Explorer Details in sync.

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

EXIF columns for photos.

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

Dates can be yyyy-MM-dd HH:mm:ss, ISO 8601, or the Windows date format shown in the column. Other text is an error, not a save
Windows Title is a different store from XMP Title. Explorer shows XMP Title first when it is set

Adobe XMP columns for JPEG and PNG.

Field	Write	Description
Title	+	XMP Title. Explorer shows this as Title (ahead of Windows Title).
Creator	+	XMP Creator. Explorer shows this as Authors.
Keywords	+	XMP Keywords, separated with ;.
Comment	+	XMP Comment.
Copyright	+	XMP Copyright.
Date Taken	+	XMP Date Taken.
Rating	+	XMP Rating 0-5. Empty or 0 clears.

PNG text columns.

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

Dates can be yyyy-MM-dd HH:mm:ss or ISO 8601. Other text is an error, not a save

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

Field	Write	Description
Comment	+	File comment.

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

Field	Write	Description
Comment	+	File comment.

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

Latitude and Longitude come from EXIF GPS
Nearby Place, Region, and Country reverse-geocode that EXIF GPS via GeoNames (may use the network)
Matching tokens are under Nearby / GeoNames tokens and EXIF GPS tokens
How to get a GeoNames username

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.