This repository provides a highly customizable Hyprland setup tailored for usability and aesthetic appeal, targeting Linux users seeking a modern, efficient desktop experience. It offers features like AI integration, dynamic theming, and transparent installation, aiming to simplify the setup of a feature-rich Wayland environment.

How It Works

The setup leverages Hyprland as the Wayland compositor, AGS for custom UI elements like the status bar and sidebars, and Fuzzel for application launching and search. A key innovation is the autogeneration of Material Design 3-inspired colors based on the user's wallpaper, enhancing accessibility and visual coherence. AI capabilities are integrated via Gemini and Ollama, accessible through a sidebar for chat and text summarization.

Quick Start & Requirements

• Installation: Automated, guided installation for Arch(-based) Linux via bash <(curl -s "https://end-4.github.io/dots-hyprland-wiki/setup.sh"). Manual installation instructions are available in the Wiki.
• Prerequisites: A working Arch(-based) Linux system is the primary requirement.
• Wiki: https://end-4.github.io/dots-hyprland-wiki/

Highlighted Details

• AI Sidebar for online/offline chat and text summarization.
• Autogenerated, accessible Material colors based on wallpaper.
• Transparent installation process showing each command.
• Intuitive window management with drag-and-drop across workspaces.
• Keybinds inspired by Windows and GNOME, with an in-system help overlay.

Maintenance & Community

The project encourages community contributions through discussions and issue reporting. A Quickshell-powered version is available on the ii-qs branch.

Licensing & Compatibility

The repository's license permits redistribution and recreation of the work, with no explicit restrictions mentioned beyond adhering to the license terms.

Limitations & Caveats

The README mentions an "archive branch" with "spaghetti" code for older features, suggesting potential for troubleshooting if older components are used. The project's primary focus on Arch Linux may require significant adaptation for other distributions.