Kalgoorlie Retro Docs

Documentation for the Kalgoorlie Retro BBS, its games and servers

User Tools

Site Tools


saltbush:building

This is an old revision of the document!


Building Saltbush Terminal from source

Saltbush Terminal is written in Rust. Download saltbush-1.6.1-source.tar.gz from the download page.

Linux

Install Rust (rustup), a C compiler and the libssh development files (libssh-dev on Debian/Ubuntu), then:

tar xf saltbush-1.6.1-source.tar.gz
cd saltbush-1.6.1-source
cargo test
cargo build --release
./target/release/saltbush

scripts/build-packages.sh makes the Debian package and the tar archive.

Windows (cross-compiled on Linux)

scripts/build-windows.sh builds the Windows installer and ZIP with the x86_64-pc-windows-gnu Rust target, mingw-w64 and NSIS. It needs libssh, OpenSSL and zlib built for Windows; scripts/windows-env.sh says where they are expected.

What is in the source

  • src/ — the program (terminal, connections, SSH engine, Zmodem, scripting API, Lua runner, user interface).
  • scripting/ — the Python and Lua modules given to scripts.
  • vendored/vt100 — the terminal parser with Saltbush's changes listed in SALTBUSH-PATCHES.md.
  • examples/ — sample scripts.

Saltbush Terminal is free software under the MIT licence.

saltbush/building.1794269201.txt.gz · Last modified: by slaterm