Settings Menu

Settings Sections

• Autostart
• Behavior
• Appearance
• Updates
• Terminal Colors
• Profiles and Account

Settings open in a dedicated viewport window named Rusty Settings, or an embedded modal fallback.

Autostart

• Autostart on launch connects Rusty at startup using the default profile.
• Autostart only works when a default profile exists and has host + username.
• If Save session layout is enabled, restored sessions take priority and autostart does not run.
• If password is not saved in the default profile, Rusty prompts for credentials on startup.

Behavior

• Minimize to tray: minimize button hides Rusty to system tray instead of taskbar-only minimize.
• Save session layout: stores tab/split layout and window position/size between launches.

Appearance

• Theme file (.thm): choose a specific UI theme file or mode default (Dark.thm/Light.thm).
• Theme file fallback: if missing/invalid, Rusty uses built-in defaults and shows a status note.
• Focus shade: applies a 20% gray overlay to inactive terminal panes.
• Terminal font size: slider range 10 to 28, updates live for existing sessions.
• Terminal scrollback lines: range 0 to 200000 (0 means default 5000), applies on new connections.

Updates

• Check for updates now checks GitHub Releases (/releases/latest).
• When a newer version is found, Rusty shows it and offers Open latest release page.
• Automatic update checks run at most once every 12 hours.

Terminal Colors

• Loads WezTerm-compatible TOML themes from term/.
• Reload from term/ rescans theme files and refreshes cards.
• Click any theme card to apply immediately, including already-open terminal sessions.
• Rusty stores the selected terminal theme ID in config.

Profiles and Account

Profile List

• Select a profile to load it into the editor form.
• Right-click a profile to set/clear default or delete.
• Buttons: New, Delete, Make Default.

Connection Fields

• Profile name, host, port, user, optional password, optional private key path.
• Browse... opens a file picker for private key selection.
• Remember password stores profile password encrypted in local config (Windows DPAPI path).

Actions

• Save creates or updates profile by name.
• Connect applies current form fields to the target tab and reconnects it.
• Close exits settings without forcing connect.

Advanced: key passphrases are remembered from authentication prompts when "Remember key passphrase for this profile" is selected.

Config Storage Notes

• Config path: %APPDATA%\Rusty\config.json (legacy path is migrated automatically).
• Rusty encrypts config payloads per user with DPAPI and a RUSTYCFG1: prefix.
• Saves are atomic with retries to handle transient file locks.