mirrors
/
ssheven
mirror of https://github.com/cy384/ssheven.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
ssheven/README.md

3.1 KiB
Raw Blame History

ssheven box

ssheven

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

Project status: as of 0.6.1 (see github releases), a functional (but not completely secure) SSH client with color terminal emulation, able to login via key or password. See roadmap below for upcoming work (i.e., things that aren't done yet).

ssheven screenshot

system requirements

  • CPU: Any PPC processor, or at least a 25 MHz 68040/68LC040. Presently, all 68030/68020 CPUs are too slow.
  • RAM: 2MB.
  • Disk space: 1MB for the fat binary.
  • System 7.5 or later, earlier System 7 versions might be possible with the Thread Manager extension installed.
  • Open Transport networking required, version 1.1.1 or later recommended.

feature/bug-fix roadmap

0.7.0

  • color mode (bright/dark), terminal type (monochrome, color, etc.) options
  • preferences file (save key locations, known hosts/keys, most recent host+port+(key or password choice), color prefs)
  • check server keys/known hosts/keys

0.8.0

  • hook scrolling into vterm to reduce redraws
  • saving/loading connection settings as a filetype
  • font face and size options

0.9.0

  • clean up libssh2 network ops (write fn, read safety, don't allow send until connected, quit while connected lockup)
  • read Apple HIG and obsessively optimize placement of all GUI elements
  • nicer error presentation for more failure cases

1.0.0 (first "real" release)

  • fix up keycode translation (especially control combos)
  • RNG improvements
  • solve 68k crashes/finicky build issues (retro68 issue)

?.?.?

  • scp file transfer
  • initial key exchange is too slow for 68030 and 68020 systems (improve mbedtls_mpi_exp_mod)
  • console draw speed is slow/flickery (big refactor, try to use an "offscreen graphics world" framebuffer)
  • text selection + copy
  • more complete color support (will need to use color quickdraw, currently uses an 8-color hack for traditional quickdraw)
  • preference file on OS 9 doesn't have the icon
  • clean up/update versions of libssh and mbedtls

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.

note to self: binary resources can be extracted in MPW via: DeRez "Macintosh HD:whatever" -skip "'CODE'" -skip "'DATA'" -skip "'RELA'" -skip "'SIZE'" etc., this is especially useful for icons

license

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