dots-hyprland

This repository contains configuration files for a custom Linux desktop environment built around a window manager called Hyprland. In Linux, a window manager controls how application windows are arranged and displayed on screen. Hyprland is a modern, visually polished option that supports smooth animations and effects. What the author has built on top of it is a complete visual shell: a status bar, sidebars, an app overview panel, and various widgets, all styled to look cohesive and polished.

The configuration draws heavily from Material Design, which is a visual design system originally created by Google. The idea is that you pick a wallpaper, and the interface automatically generates a matching color theme from it. Beyond aesthetics, the setup includes practical additions such as screen translation (pointing at text on screen and getting a translation), a Google Lens integration, an anti-flashbang feature that reduces sudden brightness changes, and a built-in AI chat panel that can connect to Gemini or locally running models.

Installing it requires running a single command in the terminal, which downloads and runs a setup script. The script shows each command before executing it so you can see exactly what it is doing. The README notes clearly that this is not a full system setup tool: it does not configure graphics drivers, disk settings, or other system-level concerns. It is purely the visual shell layer on top of an already-working Linux install.

The project has gone through several visual styles over the years, with older versions preserved in separate branches. The current version uses a widget system called Quickshell. A showcase video is linked in the README for those who want to see it in motion before trying it.

This is a personal dotfiles project that the author shares publicly, with a community Discord server for support questions.