Skip to content

For automated installation of Hyprland on Arch Linux or any Arch Linux-based distros

License

Notifications You must be signed in to change notification settings

JaKooLit/Arch-Hyprland

Repository files navigation

πŸ’Œ ** KooL's Arch - Hyprland Install Script ** πŸ’Œ

GitHub Repo stars GitHub last commit GitHub repo size



πŸ‘‡ KOOL's Hyprland-Dots related Links πŸ‘‡

Sparkles KooL Hyprland-Dotfiles Showcase Sparkles

showoff-dots.mp4

Gallery and Videos

πŸ“· Screenshots

πŸ“· More Screenshots on v2 Link and Previous-Screenshots and

✨ A video walk through my dotfilesLink

✨ A video walk on My Hyprland-Dots v2Link

πŸ“½οΈ youtube video showcase: Link

πŸͺ§πŸͺ§πŸͺ§ ANNOUNCEMENT πŸͺ§πŸͺ§πŸͺ§

  • 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

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.

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

πŸ†• Prerequisites

  • This install script is intended for atleast Server type / Minimal Arch Linux installed.

Note

πŸ”˜ Pipewire and Pipewire audio

  • This script will install pipewire and will also disable or will uninstall pulseaudio. If you dont want it, edit install.sh, about line 191 and comment the line execute_script "pipewire.sh" or you can simply just delete pipewire.sh in install-scripts directory before installing.

✨ Customize the packages to be installed

  • inside the install-scripts directory, you can edit 00-hypr-pkgs.sh. Care though as the Hyprland Dots may not work properly!

πŸ’« SDDM and GTK Themes offered

  • 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.

πŸ‘€ NVidia GPU Owners.

  • By default, nvidia-dkms will be installed. and only supports GTX 900 and newer. If required to install older driver, edit the nvidia.sh in install-scripts directory

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.

  • After installation, check THIS

✨ to use this script

  • clone this repo (latest commit only) to reduce file size download by using git. Change directory, make executable and run the script
git clone --depth=1 https://github.com/JaKooLit/Arch-Hyprland.git ~/Arch-Hyprland
cd ~/Arch-Hyprland
chmod +x install.sh
./install.sh

🀟 semi-unattended installation (new for 2025)

  • edit preset.sh to modify what packages you want. Make sure to change only with Y or N
  • to use preset instead of usual ./install.sh you can ran like this
./install.sh --preset
  • if you have nvidia you can add --nvidia argument
./install.sh --preset --nvidia
  • its called semi-unattended it is because you still have to answer some questions when installing KooL's Hyprland Dots

✨ for ZSH and OH-MY-ZSH installation

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 funky theme is installed. You can find more themes from this OH-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"

✨ TO DO once installation done and dotfiles copied

  • if you opted to install gtk themes, to apply the theme and icon, press the dark/light button (beside the padlock). To apply Bibata modern ice cursor, launch nwg-look (GTK Settings) through rofi. Hyprland-Dots v2.1.18, initial boot file will attempt to apply GTK themes,cursor, and icons. You can tweak more using nwg-look (GTK-Settings) utility

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

  • Head over to FAQ and TIPS

πŸ™‹ Got a questions regarding the Hyprland Dots or configurations? πŸ™‹

  • Head over to wiki Link WIKI

⌨ Keybinds

Tip

KooL's Dots v2.3.7 has a searchable keybind function via rofi. (SUPER SHIFT K) or right click the HINTS waybar button

πŸ™‹ πŸ‘‹ Having issues or questions?

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

πŸ”§ Proper way to re-installing a particular script from install-scripts directory

  • CD into Arch-Hyprland directory 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

πŸ›£οΈ Roadmap:

  • show a progress bar in downloading and compiling part when installing outside AUR or official repo

❗ some known issues for nvidia

  • 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

❗ other known issues

  • If you are using this script on an Arch-Based distros like Arco linux, or cachy OS or EOS or Manjaro, make sure to install pipewire, pipewire-pulse & pipewire-audio first. Arco Linux, on some of their ISO's still shipped with pulseaudio as audio backend. You will experience getting "stuck" on installation.
  • To install pipewire and its services , sudo pacman -S pipewire wireplumber pipewire-audio pipewire-pulse . When prompted, remove / replace pulseaudio. After that, you can ran ./install.sh
  • installing of cava-git on a newly installed Arch makes the install keep hanging. Switched back to cava. After booting and logged in, if cava dont work, replace it cava-git yay -S cava-git or paru -S cava-git

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 pacman -Rns rofi . Install rofi-wayland with sudo pacman -S rofi-wayland. Rofi-wayland is compatible with x11 so no need to worry.

πŸ«₯ Improving performance for Older Nvidia Cards using driver 470

πŸ“’ 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 :)

⏩ Contributing

  • 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

πŸ‘πŸ‘πŸ‘ Thanks and Credits!

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

πŸ’– Support

  • 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 🀩

Buy Me a Coffee at ko-fi.com

"Buy Me A Coffee"

πŸ“Ή Youtube videos (Click to view and watch the playlist) πŸ“Ή

Youtube Playlist Thumbnail

πŸ₯°πŸ₯° πŸ’–πŸ’– πŸ‘πŸ‘πŸ‘

Stargazers over time