ssheven/README.md

![ssheven box](http://www.cy384.com/media/img/ssheven_box_front_small.png)

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

Project status: as of 0.8.0 ([see github releases](https://github.com/cy384/ssheven/releases)), a functional SSH client, able to connect via key or password.  Versions prior to 1.0.0 are alpha/beta quality.

![ssheven screenshot](http://www.cy384.com/media/img/ssheven-0.6.1-screenshot.png)

system requirements
-------------------
* CPU: Any PPC processor, or at least a 25 MHz 68040/68LC040.  Presently, all 68030 and 68020 CPUs are too slow.
* RAM: 2MB.
* Disk space: 1MB for the fat binary.
* System 7.5 or later, possibly earlier System 7 with the Thread Manager extension.
* Open Transport networking required, latest version possible highly recommended.

roadmap
-------
0.9.0
* general ssheven code cleanup
* select words on double click
* font face and size options

1.0.0 (first "real" release)
* nicer error presentation for more failure cases
* add `known_hosts` reset option
* read Apple HIG and clean up UI/UX
* license info in an about box type thing
* finish and upload papercraft box, floppy sticker artwork, icon/logo svg
* configurable terminal string

known bugs
* initial key exchange is too slow for 68030 machines (improve `mbedtls_mpi_exp_mod` and BN assembly) (needs 5x speed improvement for 68030)
* input latency feels high because redrawing the screen is slow
* receiving a large amount of data breaks the channel (e.g. `cat /dev/zero`)
* excessive redraws/flicker while selecting
* non-US keyboard input has issues
* custom colors are a little wonky

possible upcoming features
* scp file transfer
* more complete color support (currently uses an 8-color hack)
* keyboard-interactive authentication

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).

To build a fat binary, edit `build-ssheven.bash` with the path to your Retro68 build, and then run it.

license
-------
Licensed under the BSD 2 clause license, see `LICENSE` file.
extensive changes to everything implement my own terminal implement my own gui event loop add a first configuration dialog resource 2020-07-17 02:32:31 +01:00			`![ssheven box](http://www.cy384.com/media/img/ssheven_box_front_small.png)`

init 2020-06-08 17:53:38 +01:00			`ssheven`
			`-------`
add check and warnings/errors for CPU type 2020-07-25 23:57:03 +01:00			`A modern SSH client for Mac OS 7/8/9.`
init 2020-06-08 17:53:38 +01:00
update readme 2021-01-23 18:22:35 +00:00			`Project status: as of 0.8.0 ([see github releases](https://github.com/cy384/ssheven/releases)), a functional SSH client, able to connect via key or password. Versions prior to 1.0.0 are alpha/beta quality.`
init 2020-06-08 17:53:38 +01:00
update readme with notes and new roadmap 2020-09-30 04:06:30 +01:00			`![ssheven screenshot](http://www.cy384.com/media/img/ssheven-0.6.1-screenshot.png)`
add screenshot 2020-08-06 04:27:28 +01:00
readme update with system requirements 2020-07-21 06:10:47 +01:00			`system requirements`
			`-------------------`
bump version to 0.8.3, update readme 2020-12-28 02:49:57 +00:00			`* CPU: Any PPC processor, or at least a 25 MHz 68040/68LC040. Presently, all 68030 and 68020 CPUs are too slow.`
update readme with notes and new roadmap 2020-09-30 04:06:30 +01:00			`* RAM: 2MB.`
			`* Disk space: 1MB for the fat binary.`
add build script and update readme 2021-01-09 23:17:24 +00:00			`* System 7.5 or later, possibly earlier System 7 with the Thread Manager extension.`
			`* Open Transport networking required, latest version possible highly recommended.`
readme update with system requirements 2020-07-21 06:10:47 +01:00
update readme 2021-01-23 18:22:35 +00:00			`roadmap`
			`-------`
update readme with notes and new roadmap 2020-09-30 04:06:30 +01:00			`0.9.0`
bump version 2020-10-11 01:07:32 +01:00			`* general ssheven code cleanup`
update readme 2021-01-23 18:22:35 +00:00			`* select words on double click`
			`* font face and size options`
update readme with notes and new roadmap 2020-09-30 04:06:30 +01:00
			`1.0.0 (first "real" release)`
update roadmap in readme 2020-10-04 17:21:39 +01:00			`* nicer error presentation for more failure cases`
update readme 2021-01-23 18:22:35 +00:00			* add `known_hosts` reset option
			`* read Apple HIG and clean up UI/UX`
update roadmap in readme 2020-10-04 17:21:39 +01:00			`* license info in an about box type thing`
			`* finish and upload papercraft box, floppy sticker artwork, icon/logo svg`
update readme 2021-01-23 18:22:35 +00:00			`* configurable terminal string`
update readme with notes and new roadmap 2020-09-30 04:06:30 +01:00
bump version to 0.8.3, update readme 2020-12-28 02:49:57 +00:00			`known bugs`
update readme 2021-01-23 18:22:35 +00:00			* initial key exchange is too slow for 68030 machines (improve `mbedtls_mpi_exp_mod` and BN assembly) (needs 5x speed improvement for 68030)
			`* input latency feels high because redrawing the screen is slow`
bump version to 0.8.3, update readme 2020-12-28 02:49:57 +00:00			* receiving a large amount of data breaks the channel (e.g. `cat /dev/zero`)
update readme 2021-01-23 18:22:35 +00:00			`* excessive redraws/flicker while selecting`
			`* non-US keyboard input has issues`
			`* custom colors are a little wonky`
bump version to 0.8.3, update readme 2020-12-28 02:49:57 +00:00
			`possible upcoming features`
update roadmap in readme 2020-10-04 17:21:39 +01:00			`* scp file transfer`
update readme 2021-01-23 18:22:35 +00:00			`* more complete color support (currently uses an 8-color hack)`
update roadmap in readme 2020-10-04 17:21:39 +01:00			`* keyboard-interactive authentication`
add check and warnings/errors for CPU type 2020-07-25 23:57:03 +01:00
init 2020-06-08 17:53:38 +01:00			`build`
			`-----`
			`Uses Retro68 and cmake.`

update readme 2020-08-22 22:39:03 +01:00			`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).`
init 2020-06-08 17:53:38 +01:00
add build script and update readme 2021-01-09 23:17:24 +00:00			To build a fat binary, edit `build-ssheven.bash` with the path to your Retro68 build, and then run it.
bump version to 0.5.0 2020-09-06 21:06:00 +01:00
init 2020-06-08 17:53:38 +01:00			`license`
			`-------`
update readme 2021-01-23 18:22:35 +00:00			Licensed under the BSD 2 clause license, see `LICENSE` file.
extensive changes to everything implement my own terminal implement my own gui event loop add a first configuration dialog resource 2020-07-17 02:32:31 +01:00