# caelestia-dots/shell **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/caelestia-dots-shell).** 7,592 stars · 495 forks · QML · gpl-3.0 ## Links - GitHub: https://github.com/caelestia-dots/shell - awesome-repositories: https://awesome-repositories.com/repository/caelestia-dots-shell.md ## Topics `caelestia` `dotfiles` `hyprland` `hyprland-rice` `linux` `qt6` `quickshell` `rice` `wayland` ## Description This project is a QML desktop shell designed for desktop environment orchestration and interface customization. It functions as a system status dashboard and a declarative user interface for managing system hardware, window metadata, and user sessions. The shell features a dynamic theme generator that extracts dominant colors from wallpapers to automatically synchronize the global visual color palette. It utilizes an inter-process communication system to orchestrate shell functions and a hierarchical JSON configuration framework to manage global and per-monitor interface layouts. The system provides capabilities for monitoring hardware state, battery power, and network connectivity, alongside tools for multimedia playback control and system notification management. It also includes utilities for launching applications, managing wallpapers, and securing sessions via screen locking. ## Tags ### Operating Systems & Systems Programming - [Desktop Environments & UI](https://awesome-repositories.com/f/operating-systems-systems-programming/desktop-environment-frameworks/desktop-environment-components/desktop-environments-ui.md) — Provides a complete desktop environment UI for managing windows, screen recording, and wallpapers. ([source](https://github.com/caelestia-dots/shell/tree/main/services)) - [Desktop Shells](https://awesome-repositories.com/f/operating-systems-systems-programming/desktop-environment-frameworks/desktop-environment-components/desktop-shells.md) — Provides a declarative QML-based graphical interface for managing system hardware, window metadata, and desktop environment orchestration. - [Desktop Environment Configurations](https://awesome-repositories.com/f/operating-systems-systems-programming/desktop-environment-configurations.md) — Provides a structured text configuration system for defining global and per-monitor shell behavior and appearance. ([source](https://github.com/caelestia-dots/shell#readme)) - [Desktop Environment Components](https://awesome-repositories.com/f/operating-systems-systems-programming/desktop-environment-frameworks/desktop-environment-components.md) — Coordinates user sessions, screen locking, and window metadata to orchestrate the desktop experience. - [Hardware Control Interfaces](https://awesome-repositories.com/f/operating-systems-systems-programming/system-hardware-interfaces/hardware-control-interfaces.md) — Implements a graphical interface to adjust system audio levels, screen brightness, and display settings. ([source](https://github.com/caelestia-dots/shell/tree/main/services)) - [System Hardware Controllers](https://awesome-repositories.com/f/operating-systems-systems-programming/system-hardware-interfaces/system-hardware-controllers.md) — Controls audio levels, screen brightness, and display configurations from a centralized shell interface. - [Window Metadata Displays](https://awesome-repositories.com/f/operating-systems-systems-programming/display-windowing/window-metadata-displays.md) — Displays real-time status details and metadata for the application window currently in focus. ([source](https://github.com/caelestia-dots/shell/tree/main/modules)) ### User Interface & Experience - [Declarative UI Languages](https://awesome-repositories.com/f/user-interface-experience/declarative-ui-languages.md) — Built using a QML-based declarative language to create fluid interfaces that automatically update based on system state. - [Image-Based Color Generators](https://awesome-repositories.com/f/user-interface-experience/color-palette-generators/image-based-color-generators.md) — Extracts dominant colors from wallpapers to automatically synchronize the global visual color palette. - [Wallpaper-Synced](https://awesome-repositories.com/f/user-interface-experience/color-schemes/wallpaper-synced.md) — Automatically updates the system color palette based on the dominant colors of the current wallpaper. ([source](https://github.com/caelestia-dots/shell#readme)) - [Configuration Overrides](https://awesome-repositories.com/f/user-interface-experience/conditional-rendering/configuration-overrides.md) — Provides configuration overrides that allow individual displays to have layouts and properties distinct from the global defaults. - [Desktop Shell Customizers](https://awesome-repositories.com/f/user-interface-experience/desktop-shell-customizers.md) — Allows personalization of the core desktop shell and visual environment via declarative configuration. ([source](https://github.com/caelestia-dots/shell/blob/main/flake.nix)) - [Dynamic Theming](https://awesome-repositories.com/f/user-interface-experience/dynamic-theming.md) — Implements dynamic theming by synchronizing system color schemes with selected wallpapers at runtime. - [Display Settings](https://awesome-repositories.com/f/user-interface-experience/layout-configurations/display-aware-layout-managers/display-layout-managers/display-settings.md) — Allows for per-monitor interface configurations to customize the layout and appearance of each connected screen. ([source](https://github.com/caelestia-dots/shell/blob/main/README.md)) - [Desktop Interface Customization](https://awesome-repositories.com/f/user-interface-experience/layout-configurations/display-aware-layout-managers/display-layout-managers/display-settings/desktop-interface-customization.md) — Provides tools for creating fluid and dynamic system-wide UI elements using a declarative language. ([source](https://github.com/caelestia-dots/shell#readme)) - [Desktop Environment Orchestrators](https://awesome-repositories.com/f/user-interface-experience/state-management-orchestrators/desktop-environment-orchestrators.md) — Coordinates user sessions, screen locking, and window metadata to orchestrate the overall desktop experience. - [Workspace Layout Customizers](https://awesome-repositories.com/f/user-interface-experience/workspace-layout-customizers.md) — Allows users to position and arrange desktop elements like bars and sidebars to customize their workspace. ([source](https://github.com/caelestia-dots/shell/tree/main/modules)) - [Alerts & Notifications](https://awesome-repositories.com/f/user-interface-experience/alerts-notifications.md) — Displays system messages and alerts through a dedicated notification interface. ([source](https://github.com/caelestia-dots/shell/tree/main/modules)) - [Color Palette Generators](https://awesome-repositories.com/f/user-interface-experience/color-palette-generators.md) — Provides a utility that generates a system-wide color palette by extracting dominant colors from wallpaper images. - [Image Color Extractors](https://awesome-repositories.com/f/user-interface-experience/color-palette-generators/image-color-extractors.md) — Analyzes wallpaper pixel data using image color extraction to automatically define the system's visual theme. - [Color Palette Systems](https://awesome-repositories.com/f/user-interface-experience/color-palette-systems.md) — Automatically synchronizes the system color palette by extracting dominant colors from the current background image. ([source](https://github.com/caelestia-dots/shell/blob/main/README.md)) - [Application Launch Menus](https://awesome-repositories.com/f/user-interface-experience/context-menu-customizations/application-launch-menus.md) — Provides a searchable menu to find and launch installed applications. ([source](https://github.com/caelestia-dots/shell/tree/main/modules)) ### Part of an Awesome List - [System Dashboards](https://awesome-repositories.com/f/awesome-lists/devtools/system-dashboards.md) — Groups system status widgets and quick-access tools into a centralized dashboard for real-time monitoring. ([source](https://github.com/caelestia-dots/shell/tree/main/modules)) ### Software Engineering & Architecture - [JSON Configuration Schemas](https://awesome-repositories.com/f/software-engineering-architecture/application-lifecycle-management/configuration-management/configuration-formats-and-schemas/json-configuration-schemas.md) — Uses structured JSON configuration files to store and load global and monitor-specific system settings. - [Hierarchical Configuration Systems](https://awesome-repositories.com/f/software-engineering-architecture/application-lifecycle-management/configuration-management/hierarchical-configuration-systems.md) — Implements a hierarchical configuration system where monitor-specific settings can override global interface defaults. - [Inter-Process Communication](https://awesome-repositories.com/f/software-engineering-architecture/inter-process-communication.md) — Uses an inter-process communication bus to allow external processes to trigger shell functions and system tasks. - [Polling Mechanisms](https://awesome-repositories.com/f/software-engineering-architecture/event-driven-architectures/polling-mechanisms.md) — Implements polling mechanisms to monitor hardware and network states and synchronize system widgets in real time. ### System Administration & Monitoring - [Status Monitors](https://awesome-repositories.com/f/system-administration-monitoring/status-monitors.md) — Ships a collection of real-time widgets for monitoring battery, network connectivity, weather, and hardware state. - [Laptop Battery Managers](https://awesome-repositories.com/f/system-administration-monitoring/energy-management/home-battery-integrations/laptop-battery-managers.md) — Tracks and displays the remaining energy level and charging status of the system battery. ([source](https://github.com/caelestia-dots/shell/tree/main/modules)) - [Event Monitoring Systems](https://awesome-repositories.com/f/system-administration-monitoring/event-monitoring-systems.md) — Provides event-driven monitoring of system state changes to update real-time hardware and network status dashboards. - [Network Connectivity Monitoring](https://awesome-repositories.com/f/system-administration-monitoring/network-connectivity-monitoring.md) — Tracks real-time network connectivity and data usage for wireless and VPN connections within the system dashboard. ([source](https://github.com/caelestia-dots/shell/tree/main/services)) - [Environmental Data Widgets](https://awesome-repositories.com/f/system-administration-monitoring/real-time-monitoring-systems/environmental-condition-monitors/environmental-data-widgets.md) — Retrieves and displays current local time and weather information within the user interface. ([source](https://github.com/caelestia-dots/shell/tree/main/services)) - [System Notifications](https://awesome-repositories.com/f/system-administration-monitoring/system-notifications.md) — Implements a system for processing and displaying incoming alerts and notification data in the shell interface. ([source](https://github.com/caelestia-dots/shell/tree/main/services))