tcballard/omarchy-plugin-familiar-desktop v0.1.1

Familiar Desktop v0.1.1

on GitHub

Familiar v0.1.1 makes everyday window handling feel more familiar—and fixes the installer hiccup from v0.1.0.

• Resize with the mouse. Enable border and corner dragging without holding a modifier.
• Choose Floating or Tiling. Apply the mode to eligible open windows and new ones. Fullscreen, pinned, grouped and hidden windows are skipped.
• Keep familiar controls close. Opt-in Command editing shortcuts, trackpad gestures and smoother dock cycling join more precise window focus and restore.
• Install through shell reloads. Setup retries transient “Target not found” responses while still reporting persistent failures.
• Verify the bytes you run. Backend and Hyprbars downloads must match digests committed in the reviewed source. Replacing a release binary and its neighbouring checksum together no longer passes verification.

The maintainer tested rc.3 on the XPS and approved this exact source for v0.1.1: a3d54f36d9f702e25c8424ad2cd4028f09f9999f. No runtime or UI changes were made after that acceptance. Required CI and release builds passed; this does not claim exhaustive multi-monitor/scaling coverage or marketplace approval.

Known follow-up: Settings has become too long and needs less scrolling. That cleanup is tracked in #28 for a later release.

Install or update

Run in an Omarchy Quattro terminal. Restore minimised windows first. This verifies the installer against the digest of the accepted build before running it:

(
  set -euo pipefail
  familiar_setup="$(mktemp -d)"
  cd "$familiar_setup"
  curl -fL --retry 3 https://github.com/tcballard/omarchy-plugin-familiar-desktop/releases/download/v0.1.1/install.sh -o install.sh
  echo "2a68b44fa80daff10af116edb43a8b43cfbdc08a8ef8520c39d2b51239dfa083  install.sh" | sha256sum --check --strict
  bash install.sh windows
  omarchy restart shell
)

Use mac for left-side controls. No GitHub login or compiler is required. Missing download tools may prompt for a package-manager password. Settings repair uses the installed checkout and the same source-pinned binary digests.

Supported target: Linux x86_64, Omarchy Quattro, Hyprland 0.56.2 commit efb50993780079460b0cbed1363e2166a2de1d9f, ABI efb50993780079460b0cbed1363e2166a2de1d9f_aq_0.15_hu_0.14_hg_0.5_hc_0.1_hlg_0.6. Unsupported ABIs are refused. Command aliases are opt-in; custom terminal classes require review.

Remove with:

bash ~/.config/omarchy/plugins/io.github.tcballard.familiar-desktop/uninstall.sh

Removal restores tracked windows and resets owned compositor preferences, retaining personal settings and backups. Existing v0.1.0 tags/assets remain unchanged. The source archive retains the preparation checklists; this release records the subsequent maintainer acceptance.

Full changes