Guide to making your own local changes

[soramanew]

Note

If you installed caelestia via the install script, the shell and cli are both installed via the AUR, so you shouldn't be editing those in the first place.

Editing the shell

If you want to make your own changes to the shell, you can fork the repo and clone it to ~/.config/quickshell/caelestia. This will override the one installed via the AUR when running with caelestia shell or qs -c caelestia.

You can then update it using git via git pull and git merge (and git push to push back to your fork).

A working example using Github CLI:

gh repo fork caelestia-dots/shell --remote=true --clone=true
mkdir -p ~/.config/quickshell
mv shell ~/.config/quickshell/caelestia

Editing the cli

If you want to make your own changes to the cli, you can fork the repo and clone it anywhere you want. Then, create a file in ~/.local/bin (and ensure it is in your PATH) called caelestia to override the one installed via the AUR (make sure to make it executable).

You can then update it using git via git pull and git merge (and git push to push back to your fork).

# ~/.local/bin/caelestia

#!/usr/bin/env sh
/path/to/repo/run.sh "$@"

A working example using Github CLI:

gh repo fork caelestia-dots/cli --remote=true --clone=true
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.profile
mkdir -p ~/.local/bin
echo '#!/usr/bin/env sh' > ~/.local/bin/caelestia
echo "$(pwd)"'/cli/run.sh "$@"' >> ~/.local/bin/caelestia

Editing other configs

The caelestia repo's configs are not installed as system configs, instead they are symlinked to the config folders. To make your own changes, just create a fork and run the install script from there. You can then update it using git via git pull and git merge (and git push to push back to your fork).

A working example using Github CLI:

gh repo fork caelestia-dots/caelestia --remote=true --clone=true
./caelestia/install.fish