dots-hyprland README

The project's README from github.com/end-4/dots-hyprland. As one markdown file: README.md.

【 end_4's Hyprland dotfiles 】

Dynamic JSON Badge

• overview •

[!WARNING]
Hyprland 0.55 update: If your distro has not shipped Hyprland 0.55 and/or you're not ready for it, you should switch to the Pre-Hyprland Luaification release (or not update yet, if you're going to do that). See the wiki for more info: Install | Update

What this is/isn't
  • Technically, configuration files
  • Realistically, mostly the custom graphical shell
  • NOT a system setup script: no graphic drivers, no zram setup, etc.
Notable features
  • Overview: Shows open apps with live previews
  • AI: Gemini, Ollama, and more
  • QoL: screen translation, anti-flashbang, Google Lens
  • Material themes: Choose your wallpaper, done, enjoy
  • Transparent installation: Every command is shown before it's run
Installation
  • IMPORTANT: Hyprland 0.55 Update: If your distro has not shipped Hyprland 0.55 and/or you're not ready for it, you should switch to the Pre-Hyprland Luaification release. See the wiki for more info
  • Just run bash <(curl -s https://ii.clsty.link/get)
    • Or, clone this repo and run ./setup install
    • See the wiki for more details
  • Keybinds: Should be somewhat familiar to Windows or GNOME users. Important ones:
    • Super+/ = keybind list
    • Super+Enter = terminal
Software overview
Software Purpose
Hyprland The compositor (manages and renders windows)
Quickshell A QtQuick-based widget system, used for the status bar, sidebars, etc.
Others See deps-info.md
Discord Server link | I hope this provides a friendlier environment for support without needing me to personally accept every friend request/DM. For real issues, prefer GitHub

• screenshots •

illogical-impulse logo

Widget system: Quickshell | Support: Yes

Showcase video

AI, settings app Some widgets
image image
Window management wow look its orange
image image

• thank you •

• stonks •

Stargazers over time


• previous styles •

illogical-impulse (AGS)

Widget system: AGS | Support: No

AI Common widgets
image image
Window management Weeb power
image image

m3ww

Widget system: EWW | Support: No

Material Eww!

NovelKnock

Widget system: EWW | Support: No

Desktop Preview

Hybrid

Widget system: EWW | Support: No

click the circles!

Windoes

Widget system: EWW | Support: No

Desktop Preview

• inspirations/copying •

dots-hyprland (end-4/dots-hyprland)

unixporn
Searching Database…

What is this?Dotfiles for Hyprland, a Wayland compositor on Linux — technically configuration files, but in practice a custom graphical shell: status bar, widgets, app overview, all styled after Material Design 3.
Is this a full distro, or what exactly am I installing?Not a distro and not a system setup script — it won't install graphic drivers or set up zram. You install configuration files, and with them mostly a custom graphical shell on top of Hyprland.
How do I get it running?Run the install script with bash, following the wiki. Installation is transparent: every command is displayed before it runs, so you always see what happens to your system.
What does my system need first?Linux with Hyprland (the compositor that manages and renders your windows) and Quickshell, a QtQuick-based widget system powering the status bar and sidebars. The remaining dependencies are listed in deps-info.md.
Any gotchas I should know about before installing or updating?The Hyprland 0.55 update: if your distro has not shipped it and you are not ready, switch to the Pre-Hyprland Luaification release or hold off on updating — the wiki explains how.
Can I copy the look for my own rice?Yes — copying the design is explicitly welcomed as long as you follow the license. The project is GPL-3.0.
Which widget system powers the UI, and was it always this one?The current style runs on Quickshell and is the only supported one. Older looks are unsupported: illogical-impulse ran on AGS, while m3ww, NovelKnock, Hybrid and Windoes used EWW — their sources are kept in the ii-ags and archive branches.
What inspired the different styles?The current design follows Material Design 3. Earlier ones drew from osu!lazer (the Hybrid style), Windows 11 (Windoes) and AvdanOS (NovelKnock), with m3ww and later also based on Material Design 3.
Creator
end-4
Size
25.7 MB
Stars
16.4K
Age
3y
Commits · 90 Days