{"id":25401950,"url":"https://github.com/meowrch/mewline","last_synced_at":"2026-03-13T08:10:43.598Z","repository":{"id":276158421,"uuid":"927536403","full_name":"meowrch/mewline","owner":"meowrch","description":"đŸ˜ē Elegant and extensible status bar for the meowrch distribution","archived":false,"fork":false,"pushed_at":"2026-03-07T09:57:11.000Z","size":38603,"stargazers_count":31,"open_issues_count":0,"forks_count":5,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-07T17:20:36.221Z","etag":null,"topics":["animations","arch","bar","beautiful","dots","dynamic-island","fabric","linux","meowrch","polybar","pygobject","scss","status-bar","theme","waybar","widgets"],"latest_commit_sha":null,"homepage":"https://meowrch.github.io/en/meowrch-base/ecosystem/mewline/mewline/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/meowrch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-05T05:46:26.000Z","updated_at":"2026-03-07T09:56:25.000Z","dependencies_parsed_at":"2025-12-13T22:12:02.267Z","dependency_job_id":null,"html_url":"https://github.com/meowrch/mewline","commit_stats":null,"previous_names":["meowrch/mewline"],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/meowrch/mewline","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meowrch%2Fmewline","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meowrch%2Fmewline/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meowrch%2Fmewline/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meowrch%2Fmewline/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/meowrch","download_url":"https://codeload.github.com/meowrch/mewline/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meowrch%2Fmewline/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30462087,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-13T06:34:02.089Z","status":"ssl_error","status_checked_at":"2026-03-13T06:33:49.182Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["animations","arch","bar","beautiful","dots","dynamic-island","fabric","linux","meowrch","polybar","pygobject","scss","status-bar","theme","waybar","widgets"],"created_at":"2025-02-16T01:20:51.548Z","updated_at":"2026-03-13T08:10:43.554Z","avatar_url":"https://github.com/meowrch.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\t\u003ch1\u003e ✨ Mewline \u003c/h1\u003e\n\t\u003ca href=\"https://github.com/meowrch/mewline/issues\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/github/issues/meowrch/mewline?color=ffb29b\u0026labelColor=1C2325\u0026style=for-the-badge\"\u003e\n\t\u003c/a\u003e\n\t\u003ca href=\"https://github.com/meowrch/mewline/stargazers\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/github/stars/meowrch/mewline?color=fab387\u0026labelColor=1C2325\u0026style=for-the-badge\"\u003e\n\t\u003c/a\u003e\n\t\u003ca href=\"./LICENSE\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/github/license/meowrch/mewline?color=FCA2AA\u0026labelColor=1C2325\u0026style=for-the-badge\"\u003e\n\t\u003c/a\u003e\n\t\u003cbr\u003e\n\t\u003cbr\u003e\n\t\u003ca href=\"./README.ru.md\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/badge/README-RU-blue?color=cba6f7\u0026labelColor=1C2325\u0026style=for-the-badge\"\u003e\n\t\u003c/a\u003e\n\t\u003ca href=\"./README.md\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/badge/README-ENG-blue?color=C9CBFF\u0026labelColor=C9CBFF\u0026style=for-the-badge\"\u003e\n\t\u003c/a\u003e\n\u003c/div\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\nAn 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.\n\n\u003ctable align=\"center\"\u003e\n \u003ctr\u003e\n \u003ctd colspan=\"3\"\u003e\u003cimg src=\"./assets/preview.png\"\u003e\u003c/td\u003e\n \u003c/tr\u003e\n \u003ctr\u003e\n \u003ctd colspan=\"1\"\u003e\u003cimg src=\"./assets/preview1.png\"\u003e\u003c/td\u003e\n \u003ctd colspan=\"1\"\u003e\u003cimg src=\"./assets/preview2.png\"\u003e\u003c/td\u003e\n \u003ctd colspan=\"1\"\u003e\u003cimg src=\"./assets/preview3.png\"\u003e\u003c/td\u003e\n \u003c/tr\u003e\n \u003ctr\u003e\n \u003ctd colspan=\"1\"\u003e\u003cimg src=\"./assets/preview4.png\"\u003e\u003c/td\u003e\n \u003ctd colspan=\"1\"\u003e\u003cimg src=\"./assets/preview5.png\"\u003e\u003c/td\u003e\n \u003ctd colspan=\"1\"\u003e\u003cimg src=\"./assets/preview6.png\"\u003e\u003c/td\u003e\n \u003c/tr\u003e\n \u003ctr\u003e\n \u003ctd colspan=\"3\"\u003e\u003cimg src=\"./assets/preview7.png\"\u003e\u003c/td\u003e\n \u003c/tr\u003e\n\u003c/table\u003e\n\n## 🌟 Features\n- [X] **Hyprland and bspwm support**: Full integration with modern tiling window managers.\n- [X] **Multi-monitor support**: Support for automatic panel deployment on all detected displays (currently only implemented for Hyprland).\n- [X] **Privacy indicators (Privacy Dots)**: Visual notification of microphone, camera, geolocation, or screen recording usage in real time.\n- [X] **Modular architecture and customization** via JSON config\n- [X] **Theme** support\n- [X] Full integration with the [meowrch](https://github.com/meowrch/meowrch) distribution\n- [X] Animated transitions and effects\n- [X] Low resource usage\n- [X] Keyboard control\n\n## ⚙ī¸ Configuration\nSee [English configuration docs](docs/configuration.md) for detailed configuration info.\n\n## 🧩 Install dependencies\n```bash\nsudo pacman -S dart-sass tesseract tesseract-data-eng tesseract-data-rus slurp grim cliphist\nyay -S gnome-bluetooth-3.0 gray-git fabric-cli-git\n```\n\n## ⚡ Quick start\n```bash\n# Install the package\nyay -S mewline-git\n\n# Generate the default config\nmewline --generate-default-config\n\n# Generate keybindings for Hyprland\nmewline --create-keybindings\n\n# Tweak config.json to your liking\nmicro ~/.config/mewline/config.json\n\n# Run MewLine\nmewline\n```\n\n## 🛠 For developers\n```bash\n# Clone the repo\ngit clone https://github.com/meowrch/mewline \u0026\u0026 cd mewline\n\n# Install the package manager\npip install uv # Or: sudo pacman -S uv\n\n# Install dependencies\nuv sync\n\n# Generate the default config\nuv run generate_default_config\n\n# Generate keybindings for Hyprland\nuv run create_keybindings\n\n# Tweak config.json to your liking\nmicro ~/.config/mewline/config.json\n\n# Run MewLine\nuv run mewline\n```\n\n## 🎨 Widgets\n### ℹī¸ Status Bar\n\n| Component | Description |\n| ------------ | -------------------------------------- |\n| `tray` | System tray |\n| `workspaces` | Workspace management |\n| `datetime` | Date and time display |\n| `combined_controls` | A group control widget that combines sound, brightness, and Privacy Dots (notification dots that light up when apps access your media devices). |\n| `language` | Keyboard layout information |\n| `battry` | Battery charge information |\n| `power` | Button to open the `power_menu` |\n| `ocr` | Text recognition from a screenshot |\n\n## 🏝 Dynamic Island\n\n| Component | Description | Keybinding |\n| ------------------- | ----------------------------------------------------------- | ----------------- |\n| `compact` | Shows active window and currently playing music | - |\n| `notifications` | Notifications | - |\n| `power_menu` | Power management menu | `Super+Alt+P` |\n| `date_notification` | Calendar and notifications history | `Super+Alt+D` |\n| `bluetooth` | Bluetooth manager | `Super+Alt+B` |\n| `app_launcher` | Application launcher | `Super+Alt+A` |\n| `wallpapers` | Wallpaper picker | `Super+Alt+W` |\n| `emoji` | Emoji picker | `Super+Alt+.` |\n| `clipbpard` | Clipboard manager | `Super+Alt+V` |\n| `network` | Wi-Fi and Ethernet manager | `Super+Alt+N` |\n| `workspaces` | Open windows/workspaces manager | `Super+Alt+Tab` |\n\n### ⌨ī¸ Keybindings\nYou can control the Dynamic Island using keybindings. If you haven't generated the Hyprland config yet, run:\n```bash\nmewline --create-keybindings\n```\n\n## ❓ Other\n\n| Component | Description |\n| --------- | ------------------------------------------------------- |\n| `osd` | On-screen display for volume/brightness change events |\n\n## 🐾 Special Thanks\nThis project is inspired by and borrows great ideas from:\n\n- **[HyDePanel](https://github.com/rubiin/HyDePanel)** \\\n Modular system architecture, some styles and widgets.\n\n- **[Ax-Shell](https://github.com/Axenide/Ax-Shell)** \\\n Approach to handling system events, IPC mechanisms, some styles and widgets.\n\nWe 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.\n\n## 🚀 Contributing\nWant to add a new widget or improve an existing one?\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/amazing-widget`\n3. Push your changes: `git push origin feature/amazing-widget`\n4. Open a Pull Request\n\nWe recommend discussing the idea in Issues first.\n\n## ☕ Support the project\nIf you like MewLine, you can support its development:\n\n| Cryptocurrency | Address |\n| -------------- | ---------------------------------------------------- |\n| **TON** | `UQB9qNTcAazAbFoeobeDPMML9MG73DUCAFTpVanQnLk3BHg3` |\n| **Ethereum** | `0x56e8bf8Ec07b6F2d6aEdA7Bd8814DB5A72164b13` |\n| **Bitcoin** | `bc1qt5urnw7esunf0v7e9az0jhatxrdd0smem98gdn` |\n| **Tron** | `TBTZ5RRMfGQQ8Vpf8i5N8DZhNxSum2rzAs` |\n\nYour support motivates us to build more great features! ❤ī¸\n\n## 📊 Stats\n[![Star History Chart](https://api.star-history.com/svg?repos=meowrch/mewline\u0026type=Date)](https://star-history.com/#meowrch/mewline\u0026Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeowrch%2Fmewline","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmeowrch%2Fmewline","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeowrch%2Fmewline/lists"}