Settings
Configure tpaw appearance, editor preferences, data display options, connection defaults, and session recording.
tpaw Settings (Cmd+,) lets you customize every aspect of the app — from the visual theme to how many rows the Data Grid loads per page, to session recording retention. Changes take effect immediately without restarting.
Opening Settings
Press Cmd+, or click the Settings gear icon in the bottom of the sidebar.
General
| Setting | Options | Description |
|---|---|---|
| Theme | Midnight, Shades of Purple (Super Dark), Ice Tiger, Ice Tiger Light | Visual theme for the entire app |
| Editor font size | 10–24 (number) | Font size for the SQL editor (Monaco) |
Themes
- Midnight — Dark background, neutral palette
- Shades of Purple (Super Dark) — Deep OLED-friendly purple dark theme
- Ice Tiger — Dark mode with blue accent
- Ice Tiger Light — Light mode variant of Ice Tiger
Data
| Setting | Options | Description |
|---|---|---|
| Rows per page | 100, 250, 500, 1000 | Number of rows the Data Grid loads per page |
Smaller page sizes load faster and use less memory. Larger page sizes let you scroll through more data without paginating.
Connection
Settings for connection behavior, including auto-reconnect preferences and connection form defaults.
- Reset welcome screen — clears the onboarding state, useful for testing the first-run flow
Recording (Session Replay)
Session recording captures your query and data browsing activity for the Replay feature.
| Setting | Default | Description |
|---|---|---|
| Enabled | On | Toggle session recording on/off |
| Retention days | 1 day | How long session data is kept before automatic deletion |
| Redact SQL | On | When enabled, query text is stored but sensitive parameter values may be masked |
| Event limit | 10,000 | Maximum events per session before older events are dropped |
Disabling recording or reducing retention keeps disk usage minimal. If you're working with sensitive data, enable Redact SQL.
About
The About section shows:
- Current tpaw version number
- What's New button — opens the release notes modal with a full changelog
Resetting Settings
Click Reset to Defaults at the bottom of the Settings panel to restore all settings to their factory defaults. This does not affect connections or saved queries.