Repository navigation
π ASURA v1.0.0 β Official First Release
We are proud to present the first official release of ASURA Linux (v1.0.0).
ASURA is a comprehensive, modern, and highly modular Wayland desktop environment and shell tailored for Hyprland, built using Quickshell (Qt6/QML), Python, and Lua. Designed from the ground up to unite aesthetic elegance with deep technical flexibility, ASURA delivers a cohesive, dynamic, and productive desktop experience out of the box.
π Key Features & Capabilities
ποΈ Unified Settings & Hyprland Integration
- Centralized Desktop Configuration: Manage your desktop environment from a dedicated, native graphical settings center without manually modifying configuration files.
- Hyprland Controls: Fine-tune monitor layouts, display scaling, refresh rates, window behaviors, gaps, borders, keyboard layouts, and trackpad/mouse inputs directly from the interface.
π Modular Bar: 3 Modes & 4 Orientations
- Layout Adaptability: Place the status bar on any edge of your screen (Top, Bottom, Left, or Right).
- 3 Distinct Bar Styles: Choose among different visual representations and density profiles suited for compact setups, ultra-wide screens, or multi-monitor configurations.
- Integrated Hardware & Status Modules: Workspaces, system tray, battery statistics, network metrics, volume, brightness, and real-time hardware resource monitoring.
π¨ Preset System & Rice Sharing
- Snapshot Custom Configurations: Save your entire visual layout, bar mode, colors, and system preferences into standalone presets.
- Portability: Export and import presets effortlessly, allowing users to share, replicate, or archive distinct desktop configurations (rices).
- Dynamic Material You Theming: Automatic color extraction from your active wallpaper that synchronizes Material Design 3 palettes across shell components, Hyprland window borders, and GTK themes.
π Advanced Multi-Mode Application Launcher
- 3 Launcher Layouts: Tailor your launch experience according to your preference (grid, list, or minimal).
- Integrated Capabilities:
- Launch installed desktop applications with instant search.
- Execute terminal commands directly.
- Perform live mathematical calculations.
- Trigger web searches.
- Execute internal Asura desktop actions and toggles.
π Visual Window Switcher (Alt + Tab)
- Smooth, responsive visual window switcher featuring real-time application titles, window icons, and rapid navigation across open applications.
π Clipboard Manager (Super + V)
- Native clipboard history panel powered by
cliphist. - Instant search and paste capabilities for text and image buffers.
β±οΈ Integrated Productivity Suite
- Pomodoro Timer: Embedded Pomodoro workflow integrated into both the status bar and flyout menus to keep focus during work sessions.
- Timer, Stopwatch & Alarms: Complete time management toolkit accessible with one click from the bar.
- Task Management System: Built-in to-do and task tracking system that synchronizes directly with a local Markdown file or can be updated interactively from the graphical interface.
πΌοΈ Interactive Wallpaper Selector
- Visual wallpaper gallery with live background transitions (
awww/swww) and instant dynamic color palette regeneration.
β‘ Performance & Focus Modes
- Game Mode (
Super + G): Instantly disables blur, rounding, and animations to minimize latency and maximize gaming performance. - Caffeine Mode (
Super + Alt + C): Inhibits screen blanking and idle suspension for presentations or long tasks.
π οΈ Dedicated CLI Suite (asura)
- CLI command available system-wide for lifecycle operations:
asura run/kill/reload: Manage the shell process.asura doctor: Comprehensive environment diagnostics and dependency checks.asura update: Update system components directly from the repository.- Individual module IPC triggers (
launcher,controlpanel,player,wallpaper,clipboard,settings,lock).
π¦ Installation
ASURA provides an automated installer that handles system updates, dependencies, repository configurations, fonts, cursor themes, and system daemons.
Automated Setup
git clone https://github.com/rlucas25/ASURA-linux.git
cd ASURA-linux
chmod +x install.py
./install.pyNote: Run the installer as a standard user. Elevated privileges (
sudo) will be requested strictly for package management and service registration.
Installer Options
| Flag | Purpose |
|---|---|
--skip-deps |
Skip system package installation and system update |
--skip-themes |
Skip cursor and icon theme installation |
--skip-fonts |
Skip font installation |
-v, --version |
Display installer version |
-h, --help |
Show command line options |
π§ Distribution Support
| Distribution | Compatibility | Package Backend | Power Management |
|---|---|---|---|
| Arch Linux / CachyOS | Official | pacman + AUR (yay / paru) |
power-profiles-daemon |
| Fedora Linux (41+) | Official | dnf + COPR |
tuned & tuned-ppd |
β¨οΈ Default Keybindings Reference
| Shortcut | Description |
|---|---|
| Super | Toggle Application Launcher |
| Alt + Tab | Window Switcher |
| Super + V | Clipboard History |
| Super + W | Wallpaper Selector |
| Super + G | Toggle Game Mode |
| Super + Alt + C | Toggle Caffeine Mode |
| Super + Return | Launch Terminal (kitty) |
| Super + E | File Manager (nautilus) |
| Super + L | Lock Screen |
| Super + Q | Close Active Window |
| Super + F | Toggle Fullscreen Mode |
Source Code & Repository: https://github.com/rlucas25/ASURA-linux