Magic File Renamer Help

Nearby / GeoNames Tokens

Reverse-geocode GPS coordinates from image EXIF into nearby place names via the online GeoNames findNearby service. GPS itself comes from <exif-gps-lat> / <exif-gps-lon>. Nearby Country / Region / Place also appear under Jpeg Geo Rename List columns, with Latitude and Longitude.

Name	Signature
Nearby Place	`<geo-place>` or `<geo-place:lang=de>`
Nearby Region	`<geo-region>` or `<geo-region:lang=de>`
Nearby Country	`<geo-country>` or `<geo-country:lang=de>`

Example: <geo-place> - <exif-date:yyyy-MM-dd> or <geo-place:lang=de>

Language

Optional lang= is an ISO 639-1 code (exactly two letters; DE is stored as de). A bare token uses Options → Location → GeoNames language, which defaults to English (en). An explicit lang= wins. The code is chosen when the name is previewed, so changing Options updates bare tokens without editing the format string. Anything that is not two letters (for example eng) is a format-string error. Edit on a geo-* token opens the same language list as Options; leaving Options default keeps the token bare. Insert from the catalog is always bare.

Empty vs error

No GPS on the image → the token expands empty (no network call).
Successful lookup with a blank field → that token expands empty.
Network, HTTP, XML, or rate-limit failure when a geo-* token or Nearby column is used → PreviewError (or a Rename List load error for that row). A lookup error in one language does not fail tokens or columns that use another. A rate-limit still stops further lookups for that username.

Account, language, and cache

Options → Location → GeoNames username defaults to the built-in account (fbmfr), shared across installs. Change it to your own username for a private quota — see How to get a GeoNames username. Options → Location → GeoNames language defaults to English (en); pick a suggestion or type any ISO 639-1 two-letter code. A token may override that with lang= (for example <geo-place:lang=de>); otherwise nearby names request the Options language (lang=). Results are cached in memory and on disk so repeated coordinates (for the same language) do not spend credits again. Large lists with many distinct GPS locations can exhaust the free daily quota; after a rate-limit response, further uncached lookups fail fast without more HTTP until you restart or change the Options username or language.

GeoNames data is provided under Creative Commons Attribution. See geonames.org and Credits.