Installation 
     
 Wiki 
     
 Youtube 
     
 Discord 
     
 Legacy Jak Videos 
   

KooL's Hyprland Dotfiles Showcase

---

🏁 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/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

• OpenSUSE(Tumbleweed)

• Fedora-Linux (43/44//Rawhide)

• Debian-Linux (Trixie,Testing,SID)

• NixOS (25.05+)

• Ubuntu 24.04 LTS

• Ubuntu 26.04 LTS

• No longer supported

  • Ubuntu 24.10 (deprecated)
  • Ubuntu 25.04 (deprecated)
  • Ubuntu 25.10 (deprecated )

---

🪧 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

📦 What's new?

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

💥 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

To download from main branch

• 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/LinuxBeginnings/Hyprland-Dots.git && cd Hyprland-Dots

To download from Development branch Not recommended for non-testing systems

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)

chmod +x copy.sh
./copy.sh

⚠️ BACKUPS CREATED by SCRIPT

Caution

copy.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

⚠️ after installing these dots

• NVIDIA Owners.
  • After installation, check THIS
  • Make sure to edit your ~/.config/hypr/UserConfigs/ENVariables.conf (highly recommended).
• If you have already set your own keybinds, monitors, etc.... Just copy over from backup created before log-out or reboot. (recommended)

🙋 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 (only available on some layouts). Also can be launched by keybind SUPER + H
• More question? click here browse through this WIKI

⌨ Keybinds

• Keybinds HERE

✍️ Contributing

• 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!
• Click HERE for a guide how to contribute

Thanks to all who have contributed code, or support on the Discord server. Your efforts are greatly appreciated

🔮 Discord Server

• Want to contribute? Click HERE for a guide how to contribute

  Thanks to all who have contributed code, or support on the Discord server. You efforts are greatly appreciated

• kindly join my Discord

💖 Support

• a Star on my Github repos would be nice 🌟
• Subscribe to my Youtube Channel YouTube

🫰 Thank you for the stars 🩷

Document translations

• Spanish: Código de Conducta · Guía de mensajes de commit · Guía de contribución

• French: Code de Conduite · Directives pour les messages de commit · Guide de contribution