ssheven/README.md

ssheven

A modern SSH client for Mac OS 7/8/9.

Project status: as of 0.4.0 (see github releases), an actual SSH client with a fixed-size terminal, good enough to run top.

system requirements

• CPU: Any PPC processor, or a 33 MHz 68040 (maybe a 68LC040, maybe 25 MHz).
• RAM: 2MB
• Disk space: 1MB for the fat binary
• System 7.5 recommended, earlier System 7 versions possible with the Thread Manager extension installed
• Open Transport networking required, version 1.1.1 or later recommended

to do

• refactor libssh2 usage to handle errors and centralize network ops
• nicer connection dialog
• password dialog that doesn't show the password
• preferences
• saving/loading connection settings
• key authentication
• check server keys/known hosts/keys
• improve draw speed
• figure out retro68 mcpu issue, improve 68k connection performance (rewrite mbedtls_mpi_exp_mod in assembly)
• font size options
• hook in more libvterm callbacks
• feed more keyboard input to libvterm
• text selection + copy
• color

build

Uses Retro68 and cmake.

Requires mbedtls, libssh2, and libvterm, see my (cy384's) ports of those libraries for details. Note that you need to build/install each for both platforms (m68k and PPC).

• mkdir build && cd build
• cmake .. -DCMAKE_TOOLCHAIN_FILE=/your/path/to/Retro68-build/toolchain/powerpc-apple-macos/cmake/retroppc.toolchain.cmake or cmake .. -DCMAKE_TOOLCHAIN_FILE=/your/path/to/Retro68-build/toolchain/m68k-apple-macos/cmake/retro68.toolchain.cmake
• make

Use Rez to build the fat binary: join the data fork from the PPC version and the resource fork from the m68k version.

I have some build scripts that I'll clean up and publish with the 1.0.0 release.

license

Licensed under the BSD 2 clause license, see LICENSE file.