Rystal-shell is a GTK4 desktop shell built with AGS and Astal. It provides panels, notifications, application and wallpaper launchers, and desktop controls.
It can be installed independently or as part of Ryprland. Standalone installation requires no Ryprland dotfiles or helper scripts.
Important
Standalone installation still requires a Hyprland session. Workspaces, window focus, notifications, and capture use Hyprland APIs.
recording_2026-08-07_10.04.26.mp4
- Standalone: follow Installation to install dependencies, build, and run.
- Ryprland: follow Ryprland's installation guide.
Note
Ryprland provides its own deployment helper and extended theme-switch.sh.
Follow its package instructions and skip the standalone installers; the helper does not install system packages.
- Configuration: user settings and directory overrides
- Theme switcher: standalone wallpaper and color generation
- Session integration: autostart and Caffeine
- Development: isolated development and validation commands
- Design notes: AGS choice and historical memory observations
Rystal-shell's original source code is licensed under the GNU General Public License v3.0 or later.
The Lucide icon assets under assets/icons/ retain their upstream ISC and MIT
license terms. See Third-Party Notices and the
Lucide license text for details.