Repository navigation
Releases
csshm 0.1.10
New:
-
csshm --list_screensshows 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--boundstakes. 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,990Use it to find which number a monitor has for
--screenand to pick an area for--bounds: copy the last column as it is or shrink it.
Tested:
--bounds, Ctrl-Aaand Ctrl-Akfrom 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--boundsbeing 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
New:
-
--boundskeeps 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 web4The 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
kclears 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
New:
- Ctrl-A
aruns ended hosts again. If some servers could not be reached, perhaps because they were still starting up, press Ctrl-A thenain 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 0and--tile_y 0could not switch off a number set in the settings file.- With
commandin the settings file,--ssh,--ssh_argsand--remote_commandon the command line were silently ignored. They now win for that run and csshm says so. csshm --helpstill said that windows re-tile when a session ends. Since 0.1.7 that needs Ctrl-Aror--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
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
rto close the gaps.--retile auto(orretile = "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
xcloses 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(ormaster_screen = Nin 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
New in this version:
--env NAMEpasses an environment variable from the shell you are in to every host window and--env NAME=VALUEsets one. Host windows are new Terminal windows and do not see what you exported, which matters when ssh depends on a variable, for exampleAWS_PROFILEfor instances reached through AWS Session Manager:csshm --env AWS_PROFILE i-0518b235de43acdcd i-0ba5ca0c58dbfeebb. Names can also be listed in the settings file asenv = ["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
New in this version:
--command TEMPLATEruns a command in each window in place of ssh, with{}standing for the host, for examplecsshm --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 CMDworks 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
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
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
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
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.