The cli is available from the AUR as caelestia-cli-git. To install it you can use an AUR helper like yay, or manually download the PKGBUILD and run makepkg -si.

e.g. using yay

yay -S caelestia-cli-git

Manual installation

Install all dependencies, then install python-build, python-installer, python-hatch and python-hatch-vcs.

e.g. via an AUR helper (yay)

yay -S libnotify swappy grim dart-sass app2unit wl-clipboard slurp wl-screenrec glib2 libpulse cliphist fuzzel python-build python-installer python-hatch python-hatch-vcs

Now, clone the repo, cd into it, build the wheel via python -m build --wheel and install it via python -m installer dist/*.whl. Then, to install the fish completions, copy the completions/caelestia.fish file to /usr/share/fish/vendor_completions.d/caelestia.fish.

git clone https://github.com/caelestia-dots/cli.git
cd cli
python -m build --wheel
sudo python -m installer dist/*.whl
sudo cp completions/caelestia.fish /usr/share/fish/vendor_completions.d/caelestia.fish

Usage

All subcommands/options can be explored via the help flag.

$ caelestia -h
usage: caelestia [-h] COMMAND ...

Main control script for the Caelestia dotfiles

options:
  -h, --help    show this help message and exit

subcommands:
  valid subcommands

  COMMAND       the subcommand to run
    shell       start or message the shell
    toggle      toggle a special workspace
    scheme      manage the colour scheme
    screenshot  take a screenshot
    record      start a screen recording
    clipboard   open clipboard history
    emoji       emoji/glyph utilities
    wallpaper   manage the wallpaper
    pip         picture in picture utilities

Languages

Python 75.6%

SCSS 10.6%

Shell 8.9%

Nix 3.9%

CSS 1%