Variable SettingsConst

Type Declaration

• allowArchaicTimezoneOffsets: Setting<boolean>

  Allow parsing of archaic timezone offsets that are no longer in use.

  These include historical offsets like:

  • "-10:30" (Hawaii 1896-1947)
  • "-04:30" (Venezuela 1912-1965, 2007-2016)
  • "+04:51" (Bombay until 1955)
  • and others from https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

  Warning: Enabling this may lead to incorrect timezone parsing for modern files, as these offsets are not currently used anywhere. Only enable this if you are specifically working with historical photographs or scanned archival material.

  Default

  false
  Copy

• allowBakerIslandTime: Setting<boolean>

  Allow parsing of the UTC-12:00 timezone offset ("Baker Island Time") as a valid timezone.

  This timezone is not used for any populated land, and is disabled by default to prevent incorrect timezone parsing from files with mangled metadata.

  Default

  false
  Copy

• logger: Setting<() => Logger>

  Logger instance used throughout exiftool-vendored.

  By default, this is set to ConsoleLogger if NODE_DEBUG=exiftool-vendored is set, otherwise NoLogger.

  This can be changed at runtime to redirect logging output. When changed, the batch-cluster global logger is also updated for consistency.

  Default

  ConsoleLogger or NoLogger based on NODE_DEBUG
  Copy

• maxValidOffsetMinutes: Setting<number>

  Maximum distance (in minutes) from a valid timezone offset to accept when inferring timezones from GPS or UTC timestamp comparisons.

  This threshold handles GPS time drift and clock skew. GPS acquisition may lag behind the actual photo time, especially if the GPS fix is old or the camera clock is slightly off.

  • 15 minutes: Stricter matching, fewer false positives, but may reject photos with older GPS fixes
  • 30 minutes: More tolerant of GPS lag, recommended for photos that may have stale GPS data

  Default

  30 minutes
  Copy

• tzAbbreviationOffsets: Setting<Readonly<Record<string, number>>>

  Additional timezone abbreviation → UTC offset (in minutes) mappings.

  These are merged on top of the built-in table, with user values taking precedence. This allows you to:

  • Resolve ambiguous abbreviations for your region
  • Override built-in mappings
  • Add abbreviations not in the default table

  Keys must be uppercase. Values are UTC offset in minutes.

  Default

  {} (only built-in unambiguous mappings are used)

  Example

  import { Settings } from "exiftool-vendored"
  
  // US Central Standard Time (UTC-6):
  Settings.tzAbbreviationOffsets.value = { CST: -6 * 60 }
  
  // India Standard Time (UTC+5:30):
  Settings.tzAbbreviationOffsets.value = { IST: 5 * 60 + 30 }
  
  // Multiple at once:
  Settings.tzAbbreviationOffsets.value = {
    CST: -6 * 60,
    IST: 5 * 60 + 30,
  }
  Copy

• reset: function

  • reset(): void

    Reset all settings to their default values

    Returns void