Saltbush Terminal

What it does

Screenshots

Installing

Windows

Download and run saltbush-1.8.2-windows-x64-setup.exe. It installs for your user and adds Saltbush Terminal to the Start menu. For a portable copy, extract the Windows ZIP and run Saltbush Terminal/saltbush.exe. Python scripts need Python 3 from python.org; Lua is built in. For the SSH agent window, start the "OpenSSH Authentication Agent" Windows service.

Linux

Download the Debian package and run these commands in its download folder:

sudo apt install ./saltbush_1.8.2_amd64.deb
saltbush

The package needs Ubuntu 24.04, Debian 13 or newer. On other distributions use the tar archive: extract it and run ./install.sh, which installs for your user only.

Updates

From version 1.5.0, Saltbush checks this site once a day and tells you when a new version is out. Update Now downloads it, checks its checksum and installs it: the Debian package asks for your password, and the Windows installer runs and Saltbush closes. Portable copies open this page instead. Help → Check for Updates checks at any time, and the notices can be turned off. Version 1.4.0 and older have no update check, so install 1.5.0 by hand once.

More detail: installing, updates and troubleshooting.

Your first session

1. Choose File → New Session…, pick a protocol and enter the connection details. For a BBS, choose Tools → New BBS Session… instead.
2. Give the session a name and a folder. It appears in the Session Manager.
3. Double-click the name to connect. For SSH, check a new server's fingerprint and answer the password or passphrase question in the terminal.

Right-click sessions for Properties…, Apply BBS Settings…, Duplicate and Delete…. Ctrl+click selects several sessions to change together. Application shortcuts use Ctrl+Shift, so Ctrl keys reach the terminal.

Sessions guide →

Documentation

• Overview and quick start
• Installing, updates and troubleshooting
• Sessions, SSH and options
• BBSes, Zmodem and the SyncTERM list
• Python and Lua scripting
• Building from source
• Version history

Offline copies: README, scripting guide and limitations.

Downloads

Version 1.8.2. Free downloads for 64-bit Windows and Linux.

To check downloaded files, put SHA256SUMS in the same folder and run sha256sum -c SHA256SUMS --ignore-missing.

Bot scripts (experimental)

Two door-game bots written in Lua for the SyncTERM-Lua fork. They run unchanged in Saltbush Terminal, Lantern Terminal and SyncTERM-Lua.

Run a bot

1. Make the BBS session with Tools → New BBS Session… (Telnet or RLogin) and put your BBS user name in Username.
2. Log in and enter the game. Start the LORD bot at the "Enter the realm" menu or in the Town Square; start the TradeWars bot at the sector Command prompt.
3. Choose Script → Run… and pick the script. Its progress appears in the Activity pane. Script → Cancel stops it at any time.

Each bot keeps its log, and the TradeWars bot its map, in the folder the script is in. Run one bot per character.

Release notes and scope

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.

1.8.2 adds:

• Copy Public Key to Server (Tools menu, or right-click an SSH session): like ssh-copy-id, it logs in once with your password, adds your key to ~/.ssh/authorized_keys with the permissions SSH requires, skips a key that is already there, and checks that the key then logs in on its own.
• Clearer window edges: windows inside Saltbush have a darker border and a shadow, the SFTP browser's two sides are each in an outlined box, and each new browser opens offset from the last.

1.8.1 fixed: Tear-off tabs on Windows with several monitors: a tab dragged out could open its window off the screen (it looked minimised), and dragging it back often did not dock. Window positions are now worked out in screen pixels, and a new window opens where the tab was dropped.

1.8.0 added:

• Tear-off tabs: drag a tab down out of the tab bar to give it its own window; the session keeps running. Dock it back with "Dock to Main Window", by closing the window, or by dragging it onto the tab bar (not on Wayland). Right-click a tab for Move to New Window.
• RDP sessions: connect to Windows Remote Desktop in a normal tab (TLS with Network Level Authentication), with the desktop fitted to the tab, keyboard and mouse, text clipboard, Ctrl+Alt+Del and Windows key buttons, and a remembered server certificate. You can also use the system RDP program (FreeRDP or mstsc) instead.

1.7.0 added:

• Function keys: F1 Help, F2 Session Options, F3 / Shift+F3 Find next / previous, F4 Quick Connect, F5 Reconnect, F6 next pane, F7 SFTP Browser, F8 send a file, F9 logging, F11 full screen, F12 run a script (Shift+F12 cancel, Ctrl+F12 run the last one again). F10 and Alt+F1 to Alt+F12 go to the remote program, and a session option gives it all of them.
• SSH: jump hosts and Ed25519 certificates in the built-in engine, about 40 OpenSSH -o options, and "Use FIPS-approved algorithms only" (it limits algorithms; Saltbush is not a FIPS 140 validated module).
• Sync between computers through a shared folder such as Nextcloud, Syncthing or Dropbox: sessions, folders, credential user names, button bars and the default session. Passwords are never synced.
• Terminal: sixel graphics, double-width and double-height lines, left/right margins, real 132-column mode, selective erase and 8-bit C1 controls.
• Easier settings: highlighting and key mappings in tables with a colour picker and a "press a key" button; Script > Run remembers the last script; after an update the window comes back as it was.
• macOS: the source now supports macOS and includes a build script for a Mac with Homebrew. It has not been tried on a Mac yet, so there is no Mac download.

1.6.1 made scripts much faster and let you copy from the Activity pane. 1.6.0 added:

• A two-pane SFTP browser: this computer on the left, the server on the right. Upload >> and << Download copy the selected files and folders across, and double-clicking a file copies it to the other side. New Folder, Rename and Delete work on both sides.
• Resumed transfers: an interrupted upload or download continues where it stopped the next time you send the same file, as long as the original has not changed.
• Permissions: tick read, write and run for owner, group and others on server files and folders.
• Transfers keep the modification time, and uploads from Linux keep the file's permissions.

1.5.0 added update notifications (a daily check with Update Now, Not Now and Skip This Version, and Help → Check for Updates) and fixed pasting on Wayland desktops. 1.4.0 added split panes, the SFTP browser, the SSH agent window with smartcard support, X11 and agent forwarding, certificate and Kerberos logins in the built-in SSH engine, built-in Xmodem, Ymodem and Kermit, fuller VT220 emulation and the Wyse 60 and SCO ANSI terminal types. See the version history for everything.

Checked with 208 automated tests (including an RDP test server): SSH against a private OpenSSH server (key, certificate and agent logins, agent and X11 forwarding, forwards, compression), the SFTP browser against the same server (also through jump hosts), password and keyboard-interactive logins, remote and SOCKS forwards, FIPS mode and Ed25519 certificates, Xmodem, Ymodem and Kermit against lrzsz, gkermit and C-Kermit, smartcard keys with a software token (SoftHSM), the update check against a test release, plus Telnet, RLogin, serial over a pseudo-terminal, Zmodem and real Python and Lua scripts. The Windows build was checked under Wine and on Windows Server 2022, where it needs a graphics driver with OpenGL 2.0 to open its window. A real BBS was checked over Telnet. Kerberos was not tested against a real Kerberos server, and updating through the Windows installer has not been tried yet (updating the Linux package has). Read the limitations before relying on it.

Source and licence

Written in Rust with egui, libssh and Lua. Saltbush Terminal is free software under the MIT licence; bundled components keep their own licences (vt100, the VGA font, libssh, OpenSSL, zlib). The scripting modules are adapted from Lantern Terminal.

Build instructions · MIT licence

Questions and bug reports: slaterm@theiguru.au.