|
manēso — A Dynamic Island for MangoWM |
- Animated island with hover or click expansion
- Workspace tags, MangoWM overview awareness, focused window, and keyboard layout indicators
- Media controls via MPRIS and MPD
- Volume, brightness, and keyboard-layout on-screen displays
- Notification center with history and grouping
- System tray, privacy indicators, and system statistics
- Bluetooth, network, and power status
- Built-in settings panel
- Optional polkit authentication agent that prompts inside the island
- Session lock screen on
ext-session-lock-v1with PAM authentication - Idle handling: auto-lock, screen power-off and media-aware inhibition
- Power menu with configurable lock, suspend, logout, reboot and shutdown, navigable with arrows or vim keys
- Wallpaper manager: awww, command or in-process layer backend, rotation, Matugen and Veila hooks, and a picker with carousel, grid and spotlight layouts
- Matugen color integration
- IPC commands for scripting and keybindings
- MangoWM on Wayland
- Quickshell with Qt 6 QML
wpctlfor PipeWire volume controlbrightnessctlfor internal display brightnessddcutilfor external display brightnessffmpegfor extracting MPD artwork and picker thumbnailsawww(optional) for the awww wallpaper backend
These tools are only needed for the features that use them. The diagnostics page
reports any missing tools, including notify-send if it is not installed.
sudo pacman -S quickshellFor the latest git version from the AUR:
yay -S quickshell-gitThe AUR command assumes yay; substitute your preferred AUR helper.
For other distributions and manual build instructions, see INSTALL.md.
Depending on your setup, install qtsvg, qtimageformats, qtmultimedia, and
qt5compat for SVG icons, additional image formats, media, and blur effects.
Run the configuration directly from its checkout:
qs -p /path/to/manesoAlternatively, place or symlink the checkout at
$XDG_CONFIG_HOME/quickshell/maneso and launch it by name:
qs -c manesoSee CONFIGURATION.md for all available settings, their defaults, and accepted values.
The island keeps its existing island IPC target so that current scripts and
keybindings continue to work:
qs -c maneso ipc show # list registered functions
qs -c maneso ipc call island help # human-readable command list
qs -c maneso ipc call island toggle
qs -c maneso ipc call island status
qs -c maneso ipc call island workspaces # workspace index or overview state
qs -c maneso ipc call island toggleNotifications
qs -c maneso ipc call island toggleSettings
qs -c maneso ipc call island polkitStatus # agent registration and active requestThe lock screen has its own target. Unlocking is intentionally not exposed, as that would bypass authentication:
qs -c maneso ipc call lock lock # lock now
qs -c maneso ipc call lock status # locked, secure, authenticating, errorIdle and power:
qs -c maneso ipc call power menu # power menu (profiles + actions)
qs -c maneso ipc call power actions # actions only, no power profiles
qs -c maneso ipc call power idle # toggle idle handling (OSD)
qs -c maneso ipc call power idleStatus # idle timers and armed state
qs -c maneso ipc call power status # idle timers and power stateThe wallpaper manager has its own target:
qs -c maneso ipc call wallpaper help
qs -c maneso ipc call wallpaper status # backend, folder, count, current image
qs -c maneso ipc call wallpaper set /path/to/image.png
qs -c maneso ipc call wallpaper random
qs -c maneso ipc call wallpaper next # also: previous
qs -c maneso ipc call wallpaper reload # rescan the folder
qs -c maneso ipc call wallpaper picker # open or close the pickerIf you launch the configuration with qs -p, pass the same path to the IPC
command instead, for example
qs -p /path/to/maneso ipc call island toggle.
- User-facing name: manēso
- ASCII identifier: maneso
manēso is released under the MIT License.

