OptionalitchOverride the itch user-data directory instead of searching for it.
OptionalstrategyOptionalcheckDrop games whose install folder is gone. itch leaves caves behind when a folder is deleted outside the app, so this defaults to on.
OptionalextraExtra install locations to scan, e.g. a drive itch was moved off.
OptionalignoreDon't touch butler.db at all, not even for install locations. Only
preferences.json, the built-in appdata location and extraLibraries
are used. Implies strategy: "receipts".
OptionallookupSearch as though for a different user, environment or operating system.
Ignored when itchPath is given, which names the directory outright.
OptionalstrictThrow AmbiguousAppError when more than one installed game matches, instead of returning the first. The same game can legitimately be installed in two locations, and a fuzzy name search can collide, so set this when picking the wrong one would be worse than failing.
OptionalexactRequire the name to equal the game's title, url slug or install folder name exactly.
With exact: false, matching instead ignores case, spacing and
punctuation, so "Cosmic Collapse", "cosmic-collapse" and
"cosmiccollapse" all resolve to the same game -- at the cost of
occasional collisions between similarly named games.
Options for looking up a single game by name.