Skip to content

csshm 0.1.7

Choose a tag to compare

@anarchy89 anarchy89 released this 18 Nov 13:47
· 16 commits to main since this release

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