Settings Reference

Complete reference for all settings available in Gaivota.

Open Settings with ⌘, (Cmd+Comma) or from the menu.

General

Setting	Description	Options
Enable Polling	Automatically check for new emails	On/Off
Poll Interval	How often to check for new mail	1, 5, 15, 30 minutes
Enable Notifications	Show desktop notifications for new mail	On/Off
Sound Enabled	Play sound with notifications	On/Off
Notification Sound	Which sound to play	Chime, Ding, Pop, Swoosh, Bell

Accounts

Per-account settings:

Setting	Description
Display Name	How the account appears in sidebar
From Name	Name used when sending emails
Remove Account	Disconnect and remove account

Appearance

Setting	Description	Options
Theme Mode	Light or dark interface	Light, Dark, System
Theme	Color scheme	Default, Ocean, Forest, etc.
Custom Colors	Create custom color scheme	Color pickers
List Density	Email list spacing	Compact, Default, Comfortable
Font Size	Text size throughout app	Slider (small to large)

Spam

Setting	Description	Default
Enable ML Spam Detection	Use machine learning spam filter	Off
Collect Training Data	Save email features for training	Off
Minimum Training Examples	Examples needed before model activates	10
Auto-confirm junk on delete	Mark deleted spam as confirmed junk	Off
Show Spam Confidence	Display spam probability on emails	Off

Blocked Senders

Setting	Description	Default
Auto-block on mark as junk	Block sender when marking spam	Off
Blocked Senders List	View and manage blocked addresses	(List)

Keyboard Shortcuts

All shortcuts can be customized:

Category	Shortcuts
Navigation	j, k, o, u, Ctrl+B, Ctrl+F
Folders	g+i, g+d, g+s, g+a, g+j, g+t
Actions	e, #, !, s, r, a, f, c
Selection	x, *+a, *+n, *+r, *+u
Utility	?, /, ⌘,

Click any shortcut to change it.

Reset to Defaults: Restore all shortcuts to original values.

Plugins

Setting	Description
Installed Plugins	List of active plugins
Plugin Details	Name, version, description
Enable/Disable	Toggle individual plugins
Remove	Uninstall a plugin

See Plugin System for details.

Profiles

Setting	Description
Current Profile	Active profile name
Profile List	All available profiles
New Profile	Create a new profile
Switch Profile	Change to different profile
Delete Profile	Remove a profile
Set as Default	Make profile the default

Data & Storage

These settings control local data:

Setting	Description	Location
Data Directory	Where Gaivota stores data	(Platform specific)
Cache Size	Email cache limit	(Automatic)
Clear Cache	Remove cached emails	Button

Data Locations

Platform	Path
macOS	~/Library/Application Support/com.gaivota.app
Windows	%APPDATA%\com.gaivota.app
Linux	~/.local/share/com.gaivota.app

Advanced

Setting	Description
Developer Tools	Open DevTools (for debugging)
Reset All Settings	Restore all defaults
Export Settings	Save settings to file
Import Settings	Load settings from file

warning

Reset All Settings cannot be undone. Your accounts will remain, but all preferences return to defaults.

Synced vs Local Settings

Synced (per account)	Local (per device)
Account credentials	Window position
Folder structure	Theme preference
Email cache	Keyboard shortcuts
Spam training	Notification settings

Configuration Files

Advanced users can edit configuration directly:

File	Contents
settings.json	General preferences
shortcuts.json	Keyboard shortcuts
themes.json	Custom themes

warning

Edit configuration files only when Gaivota is closed. Invalid JSON will reset to defaults.