Configuration Desktop

Desktop Configuration File

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

~/.config/photosphere/desktop.json

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

Key	Type	Description
theme	"light" | "dark" | "system"	UI colour theme. Defaults to "system" (follows the OS setting).
recentDatabases	string[]	Ordered list of recently opened database paths, most recent first. Capped at 20 entries.
lastDatabase	string	Path of the last database that was opened. Used to auto-reopen on launch.
lastFolder	string	Last directory shown in the file-open dialog. Used to restore the dialog to a sensible starting location.
recentSearches	string[]	Ordered list of recently executed gallery searches, most recent first. Capped at 10 entries.

Example

{
  "theme": "dark",
  "recentDatabases": [
    "/home/alice/photos/main",
    "/home/alice/photos/archive"
  ],
  "lastDatabase": "/home/alice/photos/main",
  "lastFolder": "/home/alice/photos",
  "recentSearches": [
    "holiday",
    ".date=2023",
    ".location=Sydney"
  ]
}

Related Configuration

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