Modus icon indicating copy to clipboard operation
Modus copied to clipboard

A modular and extensible shell for Hyprland, written on Fabric.

Logo

Sparkles A hackable shell for Hyprland Powered by Fabric Sparkles

GitHub stars Hyprland Maintained Discord


Home Screen:

fabric

Lock Screen:

fabric

Installation

[!CAUTION]

  • You need a working installation of hyprland and knowledge of how it works
  • There may not be all packages in your system install them accordingly
git clone https://github.com/S4NKALP/Modus ~/.config/Modus
cd ~/.config/Modus
./install.sh

[!TIP]

Post Installation

  • Install recommended Icon theme , GTK theme and Cursor Theme
  • Check config/hypr/modus.conf edit it according to your device and copy it to your hyprland config
  • For Lock Screen Bind keys to python lock.py

Rocket Todo

Manual Installation (WIP)

paru -S glace-git gtk-session-lock python-pyotp python-pillow python-ijson python-setproctitle apple-fonts cinnamon-desktop --needed
git clone https://github.com/S4NKALP/Modus ~/.config/Modus
cd ~/.config/Modus
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install --no-deps git+https://github.com/Fabric-Development/fabric.git
  • [x] Launcher
  • [x] Lock Screen
  • [x] Dock
  • [x] Notification
  • [x] Control Center
  • [x] Music Player
  • [x] Desktop Widgets
  • [x] New Launcher (like Spotlight)
  • [ ] Settings
  • [x] ~~Magnifier hover effect on Dock~~
  • [x] ~~New Application Switcher~~
  • [x] Panel Widget
  • [x] MacOS like Widget
  • [x] Expandable Notification Centre
  • [ ] Installation Script
  • [ ] Proper Documentation
  • [ ] Pomodoro Timer Widget
  • [x] To-do List Widget

Bug Fixes (the bug found till now)

  • [x] WiFi
  • [x] wifi off button looks bigger
  • [x] Metadata Changes delay in Media Player
  • [x] Active Window Title showing Unknown when no active window
  • [x] Notification Escape Char Issue

Team

Special Thanks

A big thank you to the following people for their incredible help with code and creative ideas. Your help made a real difference!

  • darsh: for creating Fabric, which made everything possible.
  • gummy bear album: for sharing fantastic code snippets that saved me time and effort.
  • axenide: for the amazing config that not only inspired parts of mine but also provided some gems I couldn’t resist borrowing.
  • E3nviction: for code snippets and ideas that were incredibly helpful.

I truly appreciate your support