Kalgoorlie Retro Docs

Documentation for the Kalgoorlie Retro BBS, its games and servers

User Tools

Site Tools


saltbush:sessions

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
saltbush:sessions [2026-11-10 01:22] – Saltbush Terminal 1.7.0 guides slatermsaltbush:sessions [2026-11-10 05:20] (current) – Saltbush Terminal 1.8.1 guides slaterm
Line 10: Line 10:
  
 **View → Split Left/Right** (Ctrl+Shift+E) and **View → Split Top/Bottom** (Ctrl+Shift+O) split the active pane, so several sessions show at once. Click a pane to type in it; it gets a blue border. Drag the bar between panes to resize them; each session gets its own size. Choosing a tab that is already on screen moves to its pane; any other tab, and new sessions, open in the active pane. **View → Close Pane** and **View → Single Pane** undo the split. **View → Split Left/Right** (Ctrl+Shift+E) and **View → Split Top/Bottom** (Ctrl+Shift+O) split the active pane, so several sessions show at once. Click a pane to type in it; it gets a blue border. Drag the bar between panes to resize them; each session gets its own size. Choosing a tab that is already on screen moves to its pane; any other tab, and new sessions, open in the active pane. **View → Close Pane** and **View → Single Pane** undo the split.
 +
 +===== Tear-off tabs =====
 +
 +**Tried on real computers:** tear-off tabs and RDP sessions (new in 1.8.0) have been tried on a Linux desktop and on Windows with several monitors, including two RDP sessions at once.
 +
 +Drag a tab down out of the tab bar to give it its own window. The session keeps running and nothing reconnects. You can also right-click a tab and choose **Move to New Window**, use **Window → Move Tab to New Window**, or the command palette. The new window has a bar with **Dock to Main Window**; closing the window also docks the tab (it does not disconnect). On X11 and Windows you can drag the window's **Drag to the tab bar** handle onto the main window's tab bar. On Wayland that is not possible (programs cannot see window positions), so use the button or close the window. **Window → Dock All Tabs to Main Window** brings every tab back.
 +
 +Several tabs can have their own windows. Keys, function keys and shortcuts act on the window you are typing in. Split panes are in the main window only. Detached windows are not restored after a restart.
  
 ===== Session Options ===== ===== Session Options =====
Line 41: Line 49:
  
 Sessions that need an option the built-in engine does not handle (and agent forwarding on Windows) use the OpenSSH client automatically, and the terminal names the option; and you can choose the OpenSSH client for any session under **SSH2 → SSH engine**. Passwords are never saved. Sessions that need an option the built-in engine does not handle (and agent forwarding on Windows) use the OpenSSH client automatically, and the terminal names the option; and you can choose the OpenSSH client for any session under **SSH2 → SSH engine**. Passwords are never saved.
 +
 +===== RDP (Windows Remote Desktop) =====
 +
 +**Tried on real computers:** tear-off tabs and RDP sessions (new in 1.8.0) have been tried on a Linux desktop and on Windows with several monitors, including two RDP sessions at once.
 +
 +Choose the protocol **RDP** (port 3389) in the New Session wizard, Quick Connect or Session Options. The **RDP** page has the domain, a credential, the desktop size (fit to the tab, which follows the tab's size, or a fixed size), the clipboard switch, **Ignore certificate errors** (off by default) and **Use the system RDP program instead**. A user name may also be written ''DOMAIN\user'' or ''user@domain''.
 +
 +When you connect, Saltbush asks for the password in the tab (unless a credential has one); it is kept only while the tab is open and never saved. The first time, it shows the server's certificate (issued to, issued by, validity and SHA-256 fingerprint) and asks whether to trust it, like an SSH host key; trusted certificates are kept in ''known_rdp_certificates'' in the settings folder, and a changed certificate is refused with a warning.
 +
 +In the tab, all keys go to the remote computer except F11 (full screen); use Saltbush's menus with the mouse. The bar above the desktop has **Ctrl+Alt+Del**, **Windows key** and **Full screen** buttons, and Ctrl+Alt+End also sends Ctrl+Alt+Del. Text copied on either side can be pasted on the other. Find, logging, file transfers and other terminal actions are not available on RDP tabs.
 +
 +**Use the system RDP program instead** starts FreeRDP (Linux) or mstsc (Windows) in its own window. The password goes to FreeRDP on standard input, never on the command line; mstsc asks for it itself.
 +
 +Not supported: Kerberos or smart-card logins, RD Gateway, sound, drives, printers, USB and several monitors. The remote keyboard layout should match yours.
  
 ===== Logs ===== ===== Logs =====
saltbush/sessions.1794273737.txt.gz · Last modified: by slaterm