Debian 13 Trixie and Ubuntu 23.10 Mantic Minotaur - Hyprland install script based from my Fedora-Hyprland Link and Arch-Hyprland-v4 Link

⚠️ Pre-requisites and VERY Important!

• 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

🔔 NOTICE TO UBUNTU USERS

• You can use this installer. However, I have only tested on Ubuntu 23.10. Not sure if it works on older ubuntu as Hyprland needs an updated wayland libraries. For sure wont work in any Ubuntu LTS.

• For Ubuntu with NVIDIA GPU's, make sure to edit the install-scripts/nvidia.sh . Delete all packages in nvidia_pkg except libva-wayland2 and nvidia-vaapi-driver and uncomment/remove # before sudo ubuntu-drivers install. You also need to delete or simply just add # in the lines 43 and 44 echo "## for nvidia... and echo "deb ...........

📷 Screenshots click to enlarge

📷 you can find more screenshots in the screenshots directory

✨ Youtube presentation Link - to be added soon :)

✨ Some notes on this installer

• This script is meant to install in Debian Testing (Trixie).
• 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
• It should work on latest Ubuntu 23.10

⚠️ WARNING! nwg-look takes long time to install.

• nwg-look is a utility to costumize your GTK theme. It's a LXAppearance like. Its a good tool though but this package is entirely optional

✨ Costumize the packages

• inside the install-scripts folder, you can edit 00-hypr-pkgs.sh. Do not edit 00-dependencies.sh unless you know what you are doing
• default GTK theme if agreed to be installed is Tokyo night GTK themes (dark and light) + Tokyo night SE icons

🔔 NOTICE TO NVIDIA OWNERS

• 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 folder to install proper gpu driver

✨ to run

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

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

✨ for ZSH and OH-MY-ZSH installation

do this once installed and script completed; do the following to change the default shell zsh

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

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

✨ Hyprland Dot Notes

• super h for launching a small help file

• super e to view / edit settings, monitor, keybinds, Environment Variables, etc

• go through the keybinds. There are alot of hidden features like dual panel, change waybar styles, change wallpaper, etc... its too long to put all in the readme!!!

• super d for wofi (menu)

• super t for thunar (file manager)

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

✨ Packages that are manually downloaded and build. These packages will not be updated by apt and have to be manually updated

• Hyprland LINK

• nwg-look LINK

• Asus ROG asusctl LINK and superfxctl LINK

• swww LINK

• swaylock-effects LINK

• swappy LINK

• xdg-desktop-portal-hyprland LINK

• a.) to update these package, in your installation folder, you can move these folders, Hyprland nwg-look swaylock-effects swappy swww asusctl supergfxctl, as appropriate or download manually, cd into it, update/install

• b.) to update Hyprland

git pull
sudo make clear
sudo make install

• c.) for nwg-look, asusctl, supergfxtctl, to update ran

git pull
sudo make install

• c.) for swww, to update

git pull
cargo build --release

• d.) for swaylock-effects and swappy

git pull
meson build
ninja -C build
sudo ninja -C build install

✨ Roadmap:

• Install zsh and oh-my-zsh without necessary steps above
• possibly adding gruvbox themes, cursors, icons
• adding vertical waybar
• Use kitty in favor of foot - Dropped the idea of kitty. Kitty is using twice memory compared to foot.
• Create an automated uninstaller

❗ some known issues

• 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 
)
7. add "env = WLR_DRM_DEVICES,/dev/dri/cardX" to the ENVvariables config (.config/hypr/configs/ENVariables.conf)  ; X being where the symlink of the gpu points to

• more info from the hyprland wiki Hyprland Wiki Link

• Does not work in Ubuntu 23.04

• sddm blackscreen when log-out

👍 Final Notes

• 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 :)