Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Settings

File > Settings (or Ctrl+,) is a two-pane dialog, IntelliJ-style: a category list on the left (General, Appearance, Editor, Templates, History, Pomodoro, Shortcuts), Up/Down to move between categories, and that category’s controls on the right. Settings are stored as smaragd.toml in the platform’s config directory (the same base path as the global plugins, custom-themes, custom-styles, and custom-project-templates folders — see Plugins, Custom themes, Typesetting styles, and Project Templates). Writing Streak is not here — it’s configured per project, inside its own dock tab (see Writing Streak).

  • General: Reopen project on launch (off by default), Ensure Research and Trash folders exist in every project (off by default; see Projects), and a Notifications section with Error toast duration and Status bar message duration (1–60 seconds each, defaulting to 6 and 8 respectively — see Notifications above)
  • Appearance: Dark/Light/System and Color Theme (see Themes), a UI font picker (see Editor Font), plus UI Scale — a manual multiplier (50%–300%, default 100%) on top of whatever scaling your OS/display server already reports, for the rare case that comes back wrong (some Wayland compositors don’t report a scale winit picks up, leaving the whole UI tiny with no apparent way to fix it). Takes effect immediately; Reset clears it back to 100%
  • Editor: font + size (see Editor Font) and Typewriter quotes in Preview and export (off by default; see Typewriter Quotes)
  • Templates: date format for ${{date}} — see Template Variables
  • History: an app-wide “Enable Git integration” switch (see Git Integration) and a Backups section (see Backups) — Scrivener-style automatic zipped snapshots of the whole project, off by default. A master “Enable automatic backups” switch, plus independent triggers for opening a project, closing a project, and every explicit save, a backups to keep count, and a backup folder (defaulting to the platform’s data directory, browsable to somewhere else)
  • Pomodoro: durations (work/short break/long break minutes, and sessions before a long break), plus a desktop-notification toggle for automatic phase completions — see Pomodoro Timer
  • Shortcuts: remap or unbind any action, including a fullscreen toggle

If the settings file is missing or its contents can’t be parsed, smaragd falls back to defaults rather than failing to start.