• Widgets: Quickshell
• Window manager: Hyprland
• Dots: caelestia

This is not implemented as of now.

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

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

• Axenide/Ax-Shell