Ax-Shell by @Axenide · Hyprland on Arch Linux

01. Overview & Architecture

Schema validatedSource pinned

Purpose: Hyprland shell written with Fabric: notch bar, dashboard, launcher and wallpaper colors.
Compatibility: Arch Linux (Server: WAYLAND)
Desktop Part: Dotfiles & full rices
Window Manager & Theme: Hyprland / Material

02. Installation & Deployment

Step-by-step deployment protocol

Step-by-step deployment

1Clone the repository

Shell commands

$git clone --filter=blob:none https://github.com/Axenide/Ax-Shell

$git -C Ax-Shell checkout 1a3551fb6d1d5354c99f31880a39f7c7149da78e

$cd Ax-Shell

2Run the upstream installer

Shell commands

$bash install.sh

04. Documentation & Guide

Source: Axenide/Ax-ShellRef: 1a3551fb6d

README.md|GitHub Flavored Markdown

Raw Source ↗

Warning

Ax-Shell has been deprecated in favor of Ambxst and will not receive any more updates.

Ambxst is more performant, customizable and feature-rich, and has feature parity with Ax-Shell. Go check it out!

Screenshots

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 get.axeni.de/ax-shell | bash

Alternative:

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

NixOS

poogas has created a flake for Ax-Shell. 👉 Try it out! 👈

Manual Installation

Install dependencies:
- Fabric
- fabric-cli
- Gray
- Matugen
- awww
- brightnessctl
- cava
- cliphist
- ddcutil
- gnome-bluetooth-3.0
- gobject-introspection
- gpu-screen-recorder
- grimblast
- hypridle
- hyprlock
- hyprpicker
- hyprshot
- hyprsunset
- imagemagick
- libnotify
- networkmanager
- network-manager-applet
- nm-connection-editor
- noto-fonts-emoji
- nvtop
- playerctl
- swappy
- tesseract
- tesseract-data-eng
- tesseract-data-spa
- tmux
- unzip
- upower
- uwsm
- vte3
- webp-pixbuf-loader
- wl-clipboard
- Python dependencies:
  - PyGObject
  - ijson
  - numpy
  - pillow
  - psutil
  - pywayland
  - requests
  - setproctitle
  - toml
  - watchdog
- Fonts (automated on first run):
  - Zed Sans
  - Tabler Icons

Download and run Ax-Shell:

git clone https://github.com/Axenide/Ax-Shell.git ~/.config/Ax-Shell
uwsm -- app python ~/.config/Ax-Shell/main.py > /dev/null 2>&1 & disown

Roadmap

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
Multimodal AI Assistant
OSD
OTP Manager

^{sᴜᴘᴘᴏʀᴛ ᴛʜᴇ ᴘʀᴏᴊᴇᴄᴛ}

GitHub Flavored Markdown (github-markdown-css)README snapshot at 1a3551fb6d