KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

anomshell

★ 97 Open GitHub ↗

Anomshell - A Quickshell configuration for Omarchy OS

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

> ⚠️ **Archived** — Archived this project for now need to learn more about Quickshell and QML
<br>
<br>
<br>

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

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

<br>

[![Stars](https://img.shields.io/github/stars/atif-1402/anomshell?style=for-the-badge&label=⭐%20Stars&color=cba6f7&labelColor=1e1e2e)](https://github.com/atif-1402/anomshell)
[![Forks](https://img.shields.io/github/forks/atif-1402/anomshell?style=for-the-badge&label=🍴%20Forks&color=89b4fa&labelColor=1e1e2e)](https://github.com/atif-1402/anomshell/network)
[![Issues](https://img.shields.io/github/issues/atif-1402/anomshell?style=for-the-badge&label=🐛%20Issues&color=f38ba8&labelColor=1e1e2e)](https://github.com/atif-1402/anomshell/issues)
[![Ko-fi](https://img.shields.io/badge/☕%20Ko--fi-Support-fab387?style=for-the-badge&labelColor=1e1e2e)](https://ko-fi.com/anom538)

<br>

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

</div>

---

## 📸 Showcase (Video is Outdated)

https://github.com/user-attachments/assets/d1263480-0ff5-495d-80c8-605b29049f7e

<br>

</div>

---

## ✦ 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

### Media Controls

### Brightness Controls

### Screen Tools

---

## 📁 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

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

### 2 — Clone the repository

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

### 3 — Backup existing config *(recommended)*

```bash
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

```bash
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

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

### 7 — Start Quickshell

```bash
~/.local/bin/qs.sh
```

or use the keybind: `SUPER + SHIFT + Q`

### 8 — Start Quickshell at startup *(optional)*

```bash
cat >> ./.config/hypr/autostart.conf << 'EOF'
exec-once = ~/.local/bin/wb-kill.sh
exec-once = ~/.local/bin/qs.sh
EOF
```

---

### 📝 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:**
```bash
quickshell
```

**Check IPC:**
```bash
quickshell ipc show
```

**Verify scripts:**
```bash
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](https://github.com/OldJobobo) for helping.
Thanks to [@S0NN1](https://github.com/S0NN1) for helping.

---

*Built with intention. Breaks occasionally. Worth it.*

</div>

anomshell

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README