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

🔁 It is highly recommend, that in order to update to newer dot files (Hyprland-Dots), re-download and re-run the -Hyprland scripts above.

• This is because to ensure that apps / packages are properly installed. You will get the latest released version of the dotfiles.

🛎 *** 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 on the release and 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

🔔 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

🗒️ 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