Modus
A modular and extensible shell for Hyprland, written on Fabric.
Install / Use
/learn @S4NKALP/ModusREADME
<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">
</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
git clone https://github.com/S4NKALP/Modus ~/.config/Modus
cd ~/.config/Modus
./install.sh
<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>[!TIP]
Post Installation
- Install recommended Icon theme , GTK theme and Cursor Theme <br>
- Check
config/hypr/modus.confedit it according to your device and copy it to your hyprland config- For Lock Screen Bind keys to
python lock.py
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
Unknownwhen 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
