JaKooLit/Arch-Hyprland 是一个托管在 GitHub 上的开源项目，主要使用 Shell 编写，采用 GNU General Public License v3.0 许可证，目前获得 4.6k 个 Star、351 次 Fork。
仓库全名
JaKooLit/Arch-Hyprland
README 摘要
IMPORTANT! Beginning of March 2026, This project will be archived and it will be maintained by Dwilliams https://github.com/LinuxBeginnings https://github.com/LinuxBeginnings/Arch-Hyprland 💌 KooL's Arch - Hyprland Install Script 💌 Read this First    How to use this script    Gallery    👇 KOOL's Hyprland-Dots related Links 👇 Hyprland-Dots repo    Youtube    Wiki…
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 (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
🆕 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!
🚩 Switching to SDDM assuming you have GDM installed and running
if you really want switch to SDDM from GDM, you need to disable the gdm first.
sudo systemctl disable gdm.service then reboot
after reboot, need to ran the install script via tty. So suggest download the install script first. Then disable gdm. reboot and once logged in, cd into Distro-Hyprland then ./install.sh and then choose SDDM and SDDM theme in the options.
NOTE: Distro-Hyprland is Arch-Hyprland, or Fedora-Hyprland … depends on which install scripts you downloaded.
💫 SDDM and GTK Themes offered
If you opted to install SDDM theme, here’s the LINK which is a modified 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, dont 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.
Packages above are installed by the respective installer scripts; no manual action is required. If you prefer package pre-install via the main package list, ensure acpi, lm_sensors, and libnotify are present in your setup.
🛣️ 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
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
KooL Hyprland-Dotfiles Showcase
评论