1 +#
Hyprland ecosystem taxonomy 5 +Prefer `hypr*` when first-party and sufficient.
6 +Use one primary per overlapping category.
10 +| Role | Prefer | Alternatives | Overlap |
11 +| ------------------ | ---------------------------- | ------------------------------------ | --------------------------------------------- |
12 +| Wayland compositor | Hyprland | none in this skill | Not Sway/niri/river advice |
13 +| Session manager | plain Hyprland launch / UWSM | display manager session | UWSM changes env/autostart/shutdown semantics |
14 +| Shutdown/logout UI | hyprshutdown | wlogout, custom rofi/quickshell menu | one menu frontend; commands may be shared |
16 +##
Required desktop plumbing 18 +| Role | Prefer | Alternatives | Notes |
19 +| ------------------ | --------------------------- | ------------------------------------ | ----------------------------------------------- |
20 +| Portal/screencast | xdg-desktop-portal-hyprland | none for Hyprland features | stack with generic portal + file picker backend |
21 +| File picker portal | xdg-desktop-portal-gtk | xdg-desktop-portal-kde | XDPH does not own file picker |
22 +| Audio/video graph | PipeWire + WirePlumber | distro-specific PipeWire launcher | required for screen share |
23 +| Polkit auth | hyprpolkitagent | polkit-kde-agent, GNOME polkit agent | run one agent |
24 +| Notifications | swaync | mako, dunst, fnott | run one daemon; swaync also notification center |
26 +##
Hypr first-party user apps 28 +| Role | Prefer | Alternatives | Overlap |
29 +| -------------------- | ---------------------------------- | ----------------------------------------------------------------- | ----------------------------------------- |
30 +| Wallpaper | hyprpaper | swaybg, wpaperd, swww/awww, mpvpaper | one wallpaper daemon per output |
31 +| Color picker | hyprpicker | wl-color-picker, grim+slurp scripts | same global picker role |
32 +| Idle manager | hypridle | swayidle | idle daemon; pairs with lock/suspend cmds |
33 +| Lock screen | hyprlock | swaylock, gtklock | lock app; not same as idle daemon |
34 +| Blue-light/gamma | hyprsunset | wlsunset, gammastep where Wayland works | avoid simultaneous gamma filters |
35 +| App launcher | hyprlauncher | fuzzel, walker, rofi-wayland, wofi, tofi, bemenu, anyrun, vicinae | many can coexist; choose one primary bind |
36 +| System info | hyprsysteminfo | inxi, fastfetch | diagnostic frontend |
37 +| Password UI | hyprpwcenter | pass/secret-service frontends | optional |
38 +| Qt integration/theme | hyprland-qt-support, hyprqt6engine | qt5ct/qt6ct, Kvantum | toolkit theming overlap |
40 +##
Bars, panels, shells 42 +| Role | Common choices | Notes |
43 +| --------------------- | ------------------------------------ | -------------------------------------------- |
44 +| Simple bar | Waybar, ashell | Waybar has Hyprland modules; config JSON/CSS |
45 +| Desktop shell/widgets | Quickshell, AGS/Astal, Eww, Noctalia | usually one shell owns bar/sidebar/OSD/menus |
46 +| Dock | nwg-dock-hyprland, custom shell dock | overlaps with bar/shell launchers |
48 +Avoid running multiple bars/panels unless user wants it.
49 +Duplicate layer-shell surfaces cause reserved-area/weird layout issues.
53 +| Type | Tools | Notes |
54 +| ------------------- | -------------------------------------------------------------- | ---------------------------------------------------------- |
55 +| App launcher | hyprlauncher, fuzzel, walker, rofi-wayland, wofi, tofi, bemenu | primary `SUPER+D`/`SUPER+R` target |
56 +| Multi-module runner | walker, anyrun, vicinae, rofi scripts | apps/windows/web/clipboard/calculator |
57 +| Power menu | hyprshutdown, wlogout, rofi/waybar/quickshell custom | frontend only; real actions are loginctl/systemctl/hyprctl |
59 +##
Wallpaper/color/theming chain 61 +| Role | Tools | Overlap |
62 +| ------------------ | ------------------------------------------------------- | -------------------------------------- |
63 +| Wallpaper daemon | hyprpaper, swww/awww, swaybg, wpaperd, mpvpaper | one daemon |
64 +| Wallpaper selector | waypaper, wallrizz, custom rofi/quickshell scripts | frontend; controls daemon |
65 +| Palette generator | wallust, matugen, pywal | one source of truth preferred |
66 +| Toolkit theme | GTK theme/nwg-look, qt5ct/qt6ct, Kvantum, hyprqt6engine | toolkit-specific |
67 +| Cursor | hyprcursor themes, xcursor env fallback | compositor/toolkit consistency matters |
69 +##
Screenshots/recording/screenshare 71 +| Role | Prefer/typical | Alternatives | Notes |
72 +| -------------- | ----------------------------- | --------------------- | ----------------------------- |
73 +| Screenshot raw | grim + slurp | HyprCapture, hyprshot | Wayland-native capture |
74 +| Annotate | satty | swappy | consumes screenshot pipe/file |
75 +| Clipboard | wl-copy/wl-paste | cliphist frontend | Wayland clipboard |
76 +| Recording | wf-recorder | wl-screenrec, OBS | OBS uses PipeWire/portal |
77 +| Screenshare | XDPH + PipeWire + WirePlumber | browser/app portal UI | portal config/logs matter |
79 +Avoid `xclip`, `xsel`, X11 screenshot tools.
83 +| Role | Tools | Notes |
84 +| ------------- | ------------------------------------ | ------------------------------------------- |
85 +| CLI clipboard | wl-clipboard (`wl-copy`, `wl-paste`) | base primitive |
86 +| History | cliphist | usually paired with rofi/fuzzel/wofi/walker |
87 +| Persistence | wl-clip-persist | keeps clipboard after source exits |
88 +| GUI manager | CopyQ Wayland mode | heavier, own UI |
90 +##
Applets/non-Hypr basics 93 +| ------------- | --------------------------------------------------- |
94 +| Network | NetworkManager + nm-applet / nmtui |
95 +| Bluetooth | blueman-applet / blueberry |
96 +| Audio | WirePlumber + wpctl/pavucontrol |
97 +| Brightness | brightnessctl/light |
98 +| Secrets | gnome-keyring / keepassxc / kwallet depending stack |
99 +| Terminals | foot, kitty, alacritty, ghostty, wezterm |
100 +| File managers | nautilus, dolphin, thunar, yazi/lf |
102 +These are not Hyprland-specific; keep advice minimal unless integration breaks.