Fathom 0.3.0

Fathom draws your wallpaper behind the field, follows Omarchy's look (square corners on a stock install), reads a [fathom] section in shell.toml and knows where Alt is under every XKB option, with work from @WhoIsCalebBrown, @caniswim, @CJKaufman and @nixfred:

• Your Omarchy wallpaper sits behind the field, under the theme's veil
  (a little thinner than before, still held to the same contrast floors),
  and a new wallpaper shows the next time the field opens. It loads only
  while the field is shown, so a quick Alt+Tab decodes nothing, and
  fades in once it is ready. By WhoIsCalebBrown (#8).
• Corners and borders follow Omarchy's appearance: the corner radius is
  Hyprland's decoration:rounding (square on a default Omarchy), and idle
  borders take the shell's [controls] border width. A [fathom] section
  in ~/.config/omarchy/shell.toml (corner-radius, border-width)
  overrides both for Fathom alone and updates live. The radius sets the
  front card's corner and the rest keeps Fathom's proportions to it; the
  selection stays heavier than the idle border at any width. By caniswim
  (#7).
• show-scratchpads = false in the same [fathom] section leaves
  scratchpads out of the Deep, live; the map still shows them, and Alt+Tab
  passes over a hidden one. By CJKaufman (#5).
• omarchy-shell fathom state says whether the hold-mode watchdog is
  running (watchdog), so a switch stuck in hold mode, or one that runs
  unwatched, shows from the shell. By nixfred (#3).
• Letting go of Alt follows every XKB option that moves Alt or takes it
  off a key, 26 of them, among them compose:ralt, grp:toggle and
  lv3:lalt_switch, and any two together come out as XKB has them,
  whatever order they are written in. altwin:ctrl_alt_win puts Alt on
  the Windows keys, not on Ctrl as Fathom had it. The Lua tests check every
  option and every pair against xkbcli. By nixfred (#4).
• Installing takes two steps, and the README says so right under the
  command: --enable loads the overlay but leaves Alt+Tab where it was
  until Fathom's block is in bindings.lua. Another switcher (altswitch,
  Woogy7's Workspace Switcher) can stay, with Fathom's block after it, and
  has Alt+Tab back once Fathom is disabled or removed. Troubleshooting
  starts with this case, and load-bindings --check says what is missing
  when Fathom is enabled but does not hold Alt+Tab. Reported by
  mightywomble (#6).

In omakit's disposable Omarchy 4.0.4 guest, with real keys, on 0.3.0: the whole scenario suite, two options that move Alt in both orders, the watchdog in the state, and load-bindings --check right after --enable.

Update:

omarchy plugin update io.github.mtolhuys.fathom

New here? Install in two steps:

1. omarchy plugin add https://github.com/mtolhuys/fathom --enable loads the overlay.
2. The Alt+Tab block from the README's "Install", at the end of ~/.config/hypr/bindings.lua, gives Alt+Tab to Fathom.

fathom-demo.gif is the same demo as a GIF, to share.