Skip to content

Releases

csshm 0.1.10

Choose a tag to compare

@anarchy89 anarchy89 released this 18 Nov 18:06

New:

  • csshm --list_screens shows your monitors as csshm numbers them. It prints each monitor's number, name, size and place, plus the area free for windows, written as a value --bounds takes. It opens nothing.

    MONITOR  NAME                     SIZE       PLACE       FREE AREA, AS A --bounds VALUE
    1        DELL S3422DWG            3440x1440  main        1:0,30-3440,1440
    2        Built-in Retina Display  1728x1117  left of 1   2:0,33-1728,1117
    3        DELL S2721DGF            1440x2560  right of 1  3:0,30-1440,2560
    4        -                        1920x1080  below 1     4:0,30-1920,990
    

    Use it to find which number a monitor has for --screen and to pick an area for --bounds: copy the last column as it is or shrink it.

Tested:

  • --bounds, Ctrl-A a and Ctrl-A k from 0.1.8 and 0.1.9 have now been run on four real monitors, with one to the left of the main monitor, one in portrait to its right and one below. All passed, so the note in the 0.1.9 release about --bounds being tried on one screen only no longer applies.

Update with csshm --update or brew upgrade csshm.

SHA-256 of csshm (universal, Apple silicon and Intel):
da038d62da7ea6e686e99d964dd1c9bb94131dc5a4fb7f638c0921d8ba7f5992

csshm 0.1.9

Choose a tag to compare

@anarchy89 anarchy89 released this 18 Nov 16:10

New:

  • --bounds keeps csshm to part of a monitor, which leaves the rest free for something else, such as a browser beside the session:

    csshm --bounds 1:0,30-860,900 web1 web2 web3 web4
    

    The value is the monitor number, then the top-left and bottom-right corners of the area in points, measured from that monitor's own top-left corner. The red master window goes along the bottom of the area. An area that does not fit clear of the menu bar and the Dock is refused, with a message saying what is free. It may be given once per monitor and in the settings file as bounds = ["1:0,30-860,900"]. The README section "Using part of a monitor" has the details.

  • Ctrl-A k clears the scrollback of every host window. What is on screen stays.

--bounds was tested on one screen. It has not yet been tried on monitors placed above, below or beside the main one, so please report anything odd there.

Update with csshm --update or brew upgrade csshm.

SHA-256 of csshm (universal, Apple silicon and Intel):
f5feed18579e18327b80be477a4d22be8f03264aa84f3c4f570d11601a963bd9

csshm 0.1.8

Choose a tag to compare

@anarchy89 anarchy89 released this 18 Nov 15:50

New:

  • Ctrl-A a runs ended hosts again. If some servers could not be reached, perhaps because they were still starting up, press Ctrl-A then a in the red window. Every host whose session has ended is run again in its own place in the grid. The other hosts stay connected, so there is no need to close everything and start over.

Fixed:

  • A settings file or hosts file saved with Windows line endings was not read: the settings file gave an error and every host in the hosts file was refused.
  • Closing the red master window with the mouse left the session's temporary folder behind.
  • A red window resized by hand was put back within a second and every host window was laid out again. It is now left as you put it until you re-tile. When the menu bar or the Dock changes and Terminal resizes it, csshm still puts things right by itself.
  • --tile_x 0 and --tile_y 0 could not switch off a number set in the settings file.
  • With command in the settings file, --ssh, --ssh_args and --remote_command on the command line were silently ignored. They now win for that run and csshm says so.
  • csshm --help still said that windows re-tile when a session ends. Since 0.1.7 that needs Ctrl-A r or --retile auto.

Changed:

  • Each re-tile takes one reading of the monitors, not two, and gives up on a reading that takes more than three seconds.

The README has a new "Known and possible bugs" section and a note for people coming from csshX: ~/.config/csshm/config.toml takes the place of ~/.csshrc.

Update with csshm --update or brew upgrade csshm.

SHA-256 of csshm (universal, Apple silicon and Intel):
a8e2de70d99382c08564416e0c7d8a8eca8cdded1c2db0b712de8e669f89345a

csshm 0.1.7

Choose a tag to compare

@anarchy89 anarchy89 released this 18 Nov 13:47

This version makes csshm work properly on several monitors. It was tested on three and four real monitors at once, including one in portrait and monitors above, below and beside the main one. The README has recordings.

Fixed:

  • Windows sent to any monitor other than the main one landed too high or too low. Terminal measures a window's height from the monitor the window happens to be on, so csshm now places windows a different way that is exact on every monitor.
  • Rows could overlap on some monitors because the menu bar there was not counted.
  • The red master window could end up underneath the Dock. csshm now finds the monitor and edge the Dock is really on, allows for its real size and uses its space when the Dock is set to hide.
  • A re-tile in a running session did not notice that the Dock or the menu bar had been resized, moved, hidden or shown since the session started. Every re-tile now measures the monitors afresh.
  • Terminal could stretch the red window over the bottom of the host windows when the menu bar was switched back on. csshm now puts it back.

Changed:

  • A closed window now leaves a gap and the other windows stay where they are, so nothing moves while you are reading it or reaching for it. Press Ctrl-A r to close the gaps. --retile auto (or retile = "auto" in the settings file) brings back re-tiling by itself. That mode is experimental with more than one monitor.
  • The red window stays open when the last host closes, so a host can be added again from the menu. Ctrl-A x closes it.
  • The red window is on monitor 1 by default, whichever monitors the hosts are on. Before, it followed the first monitor given to --screen.

New:

  • --master_screen N (or master_screen = N in the settings file) puts the red window on another monitor.
  • pkill -USR1 -f 'csshm.*--master' asks for a re-tile from a script or a keyboard shortcut.

csshm works best with the Dock and the menu bar set to hide automatically. It works with both showing too. The README's "Several monitors" section explains the difference.

Update with csshm --update or brew upgrade csshm.

SHA-256 of csshm (universal, Apple silicon and Intel):
926ebac817740dfb5dd578b8c0cff4556c9f5f0e60759f2b3b9a837088632125

csshm 0.1.6

Choose a tag to compare

@anarchy89 anarchy89 released this 18 Nov 07:04

New in this version:

  • --env NAME passes an environment variable from the shell you are in to every host window and --env NAME=VALUE sets one. Host windows are new Terminal windows and do not see what you exported, which matters when ssh depends on a variable, for example AWS_PROFILE for instances reached through AWS Session Manager: csshm --env AWS_PROFILE i-0518b235de43acdcd i-0ba5ca0c58dbfeebb. Names can also be listed in the settings file as env = ["AWS_PROFILE"]. See "Environment variables" in the README.
  • The README now starts with a Quick start.

Update with csshm --update or brew upgrade csshm.

SHA-256 of csshm (universal, Apple silicon and Intel):
43e98419493bf6d7f72937cdc573c036db80c3afd8c26ac8c6611948e37b6515

csshm 0.1.5

Choose a tag to compare

@anarchy89 anarchy89 released this 17 Nov 21:12

New in this version:

  • --command TEMPLATE runs a command in each window in place of ssh, with {} standing for the host, for example csshm --command "docker exec -it {} sh" web api db. {user} and {port} are also available. See "Containers, pods and other commands" in the README.
  • --remote_command_keepalive CMD works like --remote_command, but each window stays open after the command finishes so its output can be read: csshm --remote_command_keepalive "df -h /" web1 web2 web3.

Update with csshm --update or brew upgrade csshm.

SHA-256 of csshm (universal, Apple silicon and Intel):
8f4c6397c984f4451b4eff8fc1fb1d6f8b6fc20f902748bb71b49f6683adae39

csshm 0.1.4

Choose a tag to compare

@anarchy89 anarchy89 released this 17 Nov 20:40

Faster with many windows. Update with csshm --update.

  • Host windows now open already in their grid cells. Before, they opened in a pile and were moved afterwards.
  • A re-tile leaves alone the windows that are already in place. Ctrl-A r still puts every window back.
  • Enable all, toggle all, hide, the font keys and re-tile are much quicker with dozens of windows.

Install:

curl -fsSL https://raw.githubusercontent.com/anarchy89/csshm/main/setup.sh | sh

SHA-256 of the attached csshm binary (Apple silicon and Intel, macOS 13 or later):

aa5c43b20b5b7b3d581a1ee9d5878a0bfcd98b0bf2fe404fef8e8e03f74a59fa

csshm 0.1.3

Choose a tag to compare

@anarchy89 anarchy89 released this 17 Nov 20:40

A clearer error message. Update with csshm --update.

  • A command in a hosts file that contains a control character is now reported as a bad command for that host. Before, it was reported as a bad host.

Install:

curl -fsSL https://raw.githubusercontent.com/anarchy89/csshm/main/setup.sh | sh

SHA-256 of the attached csshm binary (Apple silicon and Intel, macOS 13 or later):

8497bd0d814e4719c8921fc9068bf8f1c7d11ccb8a59eac6f6a92bb856e8f3dd

csshm 0.1.2

Choose a tag to compare

@anarchy89 anarchy89 released this 17 Nov 20:40

Security hardening. Update with csshm --update.

  • Host names and users are limited to characters that mean nothing to a shell or a terminal. Control characters are refused in hosts, users, key paths and per-host commands.
  • Scrollback dump files are readable by their owner only.
  • The installer script does nothing if its download is cut short.
  • The README has a new Security section.

Install:

curl -fsSL https://raw.githubusercontent.com/anarchy89/csshm/main/setup.sh | sh

SHA-256 of the attached csshm binary (Apple silicon and Intel, macOS 13 or later):

1c0c9b551d72e6112bb19ed8babbc48bdf305104dae7aa8b331f1b38e347b96d

csshm 0.1.1

Choose a tag to compare

@anarchy89 anarchy89 released this 17 Nov 20:40

First release of csshm, a cluster SSH tool for macOS Terminal.

Install:

curl -s https://raw.githubusercontent.com/anarchy89/csshm/main/setup.sh | sh

The attached csshm file is a single binary for Apple silicon and Intel Macs running macOS 13 or later. See the README for how to use it.