Configuration Desktop

Desktop Configuration File

The desktop app (and the dev server used during development) stores user preferences in a TOML file at:

~/.config/photosphere/desktop.toml

This file is created automatically on first use. You can edit it by hand, but changes take effect only on the next app launch.

Configuration Keys

The on-disk keys use snake_case.

Key	Type	Description
theme	"light" | "dark" | "system"	UI colour theme. Defaults to "system" (follows the OS setting).
last_database	string	Path of the last database that was opened. Used to auto-reopen on launch.
last_folder	string	Last directory shown in the file-open dialog. Used to restore the dialog to a sensible starting location.
last_download_folder	string	Last directory used when downloading assets.
recent_searches	string[]	Ordered list of recently executed gallery searches, most recent first. Capped at 10 entries.
show_fps_indicator	boolean	Whether the FPS indicator overlay is shown in the UI. Defaults to false.

The list of recently opened databases is not stored here. It lives in the database registry (databases.toml).

Example

theme = "dark"
last_database = "/home/alice/photos/main"
last_folder = "/home/alice/photos"
last_download_folder = "/home/alice/Downloads"
recent_searches = ["holiday", ".date=2023", ".location=Sydney"]
show_fps_indicator = false

Related Configuration

• Configuration-CLI: CLI tool configuration for S3 credentials and Google API keys.