showoff-dots.mp4
Important
install a backup tool like snapper or timeshift. and Backup your system before installing hyprland using this script (HIGHLY RECOMMENDED)
Caution
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
sudoor asroot - This Installer requires a user with priviledge to install packages
- Choose the branch that matches your Ubuntu release (e.g.,
24.04,25.10)Note: When ubuntu v26.04 is released support for v25.10 will end
Note: There are many changes since then and we will be making new videos The basic information is still correct
- 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 - The dotfiles that will be pulled by this installer is only specific. Since newer dotfiles might not work properly
- This script targets supported Ubuntu releases; use the appropriate branch for your version.
- 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-scriptsdirectory, you can edit00-hypr-pkgs.sh. Do not edit00-dependencies.shunless 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 sddmchoose 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
LINKwhich is a modified fork ofLINK - If you opted to install GTK Themes, Icons, here's the
LINK. This also includes Bibata Modern Ice cursor.
Caution
If you are using FISH SHELL, DO NOT use this function. Clone and run install.sh instead
- you can use this command to automatically clone the installer and run the script for you
- NOTE:
curlpackage is required before running this command
sh <(curl -L https://raw.githubusercontent.com/LinuxBeginnings/Ubuntu-Hyprland/<branch>/auto-install.sh)clone this repo (latest commit only) by using git. Change directory, make executable and run the script
git clone --depth=1 -b <branch> https://github.com/LinuxBeginnings/Ubuntu-Hyprland.git ~/Ubuntu-Hyprland
cd ~/Ubuntu-Hyprland
chmod +x install.sh
./install.shBranch examples:
24.04,25.10
- 11 March 2025, due to popular request, created a guided
uninstall.shscript. 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
- If you choose to configure nvidia, driver will be installed via automatic detection / install. See NVIDIA guide
- The command will be executed will be
sudo ubuntu-drivers install - Note that
nouveauis installed, you need to uninstall it first or DO NOT choose to configurenvidia - NOTE: that script is also designed to install some other nvidia stuff including blacklist of nouvea. Verify and review
install-scripts/nvidia.shor DO not choose to configure nvidia on the option
Important
If you want to use nouveau driver, don't choose nvidia in the option. This is because the nvidia installer part, it will blacklist nouveau. Hyprland will still be installed but it will skip blacklisting nouveau.
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
agnosterzaktheme is installed. Which is from external oh-my-zsh theme. You can find more themes from thisOH-MY-ZSH-THEMES - to change the theme,
SUPER SHIFT O, choose desired theme, and close and open terminal. - or manually edit
~/.zshrc. Look for 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
Tip
To update to the 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, some packages are downloaded, built and compiled from SOURCE. 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
- In case you are wondering, here is a short demo of AGS overview Youtube LINK
Note: AGS overview for most distros has been replaced by
quickshell overviewSame keybinding and features. AGS v1 is no longer support and the AGS overview wasn't ported
- 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
Tip
KooL Hyprland has a searchable keybind function via rofi. (SUPER SHIFT K) or right click the HINTS waybar button
Important
This is very Important for Debian and Ubuntu Dots
- With support for Hyprland v0.54+ the standard dotfiles are compatible.
- for the install part, kindly open issue on this repo
- for the Pre-configured Hyprland dots / configuration, submit issue
here
- CD into Ubuntu-Hyprland directory and then ran the below command.
- i.e.
./install-scripts/gtk-themes.sh- For reinstall GTK Themes or ./install-scripts/sddm.sh- To re-install sddm[!IMPORTANT] DO NOT cd into
install-scriptsdirectory as scripts will fail!
- 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 line - 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
cd ~/Ubuntu-Hyprland
./install-scripts/rofi-wayland.sh- Rofi-wayland is compatible with x11 so no need to worry.
- After ubuntu 24.04, the package name is just
rofi24.04 currently still needsrofi-wayland
- After ubuntu 24.04, the package name is just
- Does not work in Ubuntu 23.10 and older
- 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 - See note above about Hyprland-Dots newer version incompatibility
- 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
- If you want to contribute and/or test the Hyprland-Dotfiles (development branch),
Hyprland-Dots-Development - Want to contribute on KooL-Hyprland-Dots Click
HEREfor a guide how to contribute - Want to contribute on This Installer? Click
HEREfor a guide how to contribute
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
