MMWW

Using metadata templates

Many media editor programs, such as Photoshop, Paint Shop Pro, Acrobat and Audacity have ways of loading metadata into media. These usually can be found in a dialog box named “Properties,” “Image Information,” or something similar.

MMWW’s settings page lets you specify the templates to use for populating the text fields. For example, you can set the Description template for an image file from a smartphone to

({description} )({shutter}--{fstop} )({latitude}/{longitude} )({created_time})

and you’ll see some details about how, where, and when the photo was taken in your Description.

You can use parentheses to delimit optional parts of a metadata template string. For example, not all media files contain {copyright} metadata. If you put this into your metadata template string, it will omit the whole copyright clause if there’s no {copyright} metadata. Notice that there’s a trailing space before the closing parenthesis. This separates this clause (if it appears) from the next one.

(Copyright © {copyright} )

The parentheses denote the whole clause as optional, and omitted if the metadata mentioned in it is not available.

Similarly, you can create a URL that will display a map centered on the spot your photo was taken, but only if latitude and longitude are available in the photo’s metadata, like one of these:

(<A href="https://www.openstreetmap.org/search?query={latitude},{longitude}&zoom=14&layers=S" target="_blank">\(Open Street Map {title}\)</A>) (<A href="https://maps.google.com/?ll={latitude},{longitude}&z=18" target="_blank">\(Google Maps {title}\)</A>)

If you want literal parentheses or curly braces to appear in your metadata, use the backslash character to escape them in your template data.

JPEG image files

JPEG photo files have lots of possible metadata. Not every photograph has all these items of metadata, but most have some of them.

{title} Title of the file. {filename} Filename of the file. e.g. "DSC_5007" (without .jpg) {credit} Author. {copyright} Copyright notice if any is included. {description} Narrative description. {tags} One or more keyword tags, separated by semicolons. {rating} 0 - 5, set by various image browsers {workflowlabel} A text string like "Discard" or "Keep," set by various image browsers {camera} Camera model {shutter} Shutter speed, such as 1/200 {shutter_speed} Shutter time in sec, such as 0.05 {fstop} Aperture, like f/5.6 {aperture} Raw aperture, like 5.60 {flash} Flash setting, such as "No Flash" or "Fired, Red-eye reduction" {focal_length} Lens's focal length in mm. {focal_length35} Lens's 35mm film focal length equivalent in mm. {lightsource} Kind of light detected, such as "Daylight" or "Tungsten" {meteringmode} Type of metering the camera used, such as "Spot," "Average," or "Unknown" {sensingmethod} Type of image sensor, such as "One-chip color area sensor." {exposuremode} Exposure mode, such as "Auto" or "Manual" {exposureprogram} Exposure-setting program, such as "Aperture Priority" or "Normal Program." {exposurebias} Selected exposure bias. {brightness} A number indicating how bright the scene is {scene_capture_type} Scene capture type. Standard, Landscape, Portrait, Night {sharpness} Image's sharpness. Normal, Soft, Hard {latitude} GPS latitude reading, shown in degrees and decimals. {longitude} GPS longitude reading, showin in degrees and decimals. {altitude} GPS altitude in meters above sea level {direction} Direction of photograph. 270M means magnetic west, 180T means true south. {subject_distance} Distance to subject from autofocus or other means. {created_time} Timestamp when the photograph was taken.

IPTC metadata in JPEG image files

The International Press Telecommunications Council has defined many items of metadata to go in photo files. This metadata helps photojournalists and publications do business efficiently. Various tools, such as Adobe Bridge, allow this metadata to be inserted. MMWW can retrieve it, with these tags

{iptc:creator} The creator's name. {iptc:creator:jobtitle} The creator's job title. {iptc:creator:address} The creator's address. {iptc:creator:city} The creator's city. {iptc:creator:state} The creator's state or province. {iptc:creator:postcode} The creator's post / zip code. {iptc:creator:country} The creator's country. {iptc:creator:phone} The creator's phone(s). {iptc:creator:email} The creator's email(s). {iptc:creator:website} The creator's web site(s). {iptc:headline} Headline. {iptc:description} Description. {iptc:keywords} Keywords, separated with comma or semicolon. {iptc:iptcsubjectcode} IPTC subject code. {iptc:descriptionwriter} Author of the description. {iptc:datecreated} Creation date. {iptc:genre} Intellectual genre. {iptc:scenecode} IPTC scene code. {iptc:datecreated} Creation date. {iptc:sublocation} Location within city. {iptc:city} City. {iptc:state} State/Province. {iptc:country} Country. {iptc:iscocountrycode} Country code per ISO 3166. {iptc:title} Title. {iptc:jobidentifier} Job Identifier. {iptc:instructions} Instructions. {iptc:creditline} Credit line. {iptc:source} Source. {iptc:copyright} Copyright Notice. {iptc:copyrightstatus} Copyright Status. {iptc:rightsusageterms} Terms of usage.

PNG image files

PNG image files have a few items of metadata. Most creators of PNG files don’t know this metadata exists so it isn’t often present.

{title} Title of the file. {credit} Author. {copyright} Copyright notice if any is included. {description} Narrative description. {created_time} The timestamp describing the time the PNG was made. {filename} Filename of the file. e.g. "icon" (without .png)

PDF

PDF files, created by Adobe Acrobat and other programs, have a few items of metadata. The most generally useful of these are the title and credit.

{title} Title of the file. {credit} Author. {copyright} Copyright notice if any is included. {description} Narrative description. {tags} One or more keyword tags, separated by semicolons. {rating} 0 - 5 {created_time} The timestamp describing the time the PDF was made. {software} Program used to create PDF. {filename} Filename of the file. e.g. "scan1234" (without .pdf)

Audio

MP3 Audio files can have lots of metadata, defined by the ID3 standard. The first few items are by far more common than the others.

{title} Title of the song. {album} Title of the album. {credit} Author or performer. {artist} See {credit} {year} Year of recording. {copyright} Copyright notice if any is included. {description} Narrative description. {genre} Genre. {rating} 0 - 5. {filename} Filename of the file. e.g. "TRACK_003" (without .mp3). {fileformat} "mp3", "aac" {duration} Length of audio, for example 1:03:22. {mime_type} "audio/mpeg" or similar.

These metadata items are in the ID3 standard for MP3 files, but most files don’t have them. MMWW handles them in case your particular media workflow needs them.

{tempo} {grouptitle} {keysignature} {DDMM} Day and month of recording {HHMM} Hour and minute of recording {duration} {creditlead} {creditconductor} {creditproducer} {writer} {creditorganization} {mediatype} {creditoriginal}

WordPress information for all files

{wp:attachmentid} gives the post id of the present post. {wp:parentid} gives the post id of the post to which this media file is attached. {wp:parenttitle} gives the title of the post to which this media file is attached. {wp:parentslug} gives the slug (url fragment) of the post to which this media file is attached.

These may be missing if those values are unknown at the time of media creation. Reloading the media metadata will insert