ssheven/README.md

69 lines
3.2 KiB
Markdown
Raw Normal View History

![ssheven box](http://www.cy384.com/media/img/ssheven_box_front_small.png)
2020-06-08 17:53:38 +01:00
ssheven
-------
A modern SSH client for Mac OS 7/8/9.
2020-06-08 17:53:38 +01:00
2020-10-11 01:07:32 +01:00
Project status: as of 0.8.0 ([see github releases](https://github.com/cy384/ssheven/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).
2020-06-08 17:53:38 +01:00
![ssheven screenshot](http://www.cy384.com/media/img/ssheven-0.6.1-screenshot.png)
2020-08-06 04:27:28 +01:00
2020-07-21 06:10:47 +01:00
system requirements
-------------------
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.
* 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.
2020-07-21 06:10:47 +01:00
feature/bug-fix roadmap
-----------------------
0.9.0
2020-10-04 17:21:39 +01:00
* clean up libssh2 network ops (write fn, read safety, don't allow send until connected, quit while connected mess)
* clean up/update versions of libssh and mbedtls (get as close to mainline as possible, revert unecessary changes)
2020-12-28 02:49:57 +00:00
* clean up preferences loading/saving, include key stuff, `known_hosts` reset option
2020-10-11 01:07:32 +01:00
* build/packaging scripts
* general ssheven code cleanup
2020-12-28 02:49:57 +00:00
* text selection + copy
1.0.0 (first "real" release)
2020-12-28 02:49:57 +00:00
* improve RNG
2020-10-04 17:21:39 +01:00
* nicer error presentation for more failure cases
* read Apple HIG and obsessively optimize placement of all GUI elements
* license info in an about box type thing
* finish and upload papercraft box, floppy sticker artwork, icon/logo svg
2020-12-28 02:49:57 +00:00
known bugs
* initial key exchange is too slow for 68030 and 68020 systems (improve `mbedtls_mpi_exp_mod` and maybe the assembly BN code?)
* input latency feels high? related to draw speed/frequency? (maybe try to use an "offscreen graphics world" framebuffer? big refactor)
* receiving a large amount of data breaks the channel (e.g. `cat /dev/zero`)
* preference file loading has issues, especially with the key paths
* hook scrolling into vterm to reduce redraws/blanking
possible upcoming features
2020-10-04 17:21:39 +01:00
* font face and size options
* scp file transfer
* more complete color support (will need to use color quickdraw, currently uses an 8-color hack for traditional quickdraw)
2020-10-04 17:21:39 +01:00
* keyboard-interactive authentication
2020-06-08 17:53:38 +01:00
build
-----
Uses Retro68 and cmake.
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).
2020-06-08 17:53:38 +01:00
* `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`
2020-08-22 22:39:03 +01:00
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.
2020-09-06 21:06:00 +01:00
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
2020-06-08 17:53:38 +01:00
license
-------
Licensed under the BSD 2 clause license, see LICENSE file.