• Ubuntu-Hyprland LINK

• YOUTUBE-LINK
• YOUTUBE-Hyprland-Playlist

• Do not run this installer as sudo or as root
• This Installer requires a user with a priviledge to install packages
• Needs a Debian 13 Testing (Trixie) Branch as it needs a newer wayland packages! I have tried on Stable Debian 12 Bookworm in which, Hyprland wont build.
• edit your /etc/apt/sources.list and remove # on lines with deb-src to enable source packaging else will not install properly especially Hyprland

sudo nano /etc/apt/sources.list

• delete # on the lines with 'deb-src'
• ensure to allow to install non-free drivers especially for users with NVIDIA gpus. You can also install non-free drivers if required. Edit install-scripts/nvidia.sh and change the nvidia stuff's if required

• This Repo does not contain Hyprland Dots or configs! Pre-configured Dotfiles are on Hyprland-Dots . During installation, if you opt to copy pre-configured dots, it will be downloaded from that centralized repo.

• Hyprland-Dots use are constantly evolving / improving. you can check CHANGELOGS here Hyprland-Dots-Changelogs

• Since the Hyprland-Dots are evolving, some of the screenshots maybe old

• the wallpaper offered to be downloaded towards the end is from this WALLPAPER-REPO

• This script is meant to install in Debian Testing (Trixie) and Debian Unstable (SID). This script Will NOT work with Bookworm
• If However, decided to try, recommend to install SDDM. Apart from GDM and SDDM, any other Login Manager may not work nor launch Hyprland. However, hyprland can be launched through tty by type Hyprland
• 🕯️ network-manager-gnome (nm-applet) has been removed from the packages to install. This is because it is known to restart the networkmanager causing issues in the installation process. After you boot up, inorder to get the network-manager applet, install network-manager-gnome. sudo apt install network-manager-gnome See below if your network or wifi became unmanaged after installation
• If you have nvidia, and wanted to use proprietary drivers, uninstall nouveau first (if installed). This script will be installing proprietary nvidia drivers and will not deal with removal of nouveau.
• NVIDIA users / owners, after installation, check THIS

• inside the install-scripts directory, you can edit 01-hypr-pkgs.sh. Do not edit 00-dependencies.sh unless you know what you are doing. Care though as the Hyprland Dots may not work properly!

• if you really want to change login manager, there are couple of things you need to carry out before running this install script
• first install sddm. the no-install-recommends is suggested else it will pull lots of plasma depencies.

sudo apt install --no-install-recommends -y sddm

• then ran sudo dpkg-reconfigure sddm choose sddm and then reboot.
• once reboot done, you can ran the script and choose sddm & sddm theme
• LINK for some guide

• If you opted to install SDDM theme, here's the LINK which is a fork of LINK
• If you opted to install GTK Themes, Icons, here's the LINK. This also includes Bibata Modern Ice cursor.

• by default it is installing the latest and newest nvidia drivers. If you have an older nvidia-gpu (GTX 800 series and older), check out nvidia-debian website LINK and edit nvidia.sh in install-scripts directory to install proper gpu driver

• you can use this command to automatically clone the installer and ran the script for you
• NOTE: curl package is required before running this command

sh <(curl -L https://raw.githubusercontent.com/JaKooLit/Debian-Hyprland/main/auto-install.sh)

• if you are using say fish or a non-POSIX compliant

curl -sL https://raw.githubusercontent.com/JaKooLit/Debian-Hyprland/main/auto-install.sh | bash

clone this repo (latest commit only) by using git. Change directory, make executable and run the script

git clone --depth=1 https://github.com/JaKooLit/Debian-Hyprland.git ~/Debian-Hyprland
cd ~/Debian-Hyprland
chmod +x install.sh
./install.sh

• 11 March 2025, due to popular request, created a guided uninstall.sh script. USE this with caution as it may render your system unstable.
• I will not be responsible if your system breaks
• The best still to revert to previous state of your system is via timeshift of snapper

installer should auto change your default shell to zsh. However, if it does not, do this

chsh -s $(which zsh)
zsh
source ~/.zshrc

• reboot or logout
• by default xiong-chiamiov-plus theme is installed. You can find more themes from this OH-MY-ZSH-THEMES
• to change the theme, edit ~/.zshrc ZSH_THEME="desired theme"

• SUPER H for HINT or click on the waybar HINT! Button

• Head over to FAQ and TIPS

• if you installed in your laptop and Brightness and Keyboard brightness does not work you can execute this command sudo chmod +s $(which brightnessctl)

• Asus ROG asusctl LINK and superfxctl LINK
• swww LINK
• hyprlock LINK #22 Aug 2024 - still not on repo
• hypridle LINK #22 Aug 2024 - still not on repo
• rofi-wayland LINK
• wallust LINK

• Well, most of the core packages are downloaded and Build and compiled from SOURCE. Unlike Other distros, they already have prepacked binary that can just download and install.

• Some parts of KooL's Hyprland Dots LINK 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 different branch of KooL Dots.

• To update your KooL's Dots follow this WIKI

• in case you wonder, here is a short demo of AGS overview Youtube LINK

• SUPER H for HINT or click on the waybar HINT! Button
• Head over to KooL Hyprland WIKI

• Head over to wiki Link WIKI

• Keybinds CLICK

• for the install part, kindly open issue on this repo
• for the Pre-configured Hyprland dots / configuration, submit issue here

• CD into Debian-Hyprland DIrectory and then ran the below command.
• i.e. ./install-scripts/gtk-themes.sh - to reinstall GTK Themes or
• ./install-scripts/sddm.sh - to reinstall sddm

• in case you wonder, here is a short demo of AGS overview Youtube LINK

• possibly adding gruvbox themes, cursors, icons

• hypridle wont build (Feb 2025)

• reports from members of my discord, states that some users of nvidia are getting stuck on sddm login. credit to @Kenni Fix stated was

 while in sddm press ctrl+alt+F2 or F3
log into your account
`lspci -nn`, find the id of your nvidia card
`ls /dev/dri/by-path` find the matching id
`ls -l /dev/dri/by-path` to check where the symlink points to 
)

• add "env = WLR_DRM_DEVICES,/dev/dri/cardX" to the ENVvariables config ~/.config/hypr/UserConfigs/ENVariables.conf ; X being where the symlink of the gpu points to

• more info from the hyprland wiki Hyprland Wiki Link

• reports from a member of discord for Nvidia for additional env's

• remove # from the following env's on

env = GBM_BACKEND,nvidia-drm
env = WLR_RENDERER_ALLOW_SOFTWARE,1

• SEE HERE

• This was disabled a few days ago. (19 May 2024). This was because some users, after they used the Distro-Hyprland scripts with other DE (gnome-wayland or plasma-wayland), if they choose to login into gnome-wayland for example, Hyprland is starting.
• to avoid this, I disabled it. You can re-enable again by editing ~/.zprofile . Remove all the # on the first lines
• ROFI issues (scaling, unexplained scaling etc). This is most likely to experience if you are installing on a system where rofi is currently installed. To fix it uninstall rofi and install rofi-wayland . sudo apt autoremove rofi .
• Install rofi-wayland with

cd ~/Debian-Hyprland
./install-scripts/rofi-wayland.sh

• Rofi-wayland is compatible with x11 so no need to worry.

• Does not work in Debian Bookworm

• sddm blackscreen when log-out

• Installing SDDM if or any other Login Manager installed. See Issue 2 - SDDM

• network is down or become unmanaged This might help

• join my discord channel Discord
• Feel free to copy, re-distribute, and use this script however you want. Would appreciate if you give me some loves by crediting my work :)

• As stated above, these script does not contain actual config files. These are only the installer of packages
• The development branch of this script is pulling the latest "stable" releases of the Hyprland-Dotfiles.
• If you want to contribute and/or test the Hyprland-Dotfiles (development branch), Hyprland-Dots-Development

• Hyprland Of course to Hyprland and @vaxerski for this awesome Dynamic Tiling Manager.

• a Star on my Github repos would be nice 🌟

• Subscribe to my Youtube Channel YouTube

• you can also give support through coffee's or btc 😊

or

Or you can donate cryto on my btc wallet :)

1N3MeV2dsX6gQB42HXU6MF2hAix1mqjo8i