caelestia-shell

Warning

The overhaul is finished! Installation is now via an install script in the caelestia repo.

Anyone with an existing installation, please reinstall via the install script.

Some breaking changes:

Rename the scripts repo -> cli

Rename the hypr repo -> caelestia

Merge all other repos (except this and cli) into caelestia

Installation for the shell and cli will be done via AUR packages; caelestia will 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)

https://github.com/user-attachments/assets/0840f496-575c-4ca6-83a8-87bb01a85c5f

Components

Widgets: Quickshell
Window manager: Hyprland
Dots: caelestia

Installation

This is not implemented as of now.

Usage

The shell can be started in two ways: via systemd or manually running caelestia shell.

Via systemd

The install script creates and enables the systemd service caelestia-shell.service which should automatically start the shell on login.

Via command

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-once = caelestia shell

Shortcuts/IPC

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 trackTitle

The 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

PFP/Wallpapers

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.

Credits

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):

Axenide/Ax-Shell

4.9 KiB Raw Blame History