Tools/caelestia-dots/shell

shell

‼️ No waybar here ‼️

13.3k ★+88/wkgrowthQMLGNU General Public License v3.0 →trending

The Lens

By Erik Loyd, SaaS CEO and former COO/CFO of an AWS Premier Partner.

Updated Oct 2026

Caelestia replaces the whole desktop interface on a Linux machine running Hyprland: bar, app launcher, notifications, lock screen, dashboard, sidebar, wallpaper switcher and on-screen brightness and audio popups, as one animated shell instead of separate tools like waybar, rofi and dunst. Free under GPL-3.0.

It's built on Quickshell (a toolkit for writing desktop widgets in Qt's QML language) plus a compiled C++ plugin, so it's more than a config file. Arch users install caelestia-shell from the AUR and Nix users can nix run it; everyone else installs a long dependency list, including the git build of Quickshell, and compiles with CMake. Settings live in ~/.config/caelestia/shell.json, with per-monitor overrides. Development is active, with commits most weeks and v2.5.0 tagged in September.

No paid tier, just a Ko-fi. Solo: free, and it's a personal setup, not something you roll out. Teams: nothing to standardize here.

The catch: it's built around Hyprland, and the full experience assumes Caelestia's own dotfiles and CLI, so you're adopting someone's entire desktop opinion. Releases rename and remove config options, and tweaking past the JSON means reading QML.

Free vs Self-Hosted vs Paid

fully free

Free: The entire shell under GPL-3.0: bar, launcher, notifications, lock screen, dashboard, sidebar, OSD and wallpaper switcher. No premium features.

Self-hosted: Runs locally on a Linux desktop with Hyprland. Install from the AUR (caelestia-shell, or caelestia-shell-git for bleeding edge), via Nix (nix run github:caelestia-dots/shell#with-cli), or build manually with CMake and Ninja after installing the dependencies, including the git version of Quickshell.

Paid: No paid tier. Donations are accepted on Ko-fi.

Free under GPL-3.0 with no paid tier; the Ko-fi is optional.

What to do by team size

Solo
free; a personal Hyprland desktop shell
Small team
free, but it's a per-person customization, not something you roll out
Medium team
free; nothing here to standardize across a team
Large team
free; still a personal choice, not a fleet decision
Self-hosting ops:moderate

Get tools like this every Wednesday

One featured tool, three on the radar. No fluff.

Similar Tools

Score
81/100 · A
Adoption27/30
Maintenance25/25
Community9/20
License10/15
Analysis10/10

A low score is not a verdict on quality. Young and niche tools start low by design. How we calculate scores

Trust Signals

Growing adoption: 8,957 starsActive community: 585 forks

License: GNU General Public License v3.0

Commercial OK, but distributed modifications must share source.

Commercial use: ✓ Yes

About

Owner
caelestia-dots (Organization)
Stars
13,341
Forks
1,004

Explore Further

More tools in the directory