repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by bugabinga

docs(hypr): clarify tooling taxonomy

f07a98bef72e2a07daf801ea9ac1c541437bad62

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (2)

skills/hypr/references/ecosystem-taxonomy.md

Modified
3 3 # Hyprland ecosystem taxonomy
5 5 Goal:
6 6 know what overlaps.
7 7 Prefer `hypr*` when first-party and sufficient.
8 -If user already chose a non-Hypr Wayland tool, preserve that choice unless it
9 -conflicts or is obsolete.
10 8 Use one primary per overlapping category.
12 10 ## Compositor/session
23 21 | File picker portal | xdg-desktop-portal-gtk | xdg-desktop-portal-kde | XDPH does not own file picker |
24 22 | Audio/video graph | PipeWire + WirePlumber | distro-specific PipeWire launcher | required for screen share |
25 23 | Polkit auth | hyprpolkitagent | polkit-kde-agent, GNOME polkit agent | run one agent |
26 -| Notifications | mako / swaync | dunst, fnott | run one daemon; swaync adds notification center |
24 +| Notifications | none first-party | mako, swaync, dunst, fnott | run one daemon; mako=minimal, swaync=center |
28 26 ## Hypr first-party user apps
73 71 | Role | Prefer/typical | Alternatives | Notes |
74 72 | -------------- | ----------------------------- | --------------------- | ------------------------------ |
75 -| Screenshot raw | grim + slurp | hyprshot, HyprCapture | Wayland-native capture |
76 -| Annotate | satty | swappy, Flameshot | Flameshot usually needs portal |
73 +| Screenshot raw | grim + slurp | hyprshot, HyprCapture | grim/slurp are base primitives |
74 +| Annotate | satty | swappy, Flameshot | optional UI after capture |
77 75 | Clipboard | wl-copy/wl-paste | cliphist frontend | Wayland clipboard |
78 76 | Recording | wf-recorder | wl-screenrec, OBS | OBS uses PipeWire/portal |
79 77 | Screenshare | XDPH + PipeWire + WirePlumber | browser/app portal UI | portal config/logs matter |

skills/hypr/references/hypr-tools.md

Modified
1 1 # Hypr tools
3 3 First-party Hypr apps are version-sensitive.
4 -Check installed tool help and the current Hypr wiki before copying config.
4 +Check installed tool help and current Hypr wiki before copying config.
6 -## Common tools
6 +## User apps/utilities
8 -| Tool | Role | Notes |
9 -| ----------------- | ----------------- | --------------------------------------------- |
10 -| `hyprpaper` | wallpaper daemon | one wallpaper daemon per output stack |
11 -| `hyprlock` | lock screen | pair with `hypridle` for idle locking |
12 -| `hypridle` | idle daemon | runs lock/suspend/dim commands on timers |
13 -| `hyprsunset` | gamma/blue-light | avoid running with other gamma filters |
14 -| `hyprpolkitagent` | polkit auth agent | run one polkit agent |
15 -| `hyprpicker` | color picker | Wayland-native picker |
16 -| `hyprlauncher` | launcher | overlaps with fuzzel/walker/wofi/rofi-wayland |
8 +| Tool | Role | Overlaps |
9 +| ----------------------------- | ----------------------- | --------------------------------------------------------- |
10 +| `hyprpaper` | wallpaper daemon | swaybg, wpaperd, swww/awww, mpvpaper |
11 +| `hyprpicker` | screen color picker | wl-color-picker, grim/slurp picker scripts |
12 +| `hyprlauncher` | launcher/picker | fuzzel, walker, rofi-wayland, wofi, tofi, anyrun |
13 +| `hypridle` | idle daemon | swayidle |
14 +| `hyprlock` | lock screen | swaylock, gtklock |
15 +| `xdg-desktop-portal-hyprland` | portal backend | required for Hyprland screencast/global-shortcut features |
16 +| `hyprsysteminfo` | system info GUI | fastfetch, inxi frontends |
17 +| `hyprsunset` | blue-light/gamma | wlsunset, gammastep, compositor shaders |
18 +| `hyprpolkitagent` | polkit auth agent | polkit-kde-agent, GNOME polkit agent |
19 +| `hyprpwcenter` | PipeWire control center | pavucontrol, pwvucontrol, other audio GUIs |
20 +| `hyprshutdown` | graceful shutdown UI | wlogout, rofi/quickshell power menus |
21 +| `hyprland-qt-support` | Qt/Hypr integration | qt platform/theme glue |
22 +| `hyprqt6engine` | Qt6 theme engine | qt6ct, Kvantum, KDE color scheme tooling |
24 +## Dev libs/tooling
26 +| Tool | Role |
27 +| --------------------- | -------------------------------------------------- |
28 +| `hyprtoolkit` | C++ GUI toolkit for native Wayland apps |
29 +| `hyprcursor` | Hypr cursor theme format/support |
30 +| `hyprutils` | shared utility library |
31 +| `hyprlang` | legacy Hypr config language/parser library |
32 +| `hyprwayland-scanner` | Wayland protocol source/header generator |
33 +| `aquamarine` | rendering/backend library |
34 +| `hyprgraphics` | graphics utility library |
35 +| `hyprland-guiutils` | GUI utility helpers/successor area for old qtutils |
37 +Dev libs matter for packaging/plugins/build errors, not normal desktop config.
39 +## No first-party Hypr tool exists
41 +| Role | Default primitive | Higher-level choices |
42 +| ----------------- | ------------------------------- | ------------------------------------------------------ |
43 +| notifications | FreeDesktop notification daemon | mako=minimal, swaync=center, dunst/fnott |
44 +| screenshots | grim + slurp + wl-clipboard | hyprshot/HyprCapture wrappers, satty/swappy annotation |
45 +| screen recording | PipeWire/portal or wf-recorder | OBS, wl-screenrec |
46 +| clipboard history | wl-clipboard primitive | cliphist, CopyQ Wayland mode |
47 +| status bar/shell | layer-shell client | Waybar, ashell, Quickshell, AGS/Astal, Eww |
49 +Prefer first-party only where it exists and fits.
50 +Do not invent Hypr-native ownership for generic Wayland roles.
18 52 ## Inspection
22 56 hyprlock --help
23 57 hypridle --help
24 58 hyprsunset --help
59 +hyprshutdown --help
60 +hyprpicker --help
61 +hyprlauncher --help
25 62 systemctl --user status hyprpaper hypridle hyprsunset hyprpolkitagent
26 -journalctl --user -b | grep -Ei 'hyprpaper|hyprlock|hypridle|hyprsunset|polkit'
63 +journalctl --user -b | grep -Ei 'hyprpaper|hyprlock|hypridle|hyprsunset|polkit|xdg-desktop-portal'
29 66 ## Editing rules