• Technically: A curated collection of KDE Plasma configuration files, custom widgets, and idempotent installation scripts.
• Visually: The ethereal caelestia aesthetic seamlessly ported to KDE Plasma utilizing cutting-edge Quickshell widgets.
• NOT: A direct replacement for the original Hyprland dotfiles (which remain superior for dedicated minimal window managers).
• NOT: A fully unattended system setup script (installs packages and configs, but no low-level system drivers or core tuning).

• KDE Plasma offers broader compatibility with existing tools, hardware, and ecosystems.
• Provides a familiar, highly robust desktop environment.
• Integrates strongly with the Arch Linux community and the AUR.
• Proves that heavy DEs can still achieve an ultra-customized, highly aesthetic ricing spirit.

• Material Design 3 Theming: Cohesive dark theme driven by Darkly + Kvantum + dynamic color extraction.

• Quickshell Widgets: Native, robust KDE integration with a modern Qt-based widget system.

• Kde Plasma 6.7: Built to work with the latest release.

• Custom KDE Bridge: Quickshell-KDE integration via a custom KWin script for fluid widget interaction.

• Custom Hyprctl: Rewritten to integrate Hyprland-like calls seamlessly via Quickshell.

• Transparent Installation: Every command is printed before execution. Safe and idempotent.

• Easy Uninstallation: Cleanly remove the setup with a dedicated uninstallation script (thanks to 0xSolanaceae).

• QoL Features: Dino Game with Kuru Kuru Runner 🦖 , Google lens 📸 , Screenshot tool 📷 , Screen recording with sound 📹 , Color picker 🎨 , Emoji picker 😂 , Clipboard history , Shortcuts Cheatsheet 📝.

• Window Tiling: Optional Polonium support for dynamic tiling window management on Plasma.

1. Clone this repository:

   git clone https://github.com/ladybug-me/caelestia-dots-kde ~/caelestia-dots-kde
   cd ~/caelestia-dots-kde

2. Run the installer:

   bash ./setup.sh

3. Follow the interactive prompts: You can safely retry or ignore errors as needed.

Note: The installer might occasionally prompt for your password multiple times due to sudo timeouts. This is a known quirk and will be optimized in future releases.

Requirements:

• Arch Linux or an Arch-based distro (EndeavourOS, CachyOS, Manjaro, etc.), or Fedora Linux.
• KDE Plasma 6.0+

Tested on:

• CachyOS
• Manjaro KDE
• Fedora 44 KDE Edition

• Updating is simple, just clone the latest version and run the installer.
• Shell settings are not changed during updates.

The setup scripts install a curated suite of packages organized by category.

• Audio: cava, pavucontrol-qt, wireplumber, pipewire-pulse, playerctl
• Backlight & Power: geoclue, brightnessctl, ddcutil, upower
• Core Utilities: bc, coreutils, cliphist, ripgrep, jq, rsync, go-yq
• Fonts & Themes: breeze-plus, darkly-bin, eza, starship, matugen-bin, ttf-jetbrains-mono-nerd, ttf-material-symbols-variable-git, otf-space-grotesk
• KDE & Desktop: kvantum, systemsettings, kde-material-you-colors, xdg-desktop-portal-kde
• Screen Capture & OCR: hyprshot, slurp, swappy, tesseract, wf-recorder
• Optional Features: polonium
• Custom Build: caelestia-quickshell-git

See sdata/ for the complete custom PKGBUILDs structure.

• Log out and log back in.
• Run: caelestia shell -d in the terminal and check for any diagnostic errors.

• Run systemctl status --user kde-material-you-colors.service to check for errors.
• Rerunning the installer is often the easiest fix if a dependency was missed.
• Only the Color Schemes labeled with dynamic support color change with wallpaper. (In app launcher, type > to open Caelestia Tweaks > Scheme)
• IMPORTANT: Do not use the default KDE wallpaper manager. Use the Caelestia built-in wallpaper manager to ensure colors are extracted and applied.

• Sudo timeout: If a system update takes a long time, sudo might time out.
• Rerun the installer: bash ./setup.sh and look for red errors. The installer is idempotent and safe to run multiple times.
• It will prompt you to retry, ignore, or exit on errors.

The easiest way to revert changes and uninstall the Caelestia KDE theme is to use the dedicated uninstallation script (kindly contributed by 0xSolanaceae):

bash ./uninstall.sh

[!WARNING]
At Remove packages step (optional), the script will prompt for your confirmation before proceeding. Once confirmed, it will remove all packages associated with the Caelestia setup. This includes any packages that were already pre-installed on your system but happen to match the setup requirements. Please review the Software Stack section above for the comprehensive list of packages that will be uninstalled.

The most probable cause is a keyd service failure. Run: systemctl restart keyd.

Special case: If a kernel update happened, you might see "no uinput device" when running sudo keyd. Rebooting will fix this.

• I have done everything, everypatch, every script possible to make it work on fedora but maybe for someone it might require manual intervention. Follow the installer's carefully placed logs to find any issue and fix it manually.

• Know that it works on Fedora 😄.