eqSh

“Sometimes less is more, when it's built right.”

---

---

Install

Issues

Wiki

---

eqSh is the next-generation shell for Hyprland —
a polished, Apple-inspired Linux environment for both superusers and everyday users.

It’s more than a bar. eqSh is your panel, notch, launcher, notifications hub, lockscreen, wallpaper engine, tray, and more — all in one.

Preview

More Screenshots

---

🚀 Quickstart

Wiki

Install Guide

1. Install Quickshell

Arch

yay -S quickshell

NixOS

{
	inputs = {  
		nixpkgs.url = "nixpkgs/nixos-unstable";  

		quickshell = {
			url = "git+https://git.outfoxxed.me/outfoxxed/quickshell";
			inputs.nixpkgs.follows = "nixpkgs";
		};
	};
}

Fedora

sudo dnf copr enable errornointernet/quickshell
sudo dnf install quickshell

Guix

guix install quickshell

2. Install using CLI

pip install git+https://github.com/eq-desktop/cli.git
equora install

2. Clone git repository (Old way of installing)

mkdir ~/eqSh
mkdir ~/.config/quickshell
git clone https://github.com/eq-desktop/eqSh ~/eqSh
git submodule update --init --recursive
mv ~/eqSh/eqsh ~/.config/quickshell/

For wallpapers do:

git clone https://github.com/eq-desktop/wallpapers.git ~/eqSh/wallpapers

3. Start eqSh

equora run

Or make it permanent by adding this to ~/.config/hypr/hyprland.conf:

exec-once = equora run

4. Post-Install

Icon theme: MacTahoe Icon Theme

GTK theme: MacTahoe GTK Theme

Hyprland Config: Hyprland Config

---

Configuration

1. Keybinds

To assign eqsh actions to keybinds you can use this format

bind = mod, key, global, eqsh: action_name

EqSh is designed to be used with a keyboard, which is why it has a lot of actions:

• widgets: Toggles Widget Edit Mode
• sigrid: Toggles Sigrid AI Assistant
• launchpad: Toggles Launchpad
• lock: Locks the screen
• unlock: Unlocks the screen (Not recommended)
• toggleNotchActiveInstance: Toggles the Notchs active instance, opening or closing it
• toggleNotchInfo: Toggles the Notchs info panel (not implemented yet)
• notificationCenter: Toggles the Notification Center
• notificationCenterOpen: Opens the Notification Center
• notificationCenterClose: Closes the Notification Center
• controlCenterBluetooth: Opens the Bluetooth Menu
• controlCenter: Opens the Control Center
• screenshot: Opens the Screenshot Menu
• screenshotRegion: Opens the Screenshot Region Selector
• screenshotEntireScreen: Takes a screenshot of the entire screen
• settings: Opens the Settings
• spotlight: Opens the Spotlight

---

✨ Features

• Top Panel
• Notch
• Notch Applications
• Notifications
• Modals with IPC integration
• App Drawer / Launchpad
• Lockscreen
• Wallpaper Engine
• System Tray
• Battery & WiFi Indicators
• Clock
• On-Screen-Displays for Volume and Brightness
• Polkit
• Control Center
• Dock
• Sigrid AI Chatbot
• Desktop Widgets
• Screenshot tool
• Full JSON user settings & Settings App
• Control Center
• Advanced IPC-powered popup system

---

🛠 Coming Soon

• Dock with magnification
• Global Menu
• Desktop Files
• Spotlight Extensions
• Custom dropdown menus

---

📖 Documentation

👉 Full docs & guides: Wiki

---

⚖️ License

This project is released under the APACHE-2.0 License.
You are free to use, modify, and distribute — but all changes must remain open-source.