README.md

February 22, 2026 · View on GitHub

IMPORTANT! Beginning of March 2026, This project will be archived and it will be maintained by Dwilliams

Installation Youtube Wiki Discussions Keybinds Discord

KooL's Hyprland Dotfiles Showcase

https://github.com/user-attachments/assets/49bc12b2-abaf-45de-a21c-67aacd9bb872

📹 A video walkthroughs

at the bottom

🚩 🏁 Auto Distro-Hyprland install scripts cloning and starting 🇵🇭

Caution

If you are using FISH SHELL, DO NOT use this function. Clone the Distro-Hyprland and ran install.sh instead

NOTE: you need package curl for this to work

sh <(curl -L https://raw.githubusercontent.com/JaKooLit/Hyprland-Dots/main/Distro-Hyprland.sh)

You can use the above command to automatically clone the Distro-Hyprland install scripts
It will clone the install script and start the install.sh 😎

👁️‍🗨️ My Hyprland install Scripts 👁️‍🗨️

Automated Hyprland Scripts for Distro of choice which will pull this dotfiles if opted to install these configurations
Arch-Linux
OpenSUSE(Tumbleweed)
Fedora-Linux (43/Rawhide)
Debian-Linux (Trixie & SID)
NixOS (25.05+)
Ubuntu 24.04 LTS
Ubuntu 24.10 (depreciated)
Ubuntu 25.04 (depreciated)
Ubuntu 25.10

🪧 Attention 🪧

This repo does NOT contain or will NOT install any packages. These are only pre-configured-hyprland configs or dotfiles
refer to install scripts what packages needed to install... but at least, Hyprland packages are required
This repo will be pulled by the Distro-Hyprland install scripts above if you opt to download pre-configured dots

👀 Screenshots 👀

All screenshots are collected here Screenshots

📦 Whats new?

To easily track changes, I will be updating the CHANGELOGS Screenshots will be included if worth mentioning the changes!

Note

Kindly note that by default, Kools Dots are adjusted / configured for 2k (1440p) display without scaling.

💥 Copying / Installation / Update instructions 💥

MORE INFO HERE

Note

The auto copy script copy.sh will create backups of intended directories to be copied. However, it's still a good idea to manually backup just incase script fails to backup your configuration. If you already have a hyprland configuration, uninstall it first, or create a new user, and install it with that user
Clone this repo by using git.
Change directory, i.e. cd Arch-Hyprland
Make install.sh executable chmod +x ./install.sh
Run the script ./install.sh

To download from Master branch Note: Ubuntu is exception, it has version specific branches

git clone --depth=1 https://github.com/JaKooLit/Hyprland-Dots.git
cd Hyprland-Dots

to download from Development branch (development and testing) Not recommeded for non-testing systems

git clone --depth=1 https://github.com/JaKooLit/Hyprland-Dots.git -b development
cd Hyprland-Dots

automatic copy/install of pre-configured dots (recommended for updating)

chmod +x copy.sh
./copy.sh

to copy/install from releases (stable) (note this is 1 version older than in main)

chmod +x release.sh
./release.sh

UPGRADE.sh function
Important

You need rsync for it to work you should have already up and running KooL's Hyprland before using this function

chmod +x upgrade.sh
./upgrade.sh

❗❗❗ DEBIAN AND UBUNTU!

Debian 13
- Now builds Hyprland 0.51.1 from source using the install.sh script
- So the current version of Hyprland-Dots is compatible only in those cases.
Ubuntu 24.04/25.10
- We are now using a PPA to get more current versions of Hyprland.
- So the current version of these Dotfiles are compatible if you updated to the PPA based configuration.

⚠️⚠️⚠️ ATTENTION - BACKUPS CREATED by SCRIPT

Caution

copy.sh, release.sh and even upgrade.sh creates a backup! Kindly investigate manually contents on your $HOME/.config Delete manually any backups which you dont want.

🛎️ a small note on wallpapers

by default, only few wallpapers will be copied (1 each dark and light plus 3 more). You will be offered to download more wallpapers. You can preview/check the additional wallpapers from THIS Link

⚠️⚠️⚠️ A MUST! after copying / Installing these dots

Press SUPER W and set a wallpaper. This is also to initiate wallust for waybar, kitty (tty) and rofi themes.
However, If you use the copy.sh or the release.sh, there will be a preset initial Wallpaper and you dont have to do this
Nvidia Owners. Make sure to edit your ~/.config/hypr/UserConfigs/ENVariables.conf (highly recommended).

NVIDIA users / owners, after installation, check THIS

If you have already set your own keybinds, monitors, etc.... Just copy over from backup created before log-out or reboot. (recommended)

📖 Known issues and possible solutions

check out this page FAQ and UNSOLVED ISSUES

🙋 QUESTIONS ?!?! ⁉️

FAQ! Yes you can use these dotfiles to other distro! Just ensure to install proper packages first! If it makes you feel better, I use same config on my Gentoo:)
QUICK HINT! Click the HINT! Waybar module (note only available in Waybar default and Simple-L [TOP] layout). Can be launched by Keybind SUPER H
More question? click here browse through this WIKI
If you want the old configs, it is collected on my "Archive" repo. See HERE

⌨ Keybinds

Keybinds CLICK

🙏 Special request

If you have improvements on the dotfiles or configuration, feel free to submit a PR for improvement.
I always welcome improvements as I am also just learning just like you guys!