[](./i18n/README/README.jp.md)
[](./i18n/README/README.ro.md)
[](./i18n/README/README.ru.md)
[](./i18n/README/README.ua.md)
[](./i18n/README/README.de.md)
[](./i18n/README/README.fr.md)
KooL's Hyprland Dotfiles Showcase
https://github.com/user-attachments/assets/49bc12b2-abaf-45de-a21c-67aacd9bb872
### 📹 A video walkthroughs
- at the bottom
---
[](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/LinuxBeginnings/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/LinuxBeginnings/Arch-Hyprland)
- [OpenSUSE(Tumbleweed)](https://github.com/LinuxBeginnings/OpenSuse-Hyprland)
- [Fedora-Linux (43/Rawhide)](https://github.com/LinuxBeginnings/Fedora-Hyprland)
- [Debian-Linux (Trixie & SID)](https://github.com/LinuxBeginnings/Debian-Hyprland)
- [NixOS (25.05+)](https://github.com/LinuxBeginnings/NixOS-Hyprland)
- [Ubuntu 24.04 LTS](https://github.com/LinuxBeginnings/Ubuntu-Hyprland/tree/24.04)
- [Ubuntu 24.10 (depreciated)](https://github.com/LinuxBeginnings/Ubuntu-Hyprland/tree/24.10)
- [Ubuntu 25.04 (depreciated)](https://github.com/LinuxBeginnings/Ubuntu-Hyprland/tree/25.04)
- [Ubuntu 25.10](https://github.com/LinuxBeginnings/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/LinuxBeginnings/screenshots/tree/main/Hyprland-ScreenShots)
### 📦 Whats new?
- To easily track changes, I will be updating the [CHANGELOGS](https://github.com/LinuxBeginnings/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/LinuxBeginnings/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/LinuxBeginnings/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/LinuxBeginnings/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/LinuxBeginnings/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/LinuxBeginnings/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/LinuxBeginnings/Hyprland-Dots/wiki/FAQ) and [UNSOLVED ISSUES](https://github.com/LinuxBeginnings/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/LinuxBeginnings/Hyprland-Dots/wiki/)
- If you want the old configs, it is collected on my "Archive" repo. See [HERE](https://github.com/LinuxBeginnings/Hyprland-Dots-releases-Archive)
#### ⌨ Keybinds
- Keybinds [`CLICK`](https://github.com/LinuxBeginnings/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/LinuxBeginnings/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 😊
or
## 🫰 Thank you for the stars 🩷
### Document translations
- Spanish: [Código de Conducta](./i18n/CODE_OF_CONDUCT/CODE_OF_CONDUCT.es.md) · [Guía de mensajes de commit](./i18n/COMMIT_MESSAGE_GUIDELINES/COMMIT_MESSAGE_GUIDELINES.es.md) · [Guía de contribución](./i18n/CONTRIBUTING/CONTRIBUTING.es.md)
- French: [Code de Conduite](./i18n/CODE_OF_CONDUCT/CODE_OF_CONDUCT.fr.md) · [Directives pour les messages de commit](./i18n/COMMIT_MESSAGE_GUIDELINES/COMMIT_MESSAGE_GUIDELINES.fr.md) · [Guide de contribution](./i18n/CONTRIBUTING/CONTRIBUTING.fr.md)