README.md

May 6, 2026 · View on GitHub

Caution

If you are using FISH SHELL, DO NOT use this function. Clone the Distro-Hyprland and ran install.sh instead

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

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

Automated Hyprland Scripts for Distro of choice which will pull this dotfiles if opted to install these configurations

This repo does NOT contain or will NOT install any packages. These are only pre-configured-hyprland configs or dotfiles
refer to install scripts what packages needed to install... but at least, Hyprland packages are required
This repo will be pulled by the Distro-Hyprland install scripts above if you opt to download pre-configured dots

To easily track changes, I will be updating the CHANGELOGS Screenshots will be included if worth mentioning the changes!

MORE INFO HERE
Note

The auto copy script copy.sh will create backups of intended directories to be copied. However, it's still a good idea to manually backup just incase script fails to backup your configuration. If you already have a hyprland configuration, uninstall it first, or create a new user, and install it with that user

To download from main branch

To download from Master branch Note: Ubuntu is exception, it has version specific branches

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

To download from Development branch Not recommended for non-testing systems

git clone --depth=1 https://github.com/LinuxBeginnings/Hyprland-Dots.git -b development && cd Hyprland-Dots

chmod +x copy.sh
./copy.sh

Caution

copy.sh creates a backup! Kindly investigate manually contents on your $HOME/.config Delete manually any backups which you dont want.

by default, only few wallpapers will be copied (1 each dark and light plus 3 more). You will be offered to download more wallpapers. You can preview/check the additional wallpapers from this LINK

NVIDIA Owners.
- After installation, check THIS
- Make sure to edit your ~/.config/hypr/UserConfigs/ENVariables.conf (highly recommended).
If you have already set your own keybinds, monitors, etc.... Just copy over from backup created before log-out or reboot. (recommended)

FAQ! Yes you can use these dotfiles to other distro! Just ensure to install proper packages first! If it makes you feel better, I use same config on my Gentoo:)
QUICK HINT! Click the HINT! Waybar module (only available on some layouts). Also can be launched by keybind SUPER + H
More question? click here browse through this WIKI

If you have improvements on the dotfiles or configuration, feel free to submit a PR for improvement.
I always welcome improvements as I am also just learning just like you guys!
Click HERE for a guide how to contribute

Thanks to all who have contributed code, or support on the Discord server. Your efforts are greatly appreciated

Want to contribute? Click HERE for a guide how to contribute

Thanks to all who have contributed code, or support on the Discord server. You efforts are greatly appreciated
kindly join my Discord

🫰 Thank you for the stars 🩷