https://github.com/meowrch/mewline
đē Elegant and extensible status bar for the meowrch distribution
https://github.com/meowrch/mewline
animations arch bar beautiful dots dynamic-island fabric linux meowrch polybar pygobject scss status-bar theme waybar widgets
Last synced: 3 months ago
JSON representation
đē Elegant and extensible status bar for the meowrch distribution
- Host: GitHub
- URL: https://github.com/meowrch/mewline
- Owner: meowrch
- License: mit
- Created: 2025-02-05T05:46:26.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-03-07T09:57:11.000Z (3 months ago)
- Last Synced: 2026-03-07T17:20:36.221Z (3 months ago)
- Topics: animations, arch, bar, beautiful, dots, dynamic-island, fabric, linux, meowrch, polybar, pygobject, scss, status-bar, theme, waybar, widgets
- Language: Python
- Homepage: https://meowrch.github.io/en/meowrch-base/ecosystem/mewline/mewline/
- Size: 36.8 MB
- Stars: 31
- Watchers: 0
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
⨠Mewline
An elegant, extensible status bar for the [meowrch](https://github.com/meowrch/meowrch) distribution, written in Python using the [Fabric](https://github.com/Fabric-Development/fabric) framework. It combines a minimalist design with powerful functionality.
## đ Features
- [X] **Hyprland and bspwm support**: Full integration with modern tiling window managers.
- [X] **Multi-monitor support**: Support for automatic panel deployment on all detected displays (currently only implemented for Hyprland).
- [X] **Privacy indicators (Privacy Dots)**: Visual notification of microphone, camera, geolocation, or screen recording usage in real time.
- [X] **Modular architecture and customization** via JSON config
- [X] **Theme** support
- [X] Full integration with the [meowrch](https://github.com/meowrch/meowrch) distribution
- [X] Animated transitions and effects
- [X] Low resource usage
- [X] Keyboard control
## âī¸ Configuration
See [English configuration docs](docs/configuration.md) for detailed configuration info.
## 𧊠Install dependencies
```bash
sudo pacman -S dart-sass tesseract tesseract-data-eng tesseract-data-rus slurp grim cliphist
yay -S gnome-bluetooth-3.0 gray-git fabric-cli-git
```
## ⥠Quick start
```bash
# Install the package
yay -S mewline-git
# Generate the default config
mewline --generate-default-config
# Generate keybindings for Hyprland
mewline --create-keybindings
# Tweak config.json to your liking
micro ~/.config/mewline/config.json
# Run MewLine
mewline
```
## đ For developers
```bash
# Clone the repo
git clone https://github.com/meowrch/mewline && cd mewline
# Install the package manager
pip install uv # Or: sudo pacman -S uv
# Install dependencies
uv sync
# Generate the default config
uv run generate_default_config
# Generate keybindings for Hyprland
uv run create_keybindings
# Tweak config.json to your liking
micro ~/.config/mewline/config.json
# Run MewLine
uv run mewline
```
## đ¨ Widgets
### âšī¸ Status Bar
| Component | Description |
| ------------ | -------------------------------------- |
| `tray` | System tray |
| `workspaces` | Workspace management |
| `datetime` | Date and time display |
| `combined_controls` | A group control widget that combines sound, brightness, and Privacy Dots (notification dots that light up when apps access your media devices). |
| `language` | Keyboard layout information |
| `battry` | Battery charge information |
| `power` | Button to open the `power_menu` |
| `ocr` | Text recognition from a screenshot |
## đ Dynamic Island
| Component | Description | Keybinding |
| ------------------- | ----------------------------------------------------------- | ----------------- |
| `compact` | Shows active window and currently playing music | - |
| `notifications` | Notifications | - |
| `power_menu` | Power management menu | `Super+Alt+P` |
| `date_notification` | Calendar and notifications history | `Super+Alt+D` |
| `bluetooth` | Bluetooth manager | `Super+Alt+B` |
| `app_launcher` | Application launcher | `Super+Alt+A` |
| `wallpapers` | Wallpaper picker | `Super+Alt+W` |
| `emoji` | Emoji picker | `Super+Alt+.` |
| `clipbpard` | Clipboard manager | `Super+Alt+V` |
| `network` | Wi-Fi and Ethernet manager | `Super+Alt+N` |
| `workspaces` | Open windows/workspaces manager | `Super+Alt+Tab` |
### â¨ī¸ Keybindings
You can control the Dynamic Island using keybindings. If you haven't generated the Hyprland config yet, run:
```bash
mewline --create-keybindings
```
## â Other
| Component | Description |
| --------- | ------------------------------------------------------- |
| `osd` | On-screen display for volume/brightness change events |
## đž Special Thanks
This project is inspired by and borrows great ideas from:
- **[HyDePanel](https://github.com/rubiin/HyDePanel)** \
Modular system architecture, some styles and widgets.
- **[Ax-Shell](https://github.com/Axenide/Ax-Shell)** \
Approach to handling system events, IPC mechanisms, some styles and widgets.
We are grateful to the authors of these projects for their contribution to the open-source community. Some components were adapted and improved to integrate with MewLine.
## đ Contributing
Want to add a new widget or improve an existing one?
1. Fork the repository
2. Create a feature branch: `git checkout -b feature/amazing-widget`
3. Push your changes: `git push origin feature/amazing-widget`
4. Open a Pull Request
We recommend discussing the idea in Issues first.
## â Support the project
If you like MewLine, you can support its development:
| Cryptocurrency | Address |
| -------------- | ---------------------------------------------------- |
| **TON** | `UQB9qNTcAazAbFoeobeDPMML9MG73DUCAFTpVanQnLk3BHg3` |
| **Ethereum** | `0x56e8bf8Ec07b6F2d6aEdA7Bd8814DB5A72164b13` |
| **Bitcoin** | `bc1qt5urnw7esunf0v7e9az0jhatxrdd0smem98gdn` |
| **Tron** | `TBTZ5RRMfGQQ8Vpf8i5N8DZhNxSum2rzAs` |
Your support motivates us to build more great features! â¤ī¸
## đ Stats
[](https://star-history.com/#meowrch/mewline&Date)