This commit is contained in:
ari committed 2026-10-16 14:28:25 -04:00
1 parent 52ba041313
commit bb7fc1cb44
14 files changed
+1387 -1

No files matched your search

+50 -1
View File
@@ -6,13 +6,16 @@ A small collection of desktop tools built with [Quickshell](https://quickshell.o
for Wayland compositors that speak [niri](https://github.com/YaLTeR/niri) or
[Hyprland](https://hyprland.org/).
It ships two apps:
It ships three apps:
- **app-carousel** — a full-screen launcher carousel. Apps sit in a row; the
one in the middle is selected. Configure it with a JSON file.
- **workspace-manager** — a workspace overview. A carousel of workspace cards
(with a live list of their windows), a bar for renaming the current
workspace, and a 3D "window loop" for picking a window.
- **workspace-badge** — a small box in each bottom corner of every
monitor showing the active workspace's name and color. Click one to rename
the workspace or pick a color.
Everything here is QML. Talking to the compositor goes through its command
line tools (`niri msg`, `hyprctl`), so the code is the same on both.
@@ -66,6 +69,9 @@ SKYG_APP_CAROUSEL=/path/to/app-carousel.json qs -p ./app-carousel
# workspace manager
qs -n -p ./workspace-manager
# workspace badge
qs -n -p ./workspace-badge
```
---
@@ -86,6 +92,9 @@ qs -n -p ./workspace-manager
| `skygqts workspace-manager goto` | Opens the workspace carousel |
| `skygqts workspace-manager windows` | Opens the window loop for the focused workspace |
| `skygqts workspace-manager rename` | Opens the carousel with the name field focused |
| `skygqts workspace-badge` | Shows the workspace badge on every monitor |
| `skygqts workspace-badge --daemon` | Same, but detached from the terminal |
| `skygqts workspace-badge edit` | Opens the badge editor on the focused monitor |
The last four talk to an already-running workspace manager over IPC, so start
it as a daemon first (for example from your compositor's startup):
@@ -112,6 +121,8 @@ qs ipc -p ./workspace-manager call workspace goTo
qs ipc -p ./workspace-manager call workspace openWindowSelection
qs ipc -p ./workspace-manager call workspace openWorkspaceRename
qs ipc -p ./workspace-badge call badge edit
qs ipc -p ./app-carousel call launcher toggle
qs ipc -p ./app-carousel call launcher open
qs ipc -p ./app-carousel call launcher close
@@ -290,12 +301,49 @@ These are toggled by the `livePreviews`, `snapshotPreviewsHyprland`, and
---
## Workspace badge
```sh
skygqts workspace-badge --daemon
```
Two small glass boxes, one in each bottom corner of every monitor. Both
show the name of the workspace active on that monitor (or its number when it
has no name), on a background of that workspace's color. Each box has a round
top corner facing into the screen and curves where it runs into the screen
edges, as if it grows out of the corner.
Click either box to open the editor in the middle of the screen:
- **Rename workspace** — Enter or OK applies the name. An empty name clears
it (on Hyprland it goes back to the number).
- **Color** — pick a swatch, drag along the hue strip, or type a hex value
like `#7aa2f7`. Below it, the **Opacity** slider sets how solid the badge
background is (80% by default). The badge changes right away.
Escape or a click anywhere else closes it.
Colors and opacity are saved per workspace in
`$XDG_STATE_HOME/skygqts/workspace-colors.json` (or
`~/.local/state/skygqts/...`), as entries like
`{ "color": "#ffd60a", "opacity": 0.8 }`. Named workspaces are saved by name,
and the entry moves along when you rename one from the badge. Unnamed
workspaces are saved by id; niri gives out new ids after a restart, so name a
workspace if its color should stick.
On niri, renaming a workspace that has no name first focuses its monitor,
because niri can only point at an unnamed workspace through the focused
monitor.
---
## Theming
Colors, sizes, and animation timings live in one place per app:
- `app-carousel/Theme.qml`
- `workspace-manager/Theme.qml`
- `workspace-badge/Theme.qml`
Edit those files to restyle the carousel, glass effect, hints, and window
loop.
@@ -305,6 +353,7 @@ loop.
```
app-carousel/ # launcher: shell.qml, config, theme, cards
workspace-manager/ # overview: carousel, rename bar, window loop, compositor bridge
workspace-badge/ # corner badge: name, color, rename and color editor
skygqts.nu # the `skygqts` CLI (Nushell)
package.nix # package definition
flake.nix # flake: package, overlay, dev shell