█████╗ ███╗   ██╗ ██████╗ ███╗   ███╗███████╗██╗  ██╗███████╗██╗     ██╗     
██╔══██╗████╗  ██║██╔═══██╗████╗ ████║██╔════╝██║  ██║██╔════╝██║     ██║     
███████║██╔██╗ ██║██║   ██║██╔████╔██║███████╗███████║█████╗  ██║     ██║     
██╔══██║██║╚██╗██║██║   ██║██║╚██╔╝██║╚════██║██╔══██║██╔══╝  ██║     ██║     
██║  ██║██║ ╚████║╚██████╔╝██║ ╚═╝ ██║███████║██║  ██║███████╗███████╗███████╗
╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝ ╚═╝     ╚═╝╚══════╝╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝

A Quickshell configuration built for Omarchy — opinionated, minimal, and yours.

⚠️ Alpha — Anomshell is a personal customization and learning project. It depends on Omarchy components and is mainly intended for Omarchy users.

---

📸 Showcase (Video is Outdated)

screenrecording-2026-03-29_02-55-33.mp4

---

✦ Features

▍Bar

A minimal bar with clean workspace styling, Omarchy status modules, and performance stats. Theme‑aware, lightweight, and designed to stay out of the way while still being informative.

• Omarchy button — opens the main launcher
• Workspaces — shows your workspace list and highlights the active one
• Media — displays the current track and opens the mini player card on hover (takes colors from album cover art for a more aesthetic look)
• System stats — quick glance CPU and RAM, shows a progress bar on hover
• Tray — for applications only
• Notification & Control Center — access notifications, volume sliders, DND, Wi-Fi and Bluetooth manager
• Clock — shows time and date; hover reveals a calendar
• Notification indicator — lets you know when something arrives
• Settings — switch bar position, bar style, launcher logo, and workspace style live from the UI
• Includes Omarchy idle locking and more

---

▍Dock

Fast minimal and functional dock.

• Main button like launcher and taskmanger always pinned
• Smart Auto hide setting
• Right click to pin app to dock

---

▍Launcher

Fast, minimal, and keyboard‑first. Opens instantly, filters as you type, and stays clean and distraction‑free.

• Instant search across all sub-menus (Global Search)
• Inspired by the Omarchy Walker menu
• Quick sections for utilities and custom menus with dedicated keybinds
• Flatpak application support

---

▍Theme & Background Picker

A fresh interface for switching themes and wallpapers on the fly.

• Dedicated keybinds for both
• One-row scrollable layout
• Keyboard and mouse navigation

---

▍OSD

A new-style OSD for volume and media with a fluid visualizer running in the background.

• Dedicated keybinds for each OSD
• Media OSD shows progress bar and cover art

---

▍Media Card

Inspired by end4-dots. Appears on hover over the Media module in the bar.

• Play/Pause and Forward/Backward track controls
• Adapts colors from album cover art

---

▍Clipboard & Keybinds Manager

A clean manager with organized clipboard history and keybind reference.

• Dedicated keybinds for both
• Image previews in Clipboard with a clear-all button

---

▍Widgets

Clean, minimal widgets that slot into your workflow.

• 3+ widgets — enable or disable via Settings
• Working To-do widget
• Pomodoro timer (25 min focus / 5 min rest)

---

▍Task Manager

Clean, minimal TaskManger in quickshell.

• Have $ different Tabs for different things
• Can kill multiple process by selecting them
• Play/pause graph to watch carefully
• More

---

▍Settings

A clean control panel. No config file editing required. Everything updates live.

• Bar — choose between layouts and positions
• OSD — move the volume/brightness overlay anywhere
• Launcher — swap the logo/icon to match your setup
• Workspaces — switch visual styles and adjust numbering display
• General — control shell-wide behavior in one place
• More now — Dock, Widgets and etc
• Changes apply live — tweak and preview instantly

---

⌨️ Keybindings

Main Controls

Keybind	Action
SUPER + SHIFT + Q	Start Quickshell
SUPER + ALT + SPACE	Open menu launcher
SUPER + SPACE	Open app launcher
SUPER + CTRL + SHIFT + SPACE	Open theme picker
SUPER + CTRL + ALT + SPACE	Open settings
SUPER + K	Open keybindings viewer
SUPER + ESC	Open system menu
SUPER + CTRL + V	Open clipboard manager
SUPER + CTRL + SPACE	Open background picker
SUPER + CTRL + E	Open emoji picker
SUPER + CTRL + O	Open toggle menu
SHIFT + CTRL + ESCAPE	Open Task manager
SUPER + CTRL + ,	Toggle Do Not Disturb

Media Controls

Keybind	Action
Volume Up	Increase volume
Volume Down	Decrease volume
Mute	Toggle mute

Brightness Controls

Keybind	Action
Brightness Up	Increase brightness
Brightness Down	Decrease brightness

Screen Tools

Keybind	Action
ALT + PRINT	Open screen recorder

---

📁 Repo Structure

anomshell/
├── config/
│   ├── hypr/
│   │   └── bindings.conf
│   └── quickshell/
│
├── local/
│   └── bin/
│       ├── qs.sh
│       └── wb-kill.sh
│
├── LICENSE
└── README.md

---

📦 Installation

Warning

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

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, copy the Quickshell binds, and manually paste them at the end of ~/.config/hypr/bindings.conf.

This avoids breaking your existing keybind setup.

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

~/.local/bin/qs.sh

or use the keybind: SUPER + SHIFT + Q

---

📝 Notes

• Ensure ~/.local/bin is in your $PATH
• Restart Hyprland if binds don't work
• Manual config merging is intentional — it prevents overwriting your existing setup
• Tested on a personal Omarchy setup

---

🔧 Troubleshooting

Verify Quickshell runs:

quickshell

Check IPC:

quickshell ipc list

Verify scripts:

ls -l ~/.local/bin

---

🚧 Status

Anomshell is in active alpha development. Expect occasional bugs or rough edges. Please report issues with logs and screenshots so they can be fixed fast.

---

💙 Credits

Thanks to @OldJobobo for helping.

---

Built with intention. Breaks occasionally. Worth it.