Installation

Step-by-step setup guide for anomshell on an Omarchy system.

This setup modifies your Hyprland configuration. Backup your configs before continuing. Do not blindly overwrite configs unless you know what you are doing.
1

Install dependencies

Install all required packages via pacman:

sudo pacman -S --needed quickshell cava cliphist wl-clipboard imagemagick jq
2

Clone the repository

git clone https://github.com/atif-1402/anomshell.git
cd anomshell
3

Backup existing config (recommended)

cp -r ~/.config/quickshell ~/.config/quickshell.backup 2>/dev/null
cp ~/.config/hypr/bindings.conf ~/.config/hypr/bindings.conf.backup 2>/dev/null
4

Install Quickshell config

cp -r config/quickshell ~/.config/
5

Install keybinds (manual merge recommended)

Open config/hypr/bindings.conf and manually paste the Quickshell binds at the end of your ~/.config/hypr/bindings.conf. This avoids breaking existing keybind setups.

6

Install helper scripts

cp local/bin/* ~/.local/bin/
chmod +x ~/.local/bin/qs.sh
chmod +x ~/.local/bin/wb-kill.sh
7

Start Quickshell

Run the start script or use the keybind after reloading Hyprland:

~/.local/bin/qs.sh

Or press Super + Shift + Q

Troubleshooting

# Verify quickshell runs
quickshell

# Check IPC
quickshell ipc list

# Verify scripts exist
ls -l ~/.local/bin

Make sure ~/.local/bin is in your $PATH. Restart Hyprland if binds don't take effect.