Install Familiar once, then finish setup inside Familiar.
- Native plugin installation opens first-run setup with Windows or Mac controls.
- Backend and window-control downloads show progress, errors and retry in the same screen.
- Verified existing installs skip onboarding; setup and repair remain available in Windows settings.
- Downloaded binaries must match checksums committed in the source.
Install
omarchy plugin add https://github.com/tcballard/omarchy-plugin-familiar-desktop --enableClick Set up Familiar. No second terminal command is needed. Setup requires curl, jq, coreutils, Linux x86_64 and the supported Hyprland ABI. Missing tools and incompatible desktops are reported inside Familiar.
Tested source
Tom tested v0.1.1-rc.4 on the XPS and approved release on 6 October 2026. v0.1.2 updates version metadata, binary pins and release documentation without changing runtime behaviour from that candidate. The rebuilt backend passes the committed checksum check.
Exact stable source: 9b948cd4d80e002eff88698d752f08268934b93c.
Supported target: Omarchy Quattro, Linux x86_64, Hyprland 0.56.2 commit efb50993780079460b0cbed1363e2166a2de1d9f, ABI efb50993780079460b0cbed1363e2166a2de1d9f_aq_0.15_hu_0.14_hg_0.5_hc_0.1_hlg_0.6. Other ABIs are refused. Exhaustive monitor/scaling/lifecycle coverage and marketplace approval are not claimed.
Remove
bash ~/.config/omarchy/plugins/io.github.tcballard.familiar-desktop/uninstall.shRemoval restores tracked windows and removes owned configuration, retaining personal settings and backups. Settings navigation/scrolling remains a follow-up in #28.