Serashell is my personal dotfiles collection for a Hyprland desktop. Its name comes from Seraphim and Shell, with the shell experience built mostly in Quickshell.
The main interface is a compact, theme-aware Quickshell shell with a top bar, Dynamic Island or macOS-style notch, media controls, launcher, clipboard history, wallpaper picker, control centre, and configurable settings.
Warning
Serashell is tuned for my own setup and is not yet a polished installable distribution. Expect rough edges while the UI, performance, and component system continue to evolve.
The active Quickshell configuration lives in config/quickshell/.
- Dynamic Island / macOS Notch β switchable presentation styles
- Top bar β system tray, workspaces, active window title, system status, AI usage, sound, brightness, battery, and clock
- Control Centre β Wi-Fi, Bluetooth, media, theme, screenshot, sound, and brightness
- Panels β calendar, system monitor, media details, frequently used app launcher, clipboard history, wallpaper picker, theme selection, and AI usage
- App launcher β fuzzy search with persistent most-used application ranking
- AI usage β provider usage, token, and estimated cost summaries in the bar and a dedicated panel
- Keystroke Visualizer β theme-aware full-width key display for typing and shortcuts, with animated keybind icons and optional left/right mouse-click indicators
- Settings β persistent appearance, bar, pill, panel sizing, date/time, system status, AI usage, and keystroke visualizer preferences
- Themes β wallpaper-rice light and dark themes shared by the shell and companion applications
Enable it from Settings β Keystroke. The overlay records typing and modifier combinations in Full mode, follows the active light/dark theme, and can optionally show left and right mouse clicks. Function keys and navigation keys are intentionally hidden to keep the display focused.
For local development, validate the shell in the foreground:
QT_QPA_PLATFORM=wayland qs- Ricelin β inspired Serashell, the pill-as-panel launcher concept, and provided the basis for the wallpaper selector
- OpenUsage β inspired the AI usage feature
- Dynamic Island for Arch β provided the basis for the macOS notch QML pill implementation
If you enjoy Serashell, consider starring the repository. It helps others discover the project.
Serashell is available under the MIT License.