Lunur-Shell

Warning

This is in active development

Screenshots

As of 8/3/25

Installation

Note

You need a functioning Hyprland installation.

Clone the repo:

  git clone https://github.com/dianaw353/Lunur-Shell.git ~/.config/Lunur-Shell
  cd ~/.config/Lunur-Shell/

Option 1: Automated Installation

Step 1: Run the script

Run the following script

  ./install_requirements.sh

Step 2: Run Lunur-Shell

  uv run main.py

Option 2: Manual Installation

Step 1: Install system packages

  yay -S --needed - < ~/.config/Lunur-Shell/assets/packages/arch/packages_official.txt
  yay -S --needed - < ~/.config/Lunur-Shell/assets/packages/arch/packages_aur.txt

Step 2: Run Lunur-Shell

uv is a Python package and project manager in whitch it will download and install python dependencies and run the shell

  uv run main.py

Roadmap

• App Launcher
• Workspaces
• Window Title
• Date/Time
• Calender
• Battery
• Network Manager
• Bluetooth Manager
• Clipboard Manager
• Power Manager
• Power Menu
• Color Picker
• QuickSettings (in progress)
• Notifications
• System Tray
• Keybind Cheat Sheet
• Screen Recorder (basic)
• Screenshots (basic)
• OCR
• OSD (volume and brightness added, more to come soon)
• Emoji Picker
• Theme Switcher
• Wallpaper Switcher
• Media Player (half done)
• Matugen theme (in progress)

Sister Projects

• Lunur-Dots
• Lunur-Wallpaper