Installation 
     
 Youtube 
     
 Wiki 
     
 Discussions 
     
 Keybinds 
     
 FAQ 
     
 Discord 
 

KooL's Hyprland Dotfiles Showcase

showoff-dots.mp4

📹 A video walkthroughs

• at the bottom

🎞️ AGS Overview DEMO

• in case you wonder, here is a short demo of AGS overview Youtube LINK

Installation

👁️‍🗨️ 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

• Debian-Linux (Trixie & SID)

• NixOS

• Ubuntu 24.04 LTS

• Ubuntu 24.10

• Ubuntu 25.04 - (ALPHA STAGE)

🪧 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 atleast, Hyprland packages is needed 😏😏😏 duh!!
• 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!

💥 Copying / Installation / Update instructions 💥

• MORE INFO HERE

Note

The auto copy script "copy.sh" will create backups of intended folders to be copied. However, still a good idea to manually backup just incase script failed to backup!

• clone this repo by using git. Change directory, make executable and run the script

to download from Master branch

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

to download from Development branch (development and testing)

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

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

Caution

copy.sh, release.sh and even upgrade.sh creates a backup! Kindly investigate manually contents on your ~/.config Delete manually all the backups which you dont need

🛎️ 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

‼️ ⁉️ Debian and Ubuntu Users ATTENTION!

• to update your dots, follow THIS

🙋 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!
• Waybar styles (all those new panel styles require some tweaking) - I kindly request assistance 🙏

🤷‍♂️ TO DO!

• Tweak dots - 🚧 in constant progress
• [ ] Quite possibly switch to starship? Although starship has limited themes compared to oh-my-zsh. no plans for now

🔮 Discord Server

• kindly join my Discord

💖 Support

• a Star on my Github repos would be nice 🌟

• Subscribe to my Youtube Channel YouTube

• You can also buy me Coffee Through ko-fi.com or Coffee.com 🤩

📹 Youtube videos (Click to view and watch the playlist) 📹

🫰 Thank you for the stars 🩷