Settings

Menu is organized into feature groups. Its Settings group links directly to Engine, Terminal, Keyboard shortcuts, Notifications, Open connections, and Master password. Preferences at the bottom of Menu controls the theme and display language. Connection-specific behavior lives in the connection's sshc tab.

Keyboard shortcuts

Open Menu → Keyboard shortcuts to assign command search, terminal search, copy/paste, previous/next connection, Home and SFTP. Click a binding and press a chord with Ctrl, Alt or Meta (Command), or a function key. Escape cancels; Tab moves to the next control.

Duplicate bindings are rejected. Use Clear to disable an action or Restore defaults to reset all bindings. Connection switching defaults to Alt+PageDown / Alt+PageUp. Copy, paste and terminal search apply inside the terminal. Paste retains its normal confirmation and editing flow.

Save named presets, duplicate, rename, edit or delete them. Preset contents are included in Sync; each browser selects its own preset. Existing bindings migrate once to Imported shortcuts. Editing Default creates a personal preset. Deleting the selected preset restores defaults. Reload after a concurrent edit conflict. Update all synced devices to a version that supports presets because the metadata format has changed. Browser or OS shortcuts may take priority. Native browser paste remains available.

Paste defaults to Ctrl+V (⌘V on Mac); Ctrl+Shift+V also remains available.

Engine

Desktop uses a device-local stable port so bookmarks and the installed web app keep the same URL. It first tries 127.0.0.1:54447, then stores an available fallback if that port is already in use. You may change the port, but must enrol the browser again at the new origin. The native Android app manages its own local port.

Appearance

Use Preferences for:

• System, light, or dark theme
• Japanese or English

Configure the terminal color scheme, font, background, and tint under Settings → Terminal.

Theme and language controls are also available on vault create and unlock screens.

Vault auto-lock

By default, the Vault locks after saved passwords and key passphrases have not been used for 12 hours. Select a value from 1 to 999 and either minutes or hours. Status checks, terminal output, and automatic sync do not extend the timer.

With Do not auto-lock, the Vault stays unlocked until you lock it manually or restart sshc. Use this option only on a device you control.

A passwordless Vault is neither auto-locked nor lockable by hand: it opens when sshc starts and this setting has no effect. The current-password field is hidden when changing protection; adding a password restores auto-lock, that field, and the lock controls.

Terminal

• Maximum concurrent sessions from 1 to 200, with a default of 50
• Engine replay buffer from 16 KiB to 4 MiB, with a default of 256 KiB
• Browser scrollback from 1,000 to 100,000 lines, with a default of 5,000
• Reconnect attempts after a dropped connection and connection-log verbosity
• Font size, color scheme, font, background, and tint
• Copy on select and right-click paste
• Global OSC 52 default
• JIS yen-key to backslash behavior

The engine replay buffer retains bytes in memory so it can replay output when a browser reconnects. Browser scrollback is the separate number of display lines retained by xterm. Neither setting writes terminal output to disk.

OSC 52 and encoding may be overridden per connection. OSC 8 and Kitty keyboard behavior are protocol-driven.

Rendering uses WebGL by default and automatically falls back to the DOM renderer when WebGL is unavailable or a background image is active. If a GPU or browser duplicates characters or leaves visual traces, turn off Use WebGL rendering to always use DOM rendering.

Select Change to open the searchable background image library. The normal settings page shows only the selected image; rename and delete actions live under each image's … menu. sshc stores the uploaded bytes unchanged and does not compress or convert the image.

The library limit defaults to 16 MiB and can be set from 1 to 1024 MiB. Lowering it never removes or recompresses existing images. Large or numerous images increase local storage, encrypted-sync transfer, and memory use.

When an image is renamed, its extension follows the detected format and overall and per-connection references are updated in the same operation. An existing image is never overwritten. Deleting an image clears references to it in the same transaction.

Local shell and notifications

Choose a default shell profile and start directory. Detected choices include PowerShell variants on Windows and available zsh, fish, bash, and similar shells on Unix systems.

Browser notification permission is requested only after an explicit click. Configure the sound and volume used when a terminal program sends a notification through OSC 9/99/777, and test delivery. See Titles and notifications for details.

The application theme, display language, notification sounds, browser registration, the selected shortcut preset, the navigation and connection-list widths, SFTP tab and split state, and the transfer-manager and Home view modes use browser local storage (per device and per browser; never synced). Terminal settings, including the terminal color scheme, font, background, and tint, are stored in workspace metadata together with connection-specific settings. The browser registration token is not stored in the workspace or sync snapshots; the engine keeps only its verification hash, the issue and last-use times, and the engine port. The token is replaced every time the browser re-enters after an engine restart and expires 30 days after its last use. A changed engine port or a presentation of a superseded token revokes the registration, and sshc (or sshc open) issues a fresh URL to register again. At most 16 browsers are registered; the oldest is dropped first. Vault secrets and sync credentials are never written to plaintext settings.