Settings reference¶
korTTY's settings live in Configuration → Global Settings…. They are stored in ~/.kortty/global-settings.xml. This reference documents every setting, organized by tab.
Each per-tab page lists settings as a table:
| Column | Meaning |
|---|---|
| Setting | The label shown in the dialog |
| Type | toggle · dropdown · number · text · color · path |
| Values | Allowed values / range |
| Default | Out-of-the-box value |
| Stored as | The field in global-settings.xml |
Settings tabs¶
| Tab | What it controls |
|---|---|
| Appearance, themes & font | App design (Default, Matrix, Holographic, Klingon, Elegant Dark), terminal themes, font family & size, UI font size |
| Colors | Color profile, text/background/cursor/selection colors, cursor blink, the 16-color ANSI palette |
| Terminal | Columns/rows, scrollback, encoding, SSH keep-alive, SSH host key verification, connection retries, drag-drop, timestamps |
| Window | Window geometry restore, fixed geometry, dashboard state, menu bar |
| Resources | Opt-in JVM heap/GC profile (Balanced / High / Maximum) for larger workloads |
| Logging | Terminal log directory and retention; session journal storage, AI summaries, interval and profile |
| Export | PDF watermark and document footer for exported session journals and AI chats |
| Backup | Encryption type (ZIP-password / GPG), max backup count |
| Updates | Automatic update checking and interval |
| Security | Master-password prompt, change master password, temporary SSH keys |
| Privacy | Consent for anonymous usage statistics (Aptabase, EU/GDPR) |
| Language | UI language selection (8 built-in) + auto-detect |
| Translation | External or local-AI translation provider, credentials, target language, generate language file |
| Video | Terminal recording / ffmpeg video export |
| AI | AI features, agent execution, HTTP/CLI/embedded profiles, prompt presets, reasoning, image input (vision), quota, internet tools |
| SFTP Manager | SFTP tab auto-close, remote ZIP defaults, JobScheduler rsync binary |
| Editor | Cursor style and color for editor tabs |
| Snippet Editor | Font, color and cursor overrides for snippet windows |
Local-model downloads, Text/Coding role routing, embedding selection, llama.cpp runtime policy, knowledge-source synchronization, and the AI Skills library live in AI > AI Manager rather than the global Settings window; see Local models and RAG knowledge stores.
Completeness
The per-tab pages enumerate every individual setting. Coverage is verified automatically against the application's setting keys, so no setting is left undocumented.
Visual reference¶
A few of the configuration tabs (the per-tab pages show each in detail):
Colors — terminal palette, cursor and ANSI colors
Terminal — scrollback, encoding, keep-alive, retries
Backup — max backups, ZIP-password or GPG encryption
AI — agent execution, profiles, prompt settings, internet tools
