eqSh

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

---

---

Download

Install Guide

Issues

---

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.

---

🚀 Quickstart

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

qs -c eqsh

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

exec-once = qs -c eqsh

4. Post-Install

Icon theme: MacTahoe Icon Theme

GTK theme: MacTahoe GTK Theme

---

✨ Features

• Top Panel
• Notch (Dynamic Island + Spotlight-like Runner)
• Notifications
• Dialogs with IPC integration
• App Drawer / Launchpad
• Lockscreen
• Wallpaper Engine
• System Tray
• Battery & WiFi Indicators
• Clock
• Full JSON user settings & Settings App

---

🛠 Coming Soon

• Dock with magnification
• Global Menu
• Control Center
• Desktop Icons & Widgets
• Spotlight Extensions
• Custom dropdown menus
• Advanced IPC-powered popup system
• Layered wallpapers & lockscreen

---

📖 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.

---

🌌 eqSh = Linux + Elegance

Stop juggling multiple apps.
Let them rely on eqSh.