[![jp](https://img.shields.io/badge/lang-jp-blue.svg)](https://github.com/JaKooLit/Hyprland-Dots/blob/main/i18n/README.jp.md) [![ro](https://img.shields.io/badge/lang-ro-green.svg)](https://github.com/JaKooLit/Hyprland-Dots/blob/main/i18n/README.ro.md) [![ru](https://img.shields.io/badge/lang-ru-red.svg)](https://github.com/JaKooLit/Hyprland-Dots/blob/main/i18n/README.ru.md) [![ua](https://img.shields.io/badge/lang-ua-white.svg)](https://github.com/JaKooLit/Hyprland-Dots/blob/main/i18n/README.ua.md) [![de](https://img.shields.io/badge/lang-de-magenta.svg)](https://github.com/JaKooLit/Hyprland-Dots/blob/main/i18n/README.de.md) ## IMPORTANT! Beginning of March 2026, This project will be archived and it will be maintained by Dwilliams - https://github.com/LinuxBeginnings - https://github.com/LinuxBeginnings/Hyprland-Dots

Installation Youtube Wiki Discussions Keybinds Discord

![GitHub Repo stars](https://img.shields.io/github/stars/JaKooLit/Hyprland-Dots?style=for-the-badge&color=cba6f7) ![GitHub last commit](https://img.shields.io/github/last-commit/JaKooLit/Hyprland-Dots?style=for-the-badge&color=b4befe) ![GitHub repo size](https://img.shields.io/github/repo-size/JaKooLit/Hyprland-Dots?style=for-the-badge&color=cba6f7)

KooL's Hyprland Dotfiles Showcase

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

### 📹 A video walkthroughs - at the bottom --- [![Typing SVG](https://readme-typing-svg.herokuapp.com?font=Fira+Code&weight=700&size=22&pause=1000&color=F7077E&vCenter=true&width=435&height=30&lines=INSTALLATION)](https://git.io/typing-svg) ### 🚩 🏁 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 ```bash 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](https://github.com/JaKooLit/Arch-Hyprland) - [OpenSUSE(Tumbleweed)](https://github.com/JaKooLit/OpenSuse-Hyprland) - [Fedora-Linux (43/Rawhide)](https://github.com/JaKooLit/Fedora-Hyprland) - [Debian-Linux (Trixie & SID)](https://github.com/JaKooLit/Debian-Hyprland) - [NixOS (25.05+)](https://github.com/JaKooLit/NixOS-Hyprland) - [Ubuntu 24.04 LTS](https://github.com/JaKooLit/Ubuntu-Hyprland/tree/24.04) - [Ubuntu 24.10 (depreciated)](https://github.com/JaKooLit/Ubuntu-Hyprland/tree/24.10) - [Ubuntu 25.04 (depreciated)](https://github.com/JaKooLit/Ubuntu-Hyprland/tree/25.04) - [Ubuntu 25.10](https://github.com/JaKooLit/Ubuntu-Hyprland/tree/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](https://github.com/JaKooLit/screenshots/tree/main/Hyprland-ScreenShots) ### 📦 Whats new? - To easily track changes, I will be updating the [CHANGELOGS](https://github.com/JaKooLit/Hyprland-Dots/wiki/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`](https://github.com/JaKooLit/Hyprland-Dots/wiki/Install_&_Update) > [!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 ```bash 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 ```bash 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) ```bash chmod +x copy.sh ./copy.sh ``` - to copy/install from releases (stable) (note this is 1 version older than in main) ```bash 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 ```bash 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`](https://github.com/JaKooLit/Wallpaper-Bank/tree/main/wallpapers) 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`](https://github.com/JaKooLit/Hyprland-Dots/wiki/Notes_to_remember#--for-nvidia-gpu-users) - 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](https://github.com/JaKooLit/Hyprland-Dots/wiki/FAQ) and [UNSOLVED ISSUES](https://github.com/JaKooLit/Hyprland-Dots/wiki/Known_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](https://github.com/JaKooLit/Hyprland-Dots/wiki/) - If you want the old configs, it is collected on my "Archive" repo. See [HERE](https://github.com/JaKooLit/Hyprland-Dots-releases-Archive) #### ⌨ Keybinds - Keybinds [`CLICK`](https://github.com/JaKooLit/Hyprland-Dots/wiki/Keybinds) #### 🙏 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! #### ✍️ Contributing - Want to contribute? Click [`HERE`](https://github.com/JaKooLit/Hyprland-Dots/blob/main/CONTRIBUTING.md) for a guide how to contribute > Thanks to all who have contributed code, or support on the Discord server. You efforts are greatly appreciated #### 🤷‍♂️ TO DO! - [ ] Tweak dots - 🚧 in constant progress #### 🔮 Discord Server - kindly join my [Discord](https://discord.com/invite/kool-tech-world) #### 💖 Support - a Star on my Github repos would be nice 🌟 - Subscribe to my Youtube Channel [YouTube](https://www.youtube.com/@Ja.KooLit) - you can also give support through coffee's or btc 😊 [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/jakoolit) or [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/JaKooLit) Or you can donate cryto on my btc wallet :) > 1N3MeV2dsX6gQB42HXU6MF2hAix1mqjo8i ![Bitcoin](https://github.com/user-attachments/assets/7ed32f8f-c499-46f0-a53c-3f6fbd343699) ## 🫰 Thank you for the stars 🩷 [![Stargazers over time](https://starchart.cc/JaKooLit/Hyprland-Dots.svg?variant=adaptive)](https://starchart.cc/JaKooLit/Hyprland-Dots) ### Document translations - Spanish: [Código de Conducta](./CODE_OF_CONDUCT.es.md) · [Guía de mensajes de commit](./COMMIT_MESSAGE_GUIDELINES.es.md) · [Guía de contribución](./CONTRIBUTING.es.md)