Files
Modus/mine/README.md
T
2026-07-12 18:56:10 +05:45

114 lines
5.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ⚙️ Modus
<p align="center">
<img src="assets/screenshots.png" alt="screenshots">
</p>
> **Status**: Always a Work in Progress 🛠️
> **Not optimized**, could use more memory and CPU than expected
This shell setup is intentionally crafted to reflect my personal taste in both aesthetics and workflow.
It includes core components like a panel, launcher, OSD, and hot-reloadable configurations — all optimized for speed, minimalism, and keyboard-centric interaction.
---
## ✅ Core Features
- [x] Hot reload (no shell restart required)
- [x] Panel
- [x] On-Screen Display (OSD)
- [x] Launcher
- [x] Notification popups
---
## 🔎 Launcher Plugins — Quick Reference
For full details, see the plugin docs in [Plugin.md](./assets/Plugin.md).
| Plugin | Keyword | What it does / commands | Semicolon Required |
| --------------- | ------- | ---------------------------------------------------------------------- | ------------------------ |
| Application | — | Application search (default when no keyword matches) | No |
| Bookmark | `bm` | `add`, `remove`, `update` | Yes |
| Calculator | `calc` | Mathematical expressions | No |
| Clipboard | `clip` | Clipboard history | No |
| Emoji | `em` | Emoji search | No |
| Google Lens | `lens` | Capture region and search | No |
| Google Search | `gg` | Web search | No |
| YouTube Search | `yt` | YouTube search | No |
| Link Opener | `lk` | Open a URL | No |
| Color Picker | `color` | Pick color as HEX/RGB/HSV | No |
| OTP | `otp` | `add`, `remove` | No |
| Bluetooth | `bt` | `power`, `scan`, `connect`, `disconnect` | Yes |
| Password | `pass` | `add`, `remove`, `update`; auto-prompt for master password when needed | Yes (lock/help/list: No) |
| Power Menu | `pm` | Power options | No |
| Power Profile | `power` | Power profiles | No |
| Caffeine | `caff` | On, off, custom durations (30m, 1h, 45s, 600) | No |
| Reminder | `rem` | Presets, custom times (`10m`, `1h30m`, `21:30`), optional message | No |
| Todo | `todo` | `add`, `done`, `remove`, `edit`, `clear` | Yes (except `clear`) |
| Tmux | `tmux` | `new`, `kill`, `rename`, `terminal` | Yes (except `terminal`) |
| Wallpaper | `wall` | Wallpaper browsing | No |
| Window Switcher | `win` | Window switching | No |
| SSH Manager | `ssh` | SSH hosts, `terminal`, `help` | No |
| Network Manager | `net` | Scan, connect, disconnect, forget | No |
---
Note: `wr` applies a random wallpaper immediately.
## 🧩 Launcher Plugins — Completed
The launcher supports modular plugins to extend functionality. Current plugins include:
- [x] OTP Manager
- [x] Pass Manager
- [x] Tmux Session Manager
- [x] Bookmark Manager
- [x] Power Profile Manager
- [x] Window Switcher
- [x] Power Menu
- [x] Todo Manager
- [x] Screen Capture Tool
- [x] Clipboard History Viewer
- [x] Emoji Picker
- [x] Wallpaper Picker
- [x] Calculator & Unit Converter
- [x] Caffeine Manager
- [x] SSH Session Manager
- [x] Color Picker
- [x] Reminder
- [x] Network Manager
- [x] Bluetooth Manager
- [x] Google Lens
---
## 🧩 Launcher Plugins — Planned
Planned plugins to further enhance productivity and system control:
- [ ] Calendar with Event Reminders
- [ ] Notification Manager
---
## 🙏 Special Thanks
A heartfelt thank you to the following people for their incredible contributions, ideas, and inspiration. Your work has been a huge part of shaping this shell!
- [darsh](https://github.com/its-darsh) for creating [**Fabric**](https://github.com/Fabric-Development/fabric/) and the [**Fabrika**](https://github.com/its-darsh/fabrika) config, which served as the foundation for the **Launcher** and **OSD** in this shell.
- [gummy bear album](https://github.com/muhchaudhary) for sharing clever code snippets and useful services that saved countless hours of development.
- [axenide](https://github.com/Axenide) for an inspiring config full of unique ideas, some of which I couldn’t resist adapting and integrating into my own setup.
---
## 📝 License
This project is licensed under the [GNU General Public License](https://www.gnu.org/licenses/gpl-3.0.html) (GPL v3 or later).
See the [LICENSE](./LICENSE) file for full details.
---