Skip to content
PGPilot

Settings

Configure pgpilot appearance and language preferences.

Accessing Settings

Section titled “Accessing Settings”

Click Settings (gear icon) at the bottom of the sidebar.

Theme

Section titled “Theme”

pgpilot offers two visual themes:

Settings — Catppuccin theme

Catppuccin Frappé (default)

  • Dark interface with Mauve accent color
  • Based on the Catppuccin color palette
  • Suits most environments and lighting conditions

Settings — USSR theme

USSR

  • Soviet-inspired theme with cream content areas and near-black sidebar
  • Red accent color, Bebas Neue font for navigation, Russo One for content
  • Page titles display humorous Soviet-flavored text (“Encrypt for the People”, “Report to the Commissariat”…)
  • Propaganda banners in each view (USSR-themed images)
  • Circular SVG badges for key status (keyserver, YubiKey, trust levels)
  • Best experienced as a fun easter egg

To change the theme:

  1. Open Settings
  2. Under Theme, click the card for Catppuccin Frappé or USSR to preview
  3. The theme applies immediately — no restart required

UI Scale

Section titled “UI Scale”

The scale factor adjusts the size of the entire interface. This is useful when:

  • The interface appears too large on a 1080p monitor → reduce to 75% or 50%
  • The interface appears too small on a HiDPI / 4K monitor → increase to 125% or 150%

Available values: 50%, 75%, 100% (default), 125%, 150%, 175%, 200%

To change the scale:

  1. Open Settings
  2. Under UI Scale, use the slider with tick marks to select the desired percentage
  3. The change applies immediately

Note: The scale factor is stored in your preferences and restored on next launch. If the interface becomes unusable after a scale change, delete ~/.config/pgpilot/config.yaml to reset to defaults.

Language

Section titled “Language”

pgpilot supports English and French.

On first launch, the language is auto-detected from your system locale ($LANG / $LC_ALL). If your locale starts with fr, French is used; otherwise English.

To change the language:

  1. Open Settings
  2. Under Language, click the English or French button
  3. The interface updates immediately

Preferences file

Section titled “Preferences file”

All settings are stored in ~/.config/pgpilot/config.yaml. Example:

language: english
theme: catppuccin
scale_factor: 1.0

This file is created automatically on first launch. Deleting it resets all preferences to defaults. It does not contain any GPG keys or sensitive data.