Skip to content

Install_&_Update

brockar edited this page Mar 9, 2026 · 45 revisions

Recommended upgrade method for Hyprland-Dots

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

Auto Distro-Hyprland install scripts cloning and starting

Caution

If you are using FISH SHELL, DO NOT use this function. Clone and run install.sh instead

Note

You need the curl package

sh <(curl -L https://raw.githubusercontent.com/LinuxBeginnings/Hyprland-Dots/main/Distro-Hyprland.sh)

You can now use the above command to automatically clone the Distro-Hyprland install scripts below,
It will clone the install scripts and start the install.sh

Tip

🌐 KooL's Community Hyprland-Dots pull these Hyprland-Install Scripts below

Updating your KooL Dots using the Distro-Hyprland scripts above

After you run install.sh from the Distro-Hyprland scripts, you don't have to necessarily 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.

  • Note: copy.sh now has some options.

    • copy.sh --tty will bypass the menu and run a simple text menu
    • copy.sh --express-upgrade will reduce the number of questions asked
      • You won't be prompted to restore old configs
      • It will auto trim the older backuped up configuration directories
      • It will not ask you to download wallpapers or set the SDDM background
    • They can be used in combination. copy.sh --tty --express-upgrade
    • copy.sh --help for list of options
  • For existing users of Ubuntu, or Debian, you must re-download and re-run the <distro>-Hyprland scripts. In order to get the updated version of Hyprland and support for the current dotfiles.

Automatic copy of dotfiles / configurations

Cloning the dotfiles and using copy.sh to install the Hyprland config

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. Run the copy.sh script
git clone --depth=1 https://github.com/LinuxBeginnings/Hyprland-Dots.git
cd Hyprland-Dots
chmod +x copy.sh
./copy.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.

NixOS-Hyprland

Look HERE

Updating dots

Note

Be sure to check the created backup directories in ~/.config and delete as required. Hyprland-Dots v2.2 creates a backup whenever you run either copy.sh or 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 run 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/.

WARNING! on restoring the files in UserConfigs

If you have your own config in the UserConfigs directory, those files won't be touched by the update script — you'll need to maintain them yourself and manually apply any relevant changes from Hyprland updates.

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/LinuxBeginnings/Hyprland-Dots.git ~/Hyprland-Dots-development
cd Hyprland-Dots-development
chmod +x copy.sh
./copy.sh

The development branch is used for PRs, new features, etc, to test before pushing to main branch.

Note

The development branch changes quite often. It is NOT recommended for daily use.

Clone this wiki locally