Warning
I am currently working on a complete overhaul for everything but the shell which should fix most issues with installation. As such, I will not be working on the shell until the overhaul is finished. I will s 8000 till try to answer issues, however other than minor issues, I will most likely not be able to fix them (same goes for feature requests). PRs are still welcome though!
Some breaking changes:
- Rename the
scriptsrepo ->cli - Rename the
hyprrepo ->caelestia(this will be the main repo after the change) - Merge all other repos (except this and
cli) intocaelestia - Installation for the
shellandcliwill be done via AUR packages;caelestiawill have a meta package and an install script (should fix most installation issues) - Overhaul the scheme system (should fix a few bugs with that and make it cleaner in general)
out.mp4
- Widgets:
Quickshell - Window manager:
Hyprland - Dots:
caelestia
Install caelestia-scripts and run caelestia install shell.
Install all dependencies, then
clone this repo into $XDG_CONFIG_HOME/quickshell/caelestia and run qs -c caelestia.
The shell can be started in two ways: via systemd or manually running caelestia shell.
The install script creates and enables the systemd service caelestia-shell.service which should automatically start the
shell on login.
If not on a system that uses systemd, you can manually start the shell via caelestia-shell.
To autostart it on login, you can use an exec-once rule in your Hyprland config:
exec- shell
All keybinds are accessible via Hyprland global shortcuts.
For a preconfigured setup, install caelestia-hypr via caelestia install hypr or see
this file for an example on how to use global
shortcuts.
All IPC commands can be accessed via caelestia shell .... For example
caelestia shell mpris getActive trackTitleThe list of IPC commands can be shown via caelestia shell help:
> caelestia shell help
target mpris
function stop(): void
function play(): void
function next(): void
function getActive(prop: string): string
function list(): string
function playPause(): void
function pause(): void
function previous(): void
target drawers
function list(): string
function toggle(drawer: string): void
target wallpaper
function list(): string
function get(): string
function set(path: string): void
target notifs
function clear(): void
The profile picture for the dashboard is read from the file ~/.face, so to set it just put your image there.
The wallpapers for the wallpaper switcher are read from ~/Pictures/Wallpapers, so put your wallpapers there for
them to show up in the switcher (you need to restart the shell after changing stuff in ~/Pictures/Wallpapers sadly,
no watching for changes yet).
To set the wallpaper, you can use the command caelestia wallpaper. Use caelestia wallpaper -h for more info about
the command.
Thanks to the Hyprland discord community (especially the homies in #rice-discussion) for all the help and suggestions for improving these dots!
A special thanks to @outfoxxed for making Quickshell and the effort put into fixing issues and implementing various feature requests.
Another special thanks to @end_4 for his config which helped me a lot with learning how to use Quickshell.
Finally another thank you to all the configs I took inspiration from (only one for now):