- Launcher - clock, app drawer, wallpaper selector, clipboard history, and power/reboot menus
- Volume and notification flyouts - OSDs that pop up over whatever you're doing
- Weather and battery - shown on the clock page
- In-app settings - configurable layout, animations, theming, keybindings, resource usage and much more
- Custom pages - create your own qml page and have it show up in the launcher
- Dynamic theming - matugen-driven color extraction from your current wallpaper, or a custom palette
- Notification replay - re-fire recent notifications, stepping further back in history on each repeated call
- Live wallpaper support - live wallpaper previews, with auto-generated blurred variants
- Multi-monitor support - the launcher and flyouts follow whichever output is focused
- Gesture and keyboard support - entirely navigateable with either keyboard or gestures alone
Necessary:
| Dependency | Use |
|---|---|
| A Wayland compositor, e.g. Niri, Hyprland, Sway | Hosts the shell |
| Quickshell | Runs the shell |
Optional (required for full feature set):
| Dependency | Use |
|---|---|
| matugen | Wallpaper-derived color theme |
| ImageMagick | Static wallpaper/clipboard thumbnails |
| ffmpeg | Live wallpaper thumbnails |
| qtmultimedia | Live wallpaper previews (install via your distro's package manager) |
| awww | Recommended static wallpaper backend (can use any) |
| mpvpaper | Recommended live wallpaper backend (can use any) |
| cliphist | Clipboard history support |
git clone https://github.com/kianblakley/pibble.git
cd pibble./pibble start./pibble toggle| Action | Key | Gesture |
|---|---|---|
| Cycle pages | Tab / Shift+Tab |
swipe left/right |
| Navigate tiles in the current page | Arrow keys or scrollwheel |
press |
| Jump a page of tiles within the current page | PageUp / PageDown |
swipe up/down |
| Activate the selected tile | Enter |
press |
| Reveal power button | Ctrl+P |
swipe down from the top edge |
| Reveal reboot button | Ctrl+R |
swipe up from the bottom edge |
| Open settings | Ctrl+S |
press bottom right corner |
| Go back or close the launcher | Escape |
right-edge swipe |
| Command | Description |
|---|---|
help |
List the available commands |
start |
Start the daemon |
stop |
Stop the daemon |
restart |
Restart the daemon |
toggle [page] |
Show/hide the launcher, starting the daemon first if needed; with a page id, opens/switches straight to that page |
replay |
Re-fire one recent notification; repeated presses step back through history |
pibble has an extensive in-app settings page (Ctrl+S to open) covering appearance, animations, resource usage, layouts, navigation and flyouts.
Each window has a layer-shell namespace which can be used to apply background effects/animations in your compositor's configuration file.
| Namespace | Window |
|---|---|
pibble-launcher |
Main launcher |
pibble-notifications |
Notification flyout |
pibble-volume |
Volume flyout |
Custom page API coming.