First release / 1 Oct 2026 / with v0.2.0, v0.2.1, v0.2.2

Fathom v0.3.0

Switch to earlier windows through a recency-ordered stack with a map of your workspaces.

Before you upgrade to v0.3.0

In v0.3.0, the header counts only windows shown in the stack and workspaces containing them, excluding closed windows and hidden scratchpads.

Behavior changedSwitch windows through a stack ordered by how recently you used them.Inferred

Read the evidence

What changed in v0.3.0

The grouped v0.2.0–v0.3.0 launch provides Alt+Tab navigation, workspace maps and text filtering, with fixes for remapped Alt, sideways scrolling and literal labels. v0.3.0 adds wallpaper, live `[fathom]` settings and watchdog state reporting.

Also: Search windows, select by age, skip scratchpads, match the desktop appearance and inspect switching from the shell; includes keyboard and title-handling fixes.

v0.3.0: Omarchy 4.0+, Quickshell 0.3+, Qt 6.9+, Hyprland 0.56+. Install with `omarchy plugin add https://github.com/mtolhuys/fathom --enable`, then add the README's Lua bindings block last in `bindings.lua`; reload Hyprland after binding updates.

New things you can do

Since v0.2.0, hold `Alt`, navigate with `Tab`, arrows or the wheel, and release to focus; a quick `Alt`+`Tab` skips drawing the overlay.

AddedSwitch windows through a stack ordered by how recently you used them.

Read the evidence

mtolhuys/fathom/blob/v0.2.0/README.md

Type to filter and use `Space` to keep browsing after releasing `Alt`; v0.2.1 also arms the 15-second hold timeout when a chord takes over an empty filter.

AddedFind a window by typing its app, title or workspace and focus the result.

Read the evidence

The v0.2.0 map includes scratchpads, window positions and urgent windows; v0.2.1 makes a sideways fling cross all the workspaces represented by its scroll steps.

AddedLocate windows on a map of workspaces and switch to a workspace's most recent window.

Read the evidence

Since v0.2.0, click or drag the sounding line to select a window by recency; the caption shows its age and depth.

AddedPick a window by how long ago you used it using a clickable depth gauge.

Read the evidence

mtolhuys/fathom/blob/v0.2.0/README.md

v0.2.1 fixes per-keyboard Alt release; v0.3.0 covers 26 Alt-changing XKB options and their pairs, including correcting `altwin:ctrl_alt_win` to use Windows keys. Reload Hyprland after updating bindings.

AddedFinish window switching by releasing Alt on keyboards with remapped modifier keys.

Read the evidence

v0.2.2 displays markup literally without loading embedded remote images, and stops treating window-provided app IDs or classes as icon file paths.

AddedRead window titles, app names, workspace names and filters as literal text.

Read the evidence

mtolhuys/fathom/releases/tag/v0.2.2

v0.3.0 adds wallpaper and a thinner veil; corners now follow Hyprland rounding (square by default) and idle borders follow shell controls. Override `corner-radius` and `border-width` live under `[fathom]` in `shell.toml`.

AddedBrowse windows with your Omarchy theme and wallpaper, with optional corner and border overrides.

Read the evidence

v0.3.0 adds live `show-scratchpads = false` under `[fathom]` in `~/.config/omarchy/shell.toml`; Alt+Tab passes over hidden scratchpads.

AddedSkip scratchpad windows while cycling through the window stack.

Read the evidence

`omarchy-shell fathom open`, `hold` and `release` drive browsing; `state`, `field`, `captures`, `bench` and `stats` inspect it. v0.3.0 adds `watchdog` to `state` and missing-binding advice to `load-bindings --check`.

AddedOpen and control the window overview from custom bindings and inspect its state from the shell.

Read the evidence

Seeded by @iluxav with Codex, from the release's public sources. Each change links to its evidence.