Configuration

Settings live in kettlemark.toml. Kettlemark reads, in order, and later ones win:

1. Built-in defaults.
2. Your user settings: ~/.config/kettlemark/config.toml on macOS and Linux, %APPDATA%\kettlemark\config.toml on Windows.
3. kettlemark.toml in the folder you're renaming.
4. Options on the command line.

Run kettlemark config <folder> to see the result.

Example

pattern = "{yyyy}-{mm}-{dd}_{hh}{mi}{ss}"
fallback = "skip"
recursive = false
include = ["*.jpg", "*.jpeg", "*.heic", "*.png", "*.cr3", "*.mp4", "*.mov"]
duplicates = "suffix"

Patterns

A pattern is the new file name, without the extension. These tokens are replaced with parts of the date taken:

Extensions are kept and written in lowercase.

Duplicates

Two photos taken in the same second would get the same name. The duplicates setting decides what happens: