Hyphen (-) = Sub-field separator (replaces all spaces)
Dot ( . ) = Hierarchical identifier and file extension
Country Codes:
Countries are automatically converted to 3-letter codes: United States→USA, Canada→CAN, England→ENG, Ireland→IRE, Scotland→SCO, Wales→WAL, Germany→GER, Australia→AUS, United Kingdom→UK
International Support:
Select your country's place format from the dropdown. All formats use smallest→largest input order. Supports USA, Canada, UK, Germany, Australia, and Generic formats.
Example (USA Format):
Birth_USA.Ohio.Medina-County.Wadsworth_1922.01.04_KEENER.Jane.Alma_Birth-Certificate.jpg
Input: "Wadsworth, Medina County, Ohio, USA" → Output: "USA.Ohio.Medina-County.Wadsworth". Format adapts based on selected country. Use commas as placeholders for unknown parts.
Replace FILE_PATH_HERE with your directory path. The command already includes the filename at the end.
Usage Tips:
Replace FILE_PATH_HERE with a specific file or wildcard pattern (*.jpg)
For Windows batch processing, save as .bat or .cmd file
For Mac/Linux, save as .sh file and make executable (chmod +x filename.sh)
Use -overwrite_original flag to avoid creating backup files
Add -r flag for recursive processing of subdirectories
FHMWG Metadata Fields:
The Family History Metadata Working Group (FHMWG) recommends these essential metadata elements:
Title - Short name for the image (mapped from filename)
Description - Detailed information about the image
Date - When the depicted scene occurred (mapped from date field)
Location - Where the scene occurred (mapped from place field)
People - Names of individuals in the image (mapped from name fields)
Implemented:Title, Date, Location place names, Person names
Missing:Location GPS coordinates, Person face tags
Note:Face tags require image loading. GPS coordinates could be added with map interface.
Settings
File Path Settings
Enter the full directory path where your files are located. If left blank, "FILE_PATH_HERE" will be used as a placeholder.
Filename Template
Available Placeholders:
{TYPE} - Event type (e.g., Birth, Marriage, Death)
{PLACE} - Place sub-template. Define below.
{DATE} - Date sub-template. Define below.
{NAME} - Name sub-template. Define below.
{SURNAME} - Person's surname
{GIVEN} - Given name
{MIDDLE} - Middle name
{INFO} - Document type/additional info
{EXT} - File extension
{AdditionalPeople} - All additional people formatted per Additional People Name Format
{{ text }} - Conditional block (included only if enclosed placeholders have content)
Enter your preferred filename template using the placeholders above.
Date Sub-template
Date Placeholder Syntax:
{YYYY} - 4-digit year (e.g., 2024)
{YY} - 2-digit year (e.g., 24)
{MM} - Zero-padded month (e.g., 03)
{M} - Month without padding (e.g., 3)
{DD} - Zero-padded day (e.g., 05)
{D} - Day without padding (e.g., 5)
Define how dates are formatted in your filenames. Leave blank to use default: {YYYY}.{MM}.{DD}
Define how places are formatted in your filenames. Available: {COUNTRY}/{C}, {STATE}/{S}, {COUNTY}/{CO}, {CITY}/{CI}. Leave blank to use default: {COUNTRY}.{STATE}.{COUNTY}.{CITY}
Define how the primary person's name is formatted. Available: {SURNAME}, {GIVEN}, {MIDDLE}. Leave blank to use default: {SURNAME:upper}.{GIVEN}
Additional People Name Format
Additional People Name Format Syntax:
Format: [template]|[delimiter]
Examples:
{GIVEN}.{SURNAME}|+ → Jane.Doe+Mary.Smith
{SURNAME},{GIVEN}| & → Smith,Jane & Brown,Mary
{SURNAME}|; → Smith; Brown
{GIVEN}|, → Jane, Mary
Define how additional people names are formatted. Use {GIVEN}, {SURNAME}, {MIDDLE} placeholders. Separate format from delimiter with pipe (|).