Skip to main content

Configuration

On Linux, Grid Screen stores local state under:

~/.config/grid-screen/

The location follows XDG_CONFIG_HOME when it is set, then appends grid-screen.

Files​

  • settings.json stores the schema version, snap preference and modifier, autostart preference, tray preference, last layout id, target-screen hint, and default gap and margin.
  • layouts.json stores seeded presets and saved layouts.
  • logs/grid-screen.log receives diagnostic logging.

The config directory is created with mode 0700 and JSON files are written with mode 0600. Writes use a temporary file, read the temporary content back for validation, rename it into place, and rotate up to five backups of an existing file.

The default settings are a 10 px gap, 16 px margin, Shift as the snap modifier, snap enabled, autostart disabled, and minimize-to-tray enabled. These are persisted values. The current source does not establish that the snap or autostart preferences have an effective runtime implementation, so this documentation does not promise those behaviors.