Install_&_Update

Tip

🌐 KooL's Hyprland-Dots are being pulled by these Hyprland-Install Scripts below

• Fedora-Linux

• Arch-Linux

• OpenSUSE Tumbleweed

• Debian Trixie and SID Linux - pulled from different branch

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

Note

Ubuntu - Hyprland Project

• 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

❗❗❗ To update to current Hyprland Dots, it is HIGHLY recommended to re-download the above Distro-Hyprland install scripts. This is because to ensure newest packages required for the changes are installed. The script is adjusted so you will get the latest Dots ❗❗❗

Tip

If you do not want to re-download Distro-Hyprland scripts above and use your old download Distro-Hyprland install scripts, you just need to update your old scripts with

git stash && git pull

🏴‍☠️🏴‍☠️🏴‍☠️🏴‍☠️ *** DEBIAN and UBUNTU Hyprland Dots UPDATING NOTES *** 🏴‍☠️🏴‍☠️🏴‍☠️🏴‍☠️🏴‍☠️

Important

This is very Important for Debian and Ubuntu Dots

• Some parts of KooL's Dots are not compatible on Debian and Ubuntu especially the hyprland settings.

• That is the reason the DOTS for those distro's are "fixed" and they are being pulled from different branch of this repo.

• for Debian and Ubuntu if you want to update from newest KooL's dots versions (main branch), after running copy.sh, you will have 100% error which will appear on top. However, Hyprland is very good in pin pointing those errors.

• You can simply just remove those lines or add # on those lines. Then, it should be ok.

• For Ubuntu 24.04, you can update your dots from the Ubuntu-24.04-Dots branch of Hyprland-Dots

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

• For Debian and other Ubuntu, you can update your dots from the Deb-Untu-Dots branch of Hyprland-Dots

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

• But then again as I mentioned above, it is alot less hassle for you to just RE-DOWNLOAD and RE-RUN the -Hyprland scripts above as I mentioned above

🔔 Automatic copy of dotfiles / configurations

Tip

🔣 Hyprland-Dots Related Below are for copying, and upgrading of KooL's dotfiles / configurations

Important

if you already have Hyprland-Dots directory, you can just cd into it and ran git stash && git pull

• clone this repo by using git. Change directory, make executable and run the 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

Note

When running release.sh, it will be 1 version older

chmod +x release.sh
./release.sh

• to have a guided upgrade (experimental)

Note

The upgrade function script has exclusion folders

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

chmod +x upgrade.sh
./upgrade.sh

Note

In order for the script to correctly restore your waybar, before running copy.sh, you need to select first your waybar styles and configs. In that way, the symlinks will be updated.

🗒️ Manual copy (not recommended for newbies) as I may have missed something

• Make sure you have the necessary packages as stated HERE
• Backup your existing folders in ~/.config (advisable)
• copy all contents of configs into ~/.config, overwriting all
• copy contents of wallpapers into ~/Pictures/wallpapers/ (create wallpapers folder 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

💔 Updating dots

Note

Be sure to check the created the backup folders in ~/.config and delete as required. Hyprland-Dots v2.2 creates a backup whenever you ran either copy.sh or release.sh or even the distro-Hyprland install scripts. This is especially if you choose not to delete the backups when you are offered during running copy.sh

• 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 folders in ~/.config/ .

Tip

KooL's dots v2.3.8, it will offer to restore all the files in ~/.config/hypr/UserConfigs/ and ~/.config/hypr/UserScripts/ directory.

🎇 WARNING! on restoring the files in UserConfigs

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

Development Branch

• 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