dots-hyprland is a collection of dotfiles that provides a custom graphical shell for the Hyprland compositor on Linux.
The project addresses the challenge of creating a usable, visually cohesive desktop environment on Wayland by bundling configuration files with a custom shell built on Quickshell, a QtQuick-based widget system. Rather than a system setup script, it focuses on the graphical layer, providing an overview feature with live app previews, integration with AI services like Gemini and Ollama, quality-of-life features such as screen translation and anti-flashbang functionality, and automatic Material Design theming based on wallpaper selection. The installation process emphasizes transparency, showing every command before execution.
This project suits users who want a polished, modern desktop experience on Hyprland without building from scratch, particularly those familiar with Windows or GNOME keybinds. It is not appropriate for users seeking a comprehensive system setup tool that handles graphics drivers or kernel-level optimizations. The dotfiles are configuration-focused rather than prescriptive about underlying system setup.
The project maintains active engagement through a Discord community server for user support, with GitHub preferred for technical issues. Development tracks compatibility with Hyprland releases, including documented migration paths for major version updates like the Hyprland 0.55 Luaification change, indicating responsiveness to upstream changes in the compositor.
