• Modular Setup — Unintrusive setup
• Material You Integration — Dynamic colors via Matugen
• Lua-Based Config — Hyprland v0.55+ compatible
• System Dashboard — Monitor CPU, RAM, battery, temps, and more
• Kanban/Tasks — To Do, Ongoing and Competed lists with Prioiry and Deadlines
• App Launcher — Dropdown App Launcher
• Keybinds — Set your own keybinds for each popup
• Theming Engine — Live wallpaper-synced color updates
• Network Manager — WiFi, Bluetooth, VPN integration
• Notifications — DBus Notifcations via libnotify
• Audio Control — PipeWire volume & device management
• Screen Recorder — Built-in recording with wf-recorder
• Clipboard Manager — Cliphist integration for history management
• Highly Customizable — QML-based UI, easily extended

Note: Brain Shell is currently in its v0.1.0 release. While the core architecture and theming pipeline are feature-complete, you may encounter bugs. Please report them on our Discord or via GitHub Issues!

curl -fsSL https://raw.githubusercontent.com/Brainitech/Brain_Shell/refs/heads/main/install.sh | bash

git clone https://github.com/Brainitech/Brain_Shell.git
cd Brain_Shell
chmod +x install.sh
./install.sh

The installer automatically:

• ✓ Detects your Linux distribution
• ✓ Detects your Window Manager and Hyprland Config
• ✓ Backs up your entire ~/.config
• ✓ Installs all required dependencies
• ✓ Clones the repository to ~/.local/src/Brain_Shell
• ✓ Updates your Hyprland config to auto-start Brain_Shell and required dependencies
• ✓ Creates configuration directories

After installation, restart Hyprland for changes to take effect.

• Core shell framework
• System monitoring dashboard
• Keybind editor with live conflict detection
• Network management (WiFi, Bluetooth, VPN)
• Audio control panel
• Screen recording integration
• Clipboard manager
• Material You color integration
• Lua config generation
• Professional installer (Arch/NixOS)
• Auto-update mechanism

• Scaling on Different Screen-Sizes
• Config Pages for Shell Customization
• Multi-Monitor Support
• Additional theme options
• App launcher enhancements (pinned/recent)
• Unified popup configuration layer
• Extended documentation
• Community themes
• CLI
• More Linux distribution support

• Multi-Monitor Scaling: Global scaling across mixed-resolution monitors (e.g., 4K paired with 1080p) is currently inconsistent. UI elements may appear misproportioned or poorly sized on non-1080p screens.

• Top Bar Clipping: Elements within the right notch may become visually clipped if the system tray is expanded and contains an excessive number of active items.

• Shutdown Menu (Hyprshutdown) State: Canceling a shutdown or logout action can sometimes leave the Hyprland session in an empty state with most applications unintentionally closed. It may also occasionally struggle to terminate all running apps smoothly.

Brain Shell is actively developed and welcomes contributions!

• Found a bug? → Open an issue
• Have an idea? → Start a discussion
• Want to contribute? → Fork, branch, and submit a pull request
• Want to join the community? → Join Discord

• Hyprland Community – For creating an exceptional Wayland compositor and fostering an amazing community
• Quickshell Contributors – For the powerful QML framework that powers this shell
• Matugen Team – For Material You color generation technology
• Wayland Project – For the modern display protocol foundation
• Celestial Shell & AX-Shell — For the inspiration
• NotCandy001 — For the installer
• All the Testers & Contributors — For their time put into testing and suggesting fixes.

This project is licensed under the MIT License – see the LICENSE file for details.