Settings
Tablen's settings are organized into tabs, each controlling a different aspect of the application. Access settings with Cmd+, or from the menu bar.
General Tab
Query Execution
| Setting | Options | Default | Description |
|---|---|---|---|
| Query Timeout | 15, 30, 60, 120 seconds | 30 | Maximum time for a query to execute before being cancelled |
The timeout uses a withThrowingTaskGroup racing pattern for reliable enforcement.
Language
| Setting | Options | Default | Description |
|---|---|---|---|
| Application Language | System Default, English, Turkish | System | UI language for the application |
Changing the language requires an app restart. The setting is stored in @AppStorage("appLanguage") and applied via UserDefaults AppleLanguages key.
Safety
| Setting | Default | Description |
|---|---|---|
| Enable Safe Mode for all connections | Off | Forces confirmation dialogs for destructive queries on ALL connections |
| Review SQL before committing inline edits | On | Shows a preview of generated SQL when pressing Cmd+S in the result table |
Safe Mode adds confirmation requirements:
- DROP, TRUNCATE, DELETE without WHERE: Type the connection name to confirm
- UPDATE, ALTER, DELETE with WHERE: Simple confirm/cancel
Code Review Mode shows the exact SQL that will be executed when committing inline edits.
Privacy
| Setting | Default | Description |
|---|---|---|
| Send crash reports and performance data | Off | Opt-in to anonymous Sentry crash reporting |
When enabled, anonymous crash reports and performance metrics are sent to improve Tablen. No personal data is shared. Disabling requires an app restart.
iCloud Sync
| Setting | Default | Description |
|---|---|---|
| Sync connections and queries across devices | Off | Sync via iCloud |
Requirements:
- Must be signed into iCloud in System Settings
- Passwords are never synced (remain in local Keychain only)
- Last sync time is displayed
- "Sync Now" button for manual sync
- Conflict resolution uses
updatedAttimestamps
Data
| Action | Description |
|---|---|
| Delete All My Data | Permanently deletes all connections, query history, saved queries, favorites, Keychain passwords, and preferences |
This action:
- Deletes data files: connections.json, groups.json, query_history.json, tabs.json, favorites.json, saved_queries.json, audit_log.json
- Deletes all Keychain entries
- Clears UserDefaults
- Prompts for app restart
Appearance Tab
Theme
Select from multiple built-in themes with dark and light mode support. Each theme defines colors for:
- Editor background and foreground
- Syntax highlighting (keywords, strings, comments, numbers, functions)
- Sidebar colors
- Table header and alternating row colors
Theme selection is stored in @AppStorage("selectedTheme") with default "ocean-dark".
Editor
| Setting | Range | Default | Description |
|---|---|---|---|
| Font Size | 10-24pt | 13pt | Monospaced editor font size |
| Show Line Numbers | On/Off | On | Display line numbers in the editor gutter |
| Show Minimap | On/Off | Off | Display code minimap on the right side |
Result Table
| Setting | Options | Default | Description |
|---|---|---|---|
| Default Row Limit | 50, 100, 500, 1000, 5000 | 100 | Maximum rows returned by queries |
| Show Row Numbers | On/Off | On | Display row numbers in the result table |
| Alternating Row Colors | On/Off | On | Use alternating background colors for rows |
Schedules Tab
Manage scheduled queries:
- View all scheduled queries
- Create new schedules
- Edit or delete existing schedules
- See execution history
- Configure schedule frequency and target connection
See Query Editor for more details on scheduled queries.
Snapshots Tab
Manage result snapshots:
- View all saved snapshots
- Compare snapshots with current data
- Delete old snapshots
- Export snapshots
See Result Table for more details on snapshots.
Plugins Tab
Manage installed plugins:
- Browse the plugin marketplace
- Install, uninstall, enable, or disable plugins
- Create new plugins
- Publish plugins to the marketplace
See Plugin System for comprehensive plugin documentation.
AI Tab
Configure AI Assistant settings:
- Currently shows "Coming Soon" status
- Will include AI provider configuration when available
See AI Assistant for more details.
Account Tab
Manage your Tablen account:
- View current plan (Free, Pro, or Team)
- License activation and deactivation
- View team information (for Team plans)
- Manage account settings
See Licensing for plan details.
Updates Tab
Configure automatic update settings:
- Check for updates manually
- Enable/disable automatic update checks
- View current version and available updates
See Auto Updates for more details.
About Tab
Application information:
- Current version number
- Build information
- Release notes link
- Legal information
Settings Storage
Settings are stored using @AppStorage (UserDefaults):
| Key | Type | Default |
|---|---|---|
| queryTimeout | Int | 30 |
| globalSafeMode | Bool | false |
| codeReviewMode | Bool | true |
| sentryConsent | Bool | false |
| iCloudSyncEnabled | Bool | false |
| appLanguage | String | "system" |
| selectedTheme | String | "ocean-dark" |
| editorFontSize | Double | 13.0 |
| showLineNumbers | Bool | true |
| showMinimap | Bool | false |
| defaultRowLimit | Int | 100 |
| showRowNumbers | Bool | true |
| alternatingRows | Bool | true |