Files
nexus/README.md
T
Andy Dixon d25746bb14 feat: RDP profiles, sessions and viewer
- Protocol::Rdp with RdpConfig (domain, password mode, certificate
  policy, TLS-only fallback, fixed or tab-sized resolution, SOCKS5/HTTP
  proxy, SSH tunnel); migration 008 adds rdp_config and drops the
  protocol CHECK constraint so new protocols no longer need a rebuild.
- Session manager: connect_rdp dials directly, via the shared proxy
  module (proxy password from the secret store) or an SSH tunnel; the
  server certificate goes through the known-hosts check (key type
  rdp-tls); a tab-sized desktop uses the tab's reported pixel size, and
  resizes wait until the server opens Display Control. Rejected NLA
  passwords count as auth failures, so a saved one is asked again.
- The VNC viewer becomes DesktopView for both protocols; a small adapter
  turns its keysyms and pointer masks into RDP scancodes, Unicode keys,
  buttons and wheel events. For RDP, Paste Clipboard types the text.
- Profile editor RDP section, Quick Connect, badges, docs.

Verified against xrdp in the app: logon, desktop, input, and connections
through SOCKS5 and HTTP CONNECT relays. Not verified here: Windows/NLA
servers, the SSH tunnel route, and Display Control resizing (xrdp
0.9.24 never opened the channel).
2026-10-12 11:14:39 +01:00

3.9 KiB
Raw Permalink Blame History

Nexus Terminal

A native desktop client for SSH, Telnet, RAW TCP, Serial, VNC, RDP, IRC, GitHub and local terminals — with secure credential handling and a focused, multi-session workflow.

Nexus Terminal helps you manage many connections at once, keep terminal work organised, and move files with confidence. It is a single Rust application with no webview, so it starts quickly and stays responsive under heavy terminal output.

Highlights

  • SSH, Telnet, RAW TCP, Serial, VNC, RDP, IRC, GitHub and local terminal sessions in one app
  • Tabbed sessions with split panes, pinning and drag-to-reorder
  • SFTP browser with drag-and-drop uploads and a permission-aware directory picker
  • SSH jump hosts, SOCKS5/HTTP proxies, local and remote port forwards, agent forwarding and TOTP auto-fill
  • Serial consoles with full line settings (baud, data bits, parity, stop bits, flow control)
  • Native VNC and RDP viewers; RDP with NLA, certificate pinning, and SOCKS5/HTTP proxy or SSH tunnel routes
  • Disconnected overlay with one-click reconnect, and auto-reconnect with backoff
  • Broadcast input, snippets, trigger rules and terminal search
  • Session recording (asciicast v2) and playback
  • Secure credential storage with the OS keychain first and an encrypted vault fallback

Quick start

  1. Launch Nexus Terminal.
  2. Click + at the bottom of the sidebar (or press Cmd+N / Ctrl+N) and create a connection profile.
  3. Click Create & Connect to save it and open a session in a new tab. Afterwards, click the profile in the sidebar to connect.

Prefer a one-off session? Use Cmd+Shift+Q / Ctrl+Shift+Q to quick connect, or click Local Machine in the sidebar for a local shell.

If a session drops, use the Reconnect button in the disconnected overlay.

Documentation

Keyboard shortcuts

All shortcuts use Cmd on macOS and Ctrl on Windows/Linux.

macOS Shortcut Windows/Linux Shortcut Action
Cmd + K Ctrl + K Open command palette
Cmd + N Ctrl + N New connection
Cmd + W Ctrl + W Close current tab
Cmd + Tab Ctrl + Tab Next tab
Cmd + Shift + Tab Ctrl + Shift + Tab Previous tab
Cmd + 1–9 Ctrl + 1–9 Switch to tab by number
Cmd + , Ctrl + , Open settings
Cmd + F Ctrl + F Find in terminal
Cmd + Shift + D Ctrl + Shift + D Split pane right (side by side)
Cmd + Shift + E Ctrl + Shift + E Split pane down (top and bottom)
Cmd + Shift + R Ctrl + Shift + R Toggle session recording
Cmd + Shift + B Ctrl + Shift + B Toggle broadcast input mode
Cmd + Shift + S Ctrl + Shift + S Open snippet library
Cmd + Shift + Q Ctrl + Shift + Q Quick connect
F11 F11 Toggle fullscreen

Building from source

Nexus Terminal is a Rust workspace in rust/. With rustup installed:

cd rust
cargo run --release

See docs/build-and-release.md for platform prerequisites, tests and release packaging.