GitPedia

Modus

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

From S4NKALP·Updated June 10, 2026·View on GitHub·

> [!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 The project is written primarily in Python, distributed under the GNU General Public License v3.0 license, first published in 2025. Key topics include: arch-linux, archlinux, desktop, dotfiles, dots.

<p align="center"> <img src="assets/modus.png" height="200" alt="Logo"> </p> <p align="center"> <sub><sup><img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Telegram-Animated-Emojis/main/Activity/Sparkles.webp" alt="Sparkles" width="25" height="25"/></sup></sub> <a href="https://github.com/hyprwm/Hyprland"> <img src="https://img.shields.io/badge/A%20hackable%20shell%20for-Hyprland-0092CD?style=for-the-badge&logo=linux&color=0092CD&logoColor=D9E0EE&labelColor=000000" alt="A hackable shell for Hyprland"> </a> <a href="https://github.com/Fabric-Development/fabric/"> <img src="https://img.shields.io/badge/Powered%20by-Fabric-FAFAFA?style=for-the-badge&logo=python&color=FAFAFA&logoColor=D9E0EE&labelColor=000000" alt="Powered by Fabric"> <sub><sup><img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Telegram-Animated-Emojis/main/Activity/Sparkles.webp" alt="Sparkles" width="25" height="25"/></sup></sub> </a> </p> <div align="center">

GitHub stars
Hyprland
Maintained
Discord

</div> <br> <figure> <h2>Home Screen:</h2> <img src="assets/screenshots/home.png" alt="fabric"> <br/> <h2>Lock Screen:</h2> <img src="assets/screenshots/lock.png" alt="fabric"> </figure> <br>

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
bash
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 <br>
  • 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
<h2><sub><img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Travel%20and%20places/Rocket.png" alt="Rocket" width="25" height="25" /></sub> Todo</h2>

Manual Installation (WIP)

bash
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
  • Launcher
  • Lock Screen
  • Dock
  • Notification
  • Control Center
  • Music Player
  • Desktop Widgets
  • New Launcher (like Spotlight)
  • Settings
  • Magnifier hover effect on Dock
  • New Application Switcher
  • Panel Widget
  • MacOS like Widget
  • Expandable Notification Centre
  • Installation Script
  • Proper Documentation
  • Pomodoro Timer Widget
  • To-do List Widget

Bug Fixes (the bug found till now)

  • WiFi
  • wifi off button looks bigger
  • Metadata Changes delay in Media Player
  • Active Window Title showing Unknown when no active window
  • 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

Contributors

Showing top 3 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from S4NKALP/Modus via the GitHub API.Last fetched: 6/16/2026