Forked from Axenide/Ax-Shell - A hackable shell for Hyprland

---

Screenshots

Changes from Ax-Shell

Aw-Shell builds on the original Ax-Shell with the following improvements:

• New PySide6 settings gui - the first step of the migration to pyside6 (Qt6) gui.
• Refactored controls — simplified and reorganized control panel
• Improved launcher — better search relevance and multi-monitor awareness
• Multi-monitor fixes — dashboard and workspaces open on the correct monitor
• uv package manager — replaced manual pip/venv setup with uv sync for reproducible installs
• Glaze theming — integrated Glaze for consistent Qt6 styling
• Test suite — added unit tests for core utilities (layout, signals, settings conversion)
• Code quality — pathlib over os.path, cleaned up imports, removed deprecated typings

Installation

Note

You need a functioning Hyprland installation. This will also enable NetworkManager if it is not already enabled.

Arch Linux

Tip

This command also works for updating an existing installation!

Run the following command in your terminal once logged into Hyprland:

curl -fsSL https://raw.githubusercontent.com/Awareness10/Aw-Shell/main/install.sh | bash

Manual Installation

1. Install uv:

   curl -LsSf https://astral.sh/uv/install.sh | sh

2. Install system dependencies (Arch Linux):

   • fabric-cli
   • Gray
   • Matugen
   • awww brightnessctl cava cliphist ddcutil
   • gnome-bluetooth-3.0 gobject-introspection gpu-screen-recorder
   • hypridle hyprlock hyprpicker hyprshot hyprsunset
   • imagemagick libnotify networkmanager network-manager-applet
   • nm-connection-editor noto-fonts-emoji nvtop playerctl
   • power-profiles-daemon swappy tesseract tesseract-data-eng
   • tesseract-data-spa tmux unzip upower uwsm vte3
   • webp-pixbuf-loader wl-clipboard

3. Clone, install Python deps, and run:

   git clone https://github.com/Awareness10/Aw-Shell.git ~/.config/aw-shell
   cd ~/.config/aw-shell
   uv sync
   uwsm app -- .venv/bin/python main.py > /dev/null 2>&1 & disown

Features

• App Launcher
• Bluetooth Manager
• Calculator
• Calendar
• Clipboard Manager
• Color Picker
• Customizable UI
• Dashboard
• Dock
• Emoji Picker
• Kanban Board
• Network Manager
• Notifications
• OCR
• Pins
• Power Manager
• Power Menu
• Screen Recorder
• Screenshot
• Settings
• System Tray
• Terminal
• Tmux Session Manager
• Update checker
• Vertical Layout
• Wallpaper Selector
• Workspaces Overview
• Multi-monitor support

---

Originally based on Ax-Shell by Axenide. Consider supporting the original author on Ko-fi.