Kalgoorlie Retro Docs

Documentation for the Kalgoorlie Retro BBS, its games and servers

User Tools

Site Tools


saltbush:start

Differences

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

Link to this comparison view

Next revision
Previous revision
saltbush:start [2026-11-09 14:40] – Saltbush Terminal 1.3.1 guides slatermsaltbush:start [2026-11-11 14:59] (current) – Saltbush Terminal 1.9.2 guides slaterm
Line 1: Line 1:
 ====== Saltbush Terminal ====== ====== Saltbush Terminal ======
  
-Saltbush Terminal is a tabbed terminal for Windows and Linux with saved sessions in folders. Version 1.3.1 connects over SSH2 (built-in engine or the OpenSSH client), SFTP, Telnet, RLogin, raw TCP, serial ports and local shells. It calls BBSes with a proper DOS screen, the VGA font and Zmodem, and runs Python and Lua scripts. Scripts written for Lantern Terminal and the SyncTERM-Lua fork run unchanged.+Saltbush Terminal is a tabbed terminal for Windows and Linux with saved sessions in folders and split panes. Version 1.9.2 connects over SSH2 (built-in engine or the OpenSSH client), RDP (Windows Remote Desktop), SFTP, Telnet, RLogin, raw TCP, serial ports and local shells, and has a two-pane SFTP browser and an SSH agent window. It has a BBS Directory with the Synchronet BBS List and the Telnet BBS Guide, and calls BBSes with a proper DOS screen, the VGA font, Zmodem, Ymodem, Xmodem and Kermit, and runs Python and Lua scripts. It tells you when a new version is out and can install it for you. Scripts written for Lantern Terminal and the SyncTERM-Lua fork run unchanged.
  
 [[https://retro.theiguru.au/saltbush/|Download installers and source code]] [[https://retro.theiguru.au/saltbush/|Download installers and source code]]
Line 8: Line 8:
  
   - [[saltbush:installing|Install Saltbush Terminal]] and start it.   - [[saltbush:installing|Install Saltbush Terminal]] and start it.
-  - Choose **File → New Session…**, pick a protocol, enter the details and give the session a name and folder. For a BBS choose **Tools → New BBS Session…**.+  - Choose **File → New Session…**, pick a protocol, enter the details and give the session a name and folder. For a BBS, press the **BBS Directory** button (the book on the toolbar), **Update lists** and **Connect**, or choose **Tools → New BBS Session…**.
   - **Double-click** the session in the **Session Manager** to connect.   - **Double-click** the session in the **Session Manager** to connect.
   - For SSH, check a new server's fingerprint before typing **yes**, then answer the password or passphrase question in the terminal.   - For SSH, check a new server's fingerprint before typing **yes**, then answer the password or passphrase question in the terminal.
Line 16: Line 16:
 ===== Guides ===== ===== Guides =====
  
-  * [[saltbush:installing|Installing, upgrading and troubleshooting]]+  * [[saltbush:installing|Installing, updates and troubleshooting]]
   * [[saltbush:sessions|Sessions, SSH and options]]   * [[saltbush:sessions|Sessions, SSH and options]]
-  * [[saltbush:bbs|BBSes, Zmodem and the SyncTERM list]]+  * [[saltbush:sftp|SFTP browser and SSH agent]] 
 +  * [[saltbush:bbs|BBSes, file transfers and the SyncTERM list]]
   * [[saltbush:scripting|Python and Lua scripting]]   * [[saltbush:scripting|Python and Lua scripting]]
   * [[saltbush:building|Building from source]]   * [[saltbush:building|Building from source]]
Line 35: Line 36:
 | Ctrl+Shift+R / Ctrl+Shift+D | Reconnect / disconnect | | Ctrl+Shift+R / Ctrl+Shift+D | Reconnect / disconnect |
 | Ctrl+Shift+W | Close tab | | Ctrl+Shift+W | Close tab |
 +| Ctrl+Shift+E / Ctrl+Shift+O | Split the active pane left/right / top/bottom |
 | Ctrl+Tab / Ctrl+Shift+Tab | Next / previous tab | | Ctrl+Tab / Ctrl+Shift+Tab | Next / previous tab |
 +| F1 | Help (keyboard shortcuts) |
 +| F2 | Session Options |
 +| F3 / Shift+F3 | Find next / previous |
 +| F4 | Quick Connect |
 +| F5 | Reconnect |
 +| F6 | Next split pane |
 +| F7 | SFTP Browser (SSH sessions) |
 +| F8 | Send a file (Zmodem upload) |
 +| F9 | Start or stop session logging |
 +| F10 | Sent to the remote program |
 | F11 | Full screen | | F11 | Full screen |
 +| F12 / Shift+F12 / Ctrl+F12 | Run a script / cancel it / run the last script again |
 +| Alt+F1 … Alt+F12 | Send the plain function key to the remote program |
  
-**Session Options → Input** can make plain Ctrl+C and Ctrl+V copy and paste instead.+**Session Options → Input** can make plain Ctrl+C and Ctrl+V copy and paste instead, and has **Function keys go to the remote program** for programs that need F1–F12 (Midnight Commander, htop and some BBS screens). A key of your own on the **Key Mappings** page wins over the keys above. While a dialog is open only F11 works. Right-click in the terminal for Copy and Paste, and middle-click also pastes. 
 + 
 +**Help → Check for Updates…** looks for a new version (see [[saltbush:installing#updates|Updates]]).
  
 ===== Limits ===== ===== Limits =====
  
-The Windows version has been tested under Wine but not yet on a physical Windows PC. Xmodem and Ymodem need the lrzsz programs and are available on Linux only. The full list is in [[https://retro.theiguru.au/saltbush/download/LIMITATIONS.md|LIMITATIONS.md]].+**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. 
 + 
 +The Windows version has been tested under Wine but not yet on a physical Windows PC. The full list is in [[https://retro.theiguru.au/saltbush/download/LIMITATIONS.md|LIMITATIONS.md]].
  
 Questions and bug reports: slaterm@theiguru.au Questions and bug reports: slaterm@theiguru.au
  
saltbush/start.1794235238.txt.gz · Last modified: by slaterm