This project provides a comprehensive aesthetic customization for KDE Plasma 6, porting the visually striking Caelestia Hyprland dotfiles. It targets users seeking a highly personalized and ethereal desktop experience within the robust KDE Plasma environment, leveraging custom widgets and theming for a seamless, modern look.

How It Works

The project is a curated collection of KDE Plasma configuration files, custom widgets powered by the Quickshell framework, and idempotent installation scripts. It employs Material Design 3 theming through Darkly and Kvantum, integrates Quickshell widgets via a custom KWin script, and includes a rewritten Hyprctl for Hyprland-like command execution. This approach aims to deliver the aesthetic appeal of minimal window managers within the feature-rich KDE Plasma desktop.

Quick Start & Requirements

1. Clone the repository: git clone -b main --single-branch --depth 1 https://github.com/ladybug-me/caelestia-dots-kde ~/caelestia-dots-kde
2. Navigate to the directory: cd ~/caelestia-dots-kde
3. Run the installer: bash ./setup.sh
4. Follow interactive prompts.

• Prerequisites: Arch Linux or Arch-based (EndeavourOS, CachyOS, Manjaro), or Fedora Linux. KDE Plasma 6.0+.
• Dependencies: Includes KDE Plasma, Quickshell, Darkly, Kvantum, KWin, optional Polonium, and various utility packages detailed in the README.
• Links: GitHub Repository

Highlighted Details

• Material Design 3 Theming: Cohesive dark theme with dynamic color extraction.
• Quickshell Widgets: Native KDE integration with a modern Qt-based widget system.
• Custom Integrations: Quickshell-KDE bridge via KWin script and custom Hyprctl.
• Transparent & Idempotent Installation: Scripts print commands and can be safely retried.
• Quality of Life Features: Includes tools for screen capture, color picking, emoji selection, clipboard history, and an AI assistant with Ollama support.
• v2.0.2 Enhancements: MacOS-style dock, GIF/video wallpaper support, Bad Apple Easter Egg, and performance improvements via C++ backend plugins.

Maintenance & Community

The project is actively maintained by ladybug-me, with significant contributions from 0xSolanaceae (uninstallation script) and others. Community discussion can be found on r/kde. Updates are managed via update.sh with stable (main) and bleeding-edge (dev) branches.

Licensing & Compatibility

This project is licensed under the GNU General Public License v3.0 (GPLv3). Derivative works must also be licensed under GPLv3, imposing copyleft restrictions that may affect integration with closed-source software.

Limitations & Caveats

This is not a direct replacement for the original Hyprland dotfiles and does not handle low-level system drivers or core tuning. The installer may exhibit sudo timeout quirks, and Fedora users might require manual intervention. Users must use the Caelestia wallpaper manager for correct color theme application and may need to manually select themes in KDE settings when switching between light and dark modes.