A community port of the Caelestia Hyprland dotfiles to KDE Plasma 6, bringing the ethereal caelestia aesthetic to a full desktop environment with broader hardware and software compatibility.
Requirements: Arch-based distro, Fedora, or Ubuntu (Rolling) · KDE Plasma 6.0+
curl -fsSL https://raw.githubusercontent.com/ladybug-me/caelestia-dots-kde/main/install.sh | sh- Installer TUI: run the installer and choose Update
- GUI: Shell Settings -> Updates -> select branch -> Install Updates
- CLI:
bash update.shand choosemain(stable) ordev(bleeding edge)
Shell settings are preserved across updates.
Choose Uninstall from the installer TUI, or run:
bash ./uninstall.shcaelestia-demo.mp4
| Shell | Lockscreen |
|---|---|
| Shortcut | Action |
|---|---|
Super |
App launcher |
Super + / |
Keybind cheatsheet |
Super + Enter |
Terminal |
Super + Tab |
Overview |
Super + 1–5 |
Switch workspace |
Super + B |
Notification sidebar |
Super + V |
Clipboard history |
Super + Shift + S |
Screenshot |
Super + Shift + A |
Google Lens |
Super + Shift + D |
Text recognition |
Super + Ctrl + S |
Screen recorder |
Super + Shift + C |
Color picker |
Super + Shift + V |
Emoji selector |
Wallpaper & colors
Use the built-in wallpaper manager (Super, then >Wallpaper). Dynamic color schemes update automatically with your wallpaper. Do not use the default KDE wallpaper manager.
To browse all settings, Super, then >Settings to launch the Caelestia Settings - navigate to Appearance for wallpaper, colors, and themes.
Keyboard shortcuts
Use the built-in keyboard shortcut manager present in Caelestia Settings.
Greeter animations
Right click on the widget to customize and select your desired media files for different times of the day. Or enable slideshow, change the greeting text and icon, and much more.
Plugin Store
Head to Caelestia Settings -> Plugins -> Store to browse for available plugins and customize your shell the way you like.
| Problem | Fix |
|---|---|
| Widgets not appearing | Log out and back in, or run caelestia shell -d |
| Colors not applying | Run systemctl status --user kde-material-you-colors.service; re-run installer if needed |
| Install failed mid-way | Re-run bash ./scripts/setup.sh |
| Full reset needed | See TROUBLESHOOTING.md |
For detailed debug logs, enable Debug Mode in Nexus -> About -> Advanced, then run caelestia shell -l.
|
|
- Caelestia - original design language and dotfiles
- ladybug-me - KDE port lead & maintainer
- 0xSolanaceae - maintainer
- dim-ghub - v2.0.0 features
- Bali10050 - Darkly Qt
- wrymt - Darkly GTK
- Haidir - icon set
“Ad astra per aspera.”