For Ubuntu 24.04 Noble Numbat users, click the link below. This will take you to specific branch of this repo
Show.Case.mp4
Important
install a backup tool like snapper or timeshift. and Backup your system before installing hyprland using this script. This script does NOT include uninstallation of packages
Note
Main reason why I have not included an uninstallation script is simple. Some packages maybe already installed on your system by default. If I create an uninstall script with packages that I have set to install, you may end up a unrecoverable system.
Warning
Download this script on a directory where you have write permissions. ie. HOME. Or any directory within your home directory. Else script will fail
- 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
- If you have login Manager already like GDM (gnome login manager), I highly advice not to install SDDM. But if you decide to install SDDM, see here
Issue 2 - SDDM
Important
If you are using Gnome already, DO NOT install the SDDM. The GDM Login Manager works well with Hyprland. For some reason, during installation, you will be asked which login manager you wanted to use. But during my test, nothing happened.
Warning
If you have GDM already as log-in manager, DO NOT install SDDM
You will encounter issues. See Issue 2 - SDDM
📽️ Youtube Videos
✨ Youtube presentation V1
✨ Youtube presentation V2
✨ A video walk through my dotfilesLink
✨ A video walk through of My Hyprland-Dots v2Link
- This Repo does not contain Hyprland Dots or configs! Dotfiles can be checked here
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
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-gnomeSee 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
- 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
- inside the install-scripts directory, you can edit 00-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 opted to install SDDM theme, here's the
LINK - If you opted to install GTK Themes, Icons here's the
LINK& Bibata Cursor Modern Ice (assets directory)
- 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
LINKand edit nvidia.sh in install-scripts directory to install proper gpu driver
Important
If you want to use nouveau driver, choose N when asked if you have nvidia gpu. This is because the nvidia installer part, it will blacklist nouveau. Hyprland will still be installed but it will skip blacklisting nouveau.
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
Note
UBUNTU USERS: Will only work on Ubuntu 24.04. See above! For Ubuntu 24.04 LTS, no need to edit the /etc/apt/sources.list A separate branch have been created for Ubuntu 24.04 ONLY
git clone --depth=1 -b Ubuntu-24.04-LTS https://github.com/JaKooLit/Debian-Hyprland.git ~/Ubuntu-Hyprland
cd ~/Ubuntu-Hyprland
chmod +x install.sh
./install.shinstaller 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-plustheme is installed. You can find more themes from thisOH-MY-ZSH-THEMES - to change the theme, edit ~/.zshrc ZSH_THEME="desired theme"
-
SUPER H for HINT or click on the waybar HINT! Button
-
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
LINKand superfxctlLINK - swww
LINK - hyprlock
LINK - hypridle
LINK - hyprlang
LINK - hyprcursor
LINK - swappy
LINK - xdg-desktop-portal-hyprland
LINK - rofi-wayland
LINK - wallust
LINK - waybar
LINK- as of 13 May 2024. This was because Hyprland v0.40.0 requires Waybar v0.10.3 and Trixie still has waybar v0.10.3
Tip
To update to latest packages, re-running this script will auto update all. Script is configured to pull latest packages build for you.
Most common question I got is, Hey Ja, Why the heck it is taking long time to install? Other distro like Arch its only a minute or two. Why here takes like forever?!?!?!
- Well, most of the core packages are downloaded and Build and compiled from SOURCE. There are no pre-built binary (yet) for Debian and Ubuntu. Unlike Other distros, they already have prepacked binary that can just download and install.
Note
This script does not setup audio. Kindly set up. If you have not, I recommend pipewire. sudo apt install -y pipewire
- some users reported that they have to install some packages. It is in the install-scripts/force-install.sh
- At this time the packages force to install are the following
imagemagick
- 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 Folder and then ran the below command.
- i.e.
./install-scripts/gtk-themes.sh- For reinstall GTK Themes or ./install-scripts/sddm.sh- For reinstall sddm
Important
DO NOT cd into install-scripts directory as script will most likely to fail
- possibly adding gruvbox themes, cursors, icons
- 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
Note
Auto start of Hyprland after login (no SDDM or GDM or any login managers)
- 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
Thismight help -
pyprland is a hit and miss. Drop down not working, zooming is hit and miss
- 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
HyprlandOf 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 buy me Coffee Through ko-fi.com or Coffee.com 🤩
