Serpantinum is a shell for Wayland compositors built with QML that provides a desktop environment interface layer.
The tool addresses the need for a customizable shell environment on Wayland by offering a graphical interface that sits between the compositor and the user. Rather than being a full compositor itself, it works alongside existing Wayland compositors like Hyprland, providing shell functionality such as a panel, application launcher, and system controls. The project recently transitioned from a dotfiles-based approach to a proper shell application, meaning users now have direct control over compositor configuration including monitors, keybinds, and autostart settings rather than relying on preset configurations.
Serpantinum suits developers and users who want a lightweight, QML-based shell environment for Wayland without being locked into a monolithic desktop environment. It works well for those already running a Wayland compositor who want to add shell functionality on top. The tool provides installation paths for Arch Linux derivatives through an automated script and for NixOS through flake outputs and Home Manager modules, making it accessible across different Linux distributions. Users should be aware that the migration to a shell architecture means they must manually configure their compositor settings and integrate clipboard listeners and equalizer services into their compositor's autostart configuration for full functionality.
Development activity shows consistent engagement with the codebase through regular commits addressing both features and maintenance. The project maintains active responsiveness to issues and pull requests, indicating the maintainer is present and engaged with user feedback. Documentation has been expanded to cover the new shell architecture and provide sample configurations for multiple supported compositors, reflecting an effort to guide users through the transition from the previous version.
