<div align="center">

<a href="https://meowrch.github.io/"><img src=".meta/logo.png" width="280px" alt="Meowrch Logo"></a>

≽ܫ≼ Meowrch

Arch Linux. Evolved.

Where performance meets aesthetics

<br>

<br>

🚀 Installation • <img src="https://cdn.simpleicons.org/nixos/5277C3" width="16"> NixOS version • <img src="https://cdn.simpleicons.org/apple/FFFFFF" width="16"> MacBook version

⚡ Features • 📸 Gallery • 📖 Wiki

💬 Community

</div>

---

🎯 Why Another Rice?

Most ready-made rice setups for Arch solve only one problem:

• Either beauty, but the system eats RAM.
• Or performance, but the UI looks ugly.
• Or functionality, but the code turns into "spaghetti" that you can't fix yourself.

Meowrch is a different approach:

We don't sacrifice one for the other. Instead, we create a system where each component is chosen based on the principle of "maximum results with minimum resources".

But most importantly — we don't limit ourselves to beautiful configs.

We create our own tools that solve long-standing pain points of the entire Linux community:

<table> <tr> <td> 🏷️ Nemo Tags

For 10+ years the community requested a tagging system for Nemo. Developers ignored it. We made it.

Now file organization like in macOS Finder is available to everyone.

</td> </tr> <tr> <td> 🩸 BlueVein

Dual-boot Windows/Linux = Bluetooth hell. Switched OS? Reconnect your mouse, keyboard, headphones. Every. Single. Time.

We solved this agonizing problem.

</td> </tr> </table>

[!NOTE] All our tools are open-source and work not only in Meowrch.
We develop an ecosystem for the entire Linux community, not just "making it pretty for ourselves".

---

🌟 Why Meowrch?

<div align="center">

| Feature | What it gives you | |:---:|:---| | Optimization | The system has the best optimizations from ARU and CachyOS. More details | | Community theme store | Change the appearance of the entire system with one command | | Open-source development | We support Linux development by creating our own components, useful for the global Linux community. More details here | | Automation | Installation in 10 minutes, complete setup and optimization — without manual config editing | | Ergonomics | Hotkeys are thought out down to the smallest detail — work faster | | Two environments | BSPWM (X11) or Hyprland (Wayland) — stability or modernity | | Lightweight | 1 GB RAM at system startup — thanks to lightweight components |

</div>

---

📸 Visual Presentation

<table align="center"> <tr> <td colspan="3"> <a href="https://youtu.be/ZZnBopmVzz4"> <img src=".meta/assets/video-preview-youtube.png" width="100%" alt="Meowrch Video Preview"> </a> </td> </tr> <tr> <td><img src=".meta/assets/1.png" alt="Basic applications and widgets"></td> <td><img src=".meta/assets/2.png" alt="Desktop music visualization use case demonstration."></td> <td><img src=".meta/assets/3.png" alt="Adobe software functionality demonstration (Photoshop, AfterEffects)"></td> </tr> <tr> <td><img src=".meta/assets/4.png" alt="Latest Steam games functionality demonstration with complex protection technologies like Denuvo (using Mafia: The Old Country as example)"></td> <td><img src=".meta/assets/5.png" alt="VSCode workflow demonstration"></td> <td><img src=".meta/assets/6.png" alt="Desktop wallpaper change animation demonstration via mewline dynamic island"></td> </tr> </table>

---

🏝️ Meet Mewline — Dynamic Island for Linux

Compact interface, maximum information:

• System tray — all your background applications
• Workspaces — quick switching between desktops
• Date & Time — always visible
• Brightness — screen brightness control
• Volume — sound control
• Battery — charge and charging status
• Power — power management menu
• OCR — text recognition from selected screen area.

Interactive system control center:

• Compact mode — information about active window and playing music
• Information menu — calendar and notification history (Super+Alt+D)
• App launcher — application launcher (Super+Alt+A)
• Wallpapers — wallpaper change with preview (Super+Alt+W)
• Emoji picker — emoji selection (Super+Alt+.)
• Clipboard — clipboard history (Super+Alt+V)
• Network manager — Wi-Fi and Ethernet (Super+Alt+N)
• Workspaces — windows and workspaces manager (Super+Alt+Tab)
• Bluetooth — device management (Super+Alt+B)

[!NOTE] Yes-yes. All this is in one utility.
Instead of configuring Rofi + Waybar + Dunst + wlogout + network-manager-applet + clipboard manager — one installation command.

<div align="center">

📖 Full Mewline documentation - 🐛 Report an issue

</div>

---

<a name="installation"></a>🛠️ Installation

[!WARNING] The installer is designed for clean Arch Linux.
If you already have a configured system, installation will overwrite configurations.
For testing, create a new user.
If you like it — switch to Meowrch completely

📦 Quick Start

# 1. Clone the repository
git clone https://github.com/meowrch/meowrch --depth 1 --single-branch
cd meowrch

# 2. Run the installer
sh install.sh

# 3. Reboot
reboot

<a name="alternative-installations"></a>🌐 Community Alternative Installations

In addition to the standard Arch Linux installation, the Meowrch community maintains the following ports:

| Platform | Description | Repository | |:---|:---|:---| | <img src="https://cdn.simpleicons.org/nixos/5277C3" width="16"> NixOS | Full Meowrch port to NixOS using home-manager and flakes | NixOS-Meowrch | | <img src="https://cdn.simpleicons.org/apple/FFFFFF" width="16"> MacBook (Apple Silicon) | Meowrch on Arch-based system for MacBook M1 (via Asahi Linux) | meowrch-asahi | | <img src="https://cdn.simpleicons.org/apple/FFFFFF" width="16"><img src="https://cdn.simpleicons.org/nixos/5277C3" width="16"> MacBook + NixOS | Meowrch on NixOS for MacBook M1 (via Asahi Linux) | NixOS-Asahi-Kennel |

[!WARNING] These are unofficial community ports.
These repositories are maintained by community enthusiasts and are not part of the official Meowrch codebase.
We do not take responsibility for their functionality, but we welcome community contributions to the ecosystem!

---

📋 What do you get after installation?

<table align="center"> <tr> <th width="30%">Component</th> <th width="70%">Details</th> </tr> <tr> <td><b>🐧 Base OS</b></td> <td><a href="https://archlinux.org/">Arch Linux</a> + <a href="https://meowrch.github.io/en/optimization/performance-advantages/">aggressive optimization</a> </tr> <tr> <td><b>🪟 Window Managers</b></td> <td><a href="https://github.com/baskerville/bspwm">BSPWM</a> (X11) | <a href="https://hyprland.org/">Hyprland</a> (Wayland)</td> </tr> <tr> <td><b>📊 Panels</b></td> <td><a href="https://github.com/polybar/polybar">Polybar</a> | <a href="https://github.com/Alexays/Waybar">Waybar</a> | <a href="https://github.com/meowrch/mewline">Mewline</a></td> </tr> <tr> <td><b>🎨 Customization</b></td> <td><a href="https://github.com/meowrch/pawlette">Pawlette</a> with preinstalled Catppuccin Mocha theme</td> </tr> <tr> <td><b>🖥️ Terminal</b></td> <td><a href="https://github.com/kovidgoyal/kitty">Kitty</a></td> </tr> <tr> <td><b>🐚 Shells</b></td> <td><a href="https://github.com/fish-shell/fish-shell">Fish</a> | <a href="https://www.zsh.org">Zsh</a></td> </tr> <tr> <td><b>📱 Menus and Widgets</b></td> <td><a href="https://github.com/davatorium/rofi">Rofi</a> | <a href="https://github.com/meowrch/mewline">Mewline</a></td> </tr> <tr> <td><b>🔔 Notifications</b></td> <td><a href="https://github.com/dunst-project/dunst">Dunst</a> | <a href="https://github.com/ErikReider/SwayNotificationCenter">Swaync</a> | <a href="https://github.com/meowrch/mewline">Mewline</a></td> </tr> <tr> <td><b>📦 Repositories</b></td> <td><a href="https://wiki.archlinux.org/title/Official_repositories">Arch Official</a> + <a href="https://aur.chaotic.cx/">Chaotic AUR</a></td> </tr> </table>

[!NOTE] Why these components? We chose between performance, functionality, and stability. More about component selection

---

⌨️ Hotkeys

| Action | Combination | Why is it convenient?