Configure photo-cli Application Defaults and Preferences

The settings command lets you view and change application-level defaults that persist across all future commands. You can control things like date formats, separator characters, report file names, reverse geocode API keys, and fallback folder names — all stored locally per user, with changes taking effect immediately for every subsequent command.

How settings work

photo-cli stores your settings in a per-user configuration file on disk. You do not need to pass these values on the command line each time; once set, they apply automatically to every copy, archive, info, and address run.

Settings commands

List all settings and their current values:

photo-cli settings

Get the value of a single setting:

photo-cli settings --key <KeyName>

Set a new value for a single setting:

photo-cli settings --key <KeyName> --value <value>

Reset all settings to their factory defaults:

photo-cli settings --reset

Settings reference

Key	Default value	Description
`AddressSeparator`	`-`	Separator character between address components in file and folder names
`ArchivePhotoTakenDateHashSeparator`	`-`	Separator between the date-time portion and the SHA1 hash in archive file names
`BigDataCloudApiKey`	(empty)	API key for the BigDataCloud reverse geocode provider
`ConnectionLimit`	`4`	Maximum number of concurrent connections to reverse geocode providers
`CoordinatePrecision`	`4`	Number of decimal places used when formatting GPS coordinates
`CsvReportFileName`	`photo-cli-report.csv`	Name of the CSV report file created by the `copy` and `info` commands
`DateFormatWithDay`	`yyyy.MM.dd`	Date format used when the naming style includes a day component
`DateFormatWithMonth`	`yyyy.MM`	Date format used when the naming style includes a month component
`DateTimeFormatWithMinutes`	`yyyy.MM.dd_HH.mm`	Date-time format with minute-level precision
`DateTimeFormatWithSeconds`	`yyyy.MM.dd_HH.mm.ss`	Date-time format with second-level precision
`DayFormat`	`dd`	Format string for the day component alone
`DayRangeSeparator`	`-`	Separator between the start and end dates in `DayRange` folder names
`DryRunCsvReportFileName`	`photo-cli-dry-run.csv`	CSV report file name used during a dry-run
`FolderAppendSeparator`	`-`	Separator inserted between an appended date or address and the original folder name
`GoogleMapsApiKey`	(empty)	API key for the Google Maps reverse geocode provider
`LocationIqApiKey`	(empty)	API key for the LocationIq reverse geocode provider
`LogLevel.<Namespace>`	Various	Per-namespace log level. Use the `Namespace=LogLevel` format (e.g., `LogLevel.Default=Error`). Accepted levels: `Trace`, `Debug`, `Information`, `Warning`, `Error`, `Critical`. Default namespaces: `LogLevel.Default=Error`, `LogLevel.Microsoft=Warning`, `LogLevel.PhotoCli=Warning`, `LogLevel.PhotoCli.Services.Implementations.ReverseGeocodes=Warning`, `LogLevel.Polly=Warning`, `LogLevel.System.Net.Http.HttpClient=Warning`
`MonthFormat`	`MM`	Format string for the month component alone
`NoAddressAndPhotoTakenDateFolderName`	`no-address-and-no-photo-taken-date`	Folder name used for photos that have neither a taken date nor GPS coordinates
`NoAddressFolderName`	`no-address`	Folder name used for photos that have no GPS coordinates or address
`NoPhotoTakenDateFolderName`	`no-photo-taken-date`	Folder name used for photos that have no EXIF taken date
`PhotoFormatInvalidFolderName`	`invalid-photo-format`	Folder name used for files that cannot be read as a valid photo
`SameNameNumberSeparator`	`-`	Separator inserted before the sequential number when two output files would share a name
`SupportedExtensions`	`jpg,jpeg,heic,png,hif`	Comma-separated list of file extensions to process
`CompanionExtensions`	`mov`	Comma-separated list of companion file extensions to copy alongside photos
`YearFormat`	`yyyy`	Format string for the year component alone
`LogCategoryNameOutput`	`False`	Whether to include the log category name in console output
`MacOsCommand`	`open`	Command used to open photos on macOS
`MacOsArgumentPrefix`	`-a Preview`	Arguments prefixed before file paths when opening photos on macOS

Date and time format strings follow .NET conventions. You can find the full list of supported tokens in the Microsoft .NET date and time format strings reference.

Get Started

Reverse Geocoding

Commands

Copy Examples

Configuration

Reference

Configure photo-cli Application Defaults and Preferences

How settings work

Settings commands

Settings reference

​How settings work

​Settings commands

​Settings reference

How settings work

Settings commands

Settings reference