FAQ

Although, some of them are not-so-frequently asked questions...

My clipboard history doesn't work!

Tip

You'll likely want to add this to your session's auto-start ;D

You have to run wl-clipboard in --watch mode with cliphist in order to make it work:

wl-paste --type text --watch cliphist store # for text copying
wl-paste --type image --watch cliphist store # for image copying

Blue-light filter(hyprsunset) doesn't appear in settings

hyprsunset must be running before colorshell in order to make it work. Add it to your auto-start(or enable the systemd service).

For example, in Hyprland:

hl.on("hyprland.start", function ()
    hl.exec_cmd("hyprsunset"); -- or "systemctl --user start hyprunset"
    hl.exec_cmd("colorshell"); -- or any other way you like to run colorshell
end);

I can't take screenshots!

You need both grim and slurp programs in order to make the colorshell screenshot command to work!

Also, you might like adding colorshell screenshot to your binds if you haven't already ;)

Taking a Lock Screen Screenshot

Taking a screenshot of the lock screen is a bit tricky. You have to do the following:

• Open your terminal and run:

sh -c "colorshell lock && sleep .8s && colorshell screenshot full"

• Your lock screen screenshot will appear your XDG_PICTURES_DIR/Screenshots (usually ~/Pictures/Screenshots).

Wallpaper does not appear

Usually comes with these little messages:

(colorshell:328024): Colorshell-WARNING **: 22:03:43.047: Wallpaper: hyprpaper isn't currently running or it couldn't be spotted.
(colorshell:328024): Colorshell-WARNING **: 22:03:43.047: Wallpaper: Functionality like wallpaper hot-reloading may not work

Colorshell no more starts hyprpaper by itself, you either add hyprpaper to your auto-start or you use the systemd service(hyprpaper.service in user scope).

Can I use AI to contribute?

You must not use AI, unless if you're a developer(or can at least understand the code) and you review the generated code, confirm that it works as expected and it isn't trash code, you're good to go.

CLI (Command-Line Interface)

Colorshell has an built-in command-line interface for you to use in your config!
You can check it's docs with colorshell --help :3

Uninstalling

We're at our goodbyes already...?!

AUR

yay -Rns colorshell

(or colorshell-git if you use the latest commit version)

Nix/NixOS

nix profile remove colorshell

From manual installation

You can remove colorshell from your user just by running:

rm -rf ~/.local/bin/colorshell ~/.local/share/colorshell