app-grid/README.md

19 lines
715 B
Markdown

# app-grid
An app grid for a phone shell on [niri](https://github.com/niri-wm/niri), as a GTK4 layer-shell surface.
It's meant to sit in niri's overview backdrop, behind the workspaces, so it shows up as the overview opens:
```kdl
layer-rule {
match namespace="^app-grid$"
place-within-backdrop true
backdrop-input true
}
```
`place-within-backdrop` on the bottom layer and `backdrop-input` aren't in upstream niri yet.
The grid's position assumes `overview { zoom 0.25; workspace-anchor 0.15; }`, see the constants at the top of `grid.js`.
Launching an app opens a splash window with its icon until the app's window opens, using `niri msg event-stream`. Set `NIRI_BIN` if `niri` isn't on `PATH`.