Skip to content

Install_&_Update

JaKooLit edited this page Sep 21, 2024 · 13 revisions

Tip

🌐 Released version of this Hyprland-Dots are being pulled by these Hyprland-Install Scripts

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

πŸ” 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 releases. This releases are NOT in any of the branches of the KooL's Hyprland Dots.

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

πŸ”” Automatic copy of dotfiles / configurations

Tip

πŸ”£ Hyprland-Dots Related Below are for copying, and upgrading of KooL's dotfiles / configurations

clone this repo by using git. Change directory, make executable and run the script

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

chmod +x copy.sh
./copy.sh

to copy from releases (stable)

chmod +x release.sh
./release.sh

to have a guided upgrade (experimental)

chmod +x upgrade.sh
./upgrade.sh

Note

The upgrade function script has exclusion folders

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

πŸ—’οΈ Manual copy (not recommended for newbies) as I may have missed something

  • 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/*
  • Make sure to execute initial symlinks else dunst, rofi and waybar 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

πŸ’” Updating dots

Note

Be sure to check the created the backup folders in ~/Pictures and ~/.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

  • 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/ . Previous ~/Pictures/wallpapers are also being backed up with file wallpapers-backup

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