JaKooLit/Fedora-Hyprland 是一个托管在 GitHub 上的开源项目，主要使用 Shell 编写，采用 GNU General Public License v3.0 许可证，目前获得 2.6k 个 Star、143 次 Fork。
仓库全名
JaKooLit/Fedora-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/Fedora-Hyprland 💌 KooL's Fedora - Hyprland Install Script 💌 Read this First    How to use this script    Gallery    👇 KOOL's Hyprland-Dots related Links 👇 Hyprland-Dots repo    Youtube  &ensp…
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
✨ Some notes on installation / Pre-requisites
This install script was tested on Minimal Fedora using Fedora Everything Link
This script is meant to install in any Fedora Work stations and its Spins.
If starting from scratch, recommended spin to install is the Sway Spin. However, I have tested this script in Fedora Workstation (gnome), Plasma Spin and Sway
I have not tested in any other spin. However, if you 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
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.
🚩 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.
✨ Costumize the packages and COPR Repos
inside the install-scripts directory, you can edit 00-hypr-pkgs.sh, copr.sh, etc. Care though as the Hyprland Dots might not work properly
💫 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.
🔔 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-fedora website LINK and edit nvidia.sh in install-scripts directory to install proper gpu driver
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.
✨ Auto clone and install
Caution 注意
If you are using FISH SHELL, DO NOT use this function. Clone and ran install.sh instead
you can use this command to automatically clone the installer and ran the script for you
NOTE: curl package is required before running this command
sh <(curl -L https://raw.githubusercontent.com/JaKooLit/Fedora-Hyprland/main/auto-install.sh)
✨ 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
11 March 2025, due to popular request, created a guided uninstall.sh script. 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
The old uninstall.sh is renamed to uninstall-old.sh . This is made by other party. I DO NOT GUARANTEE that it will not mess up your system. USE with caution.
✨ 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 agnosterzak theme is installed. Which is from external oh-my-zsh theme. 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”
🎞️ AGS Overview DEMO
in case you wonder, here is a short demo of AGS overview Youtube LINK
✨ TO DO once installation done and dotfiles copied
SUPER H for HINT or click on the waybar HINT! Button
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:
possibly adding gruvbox themes, cursors, icons
❗ 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 having issues with installation and you have nvidia, THIS STEP might help
❗ other known issues
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
Note that Fedora 39 and older, waybar was not updated. Hyprland and older waybar build than 0.10.3, you will have no workspace
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 dnf autoremove rofi . Install rofi-wayland with sudo dnf install rofi-wayland. Rofi-wayland is compatible with x11 so no need to worry.
If you use Brave or any Chrome based browsers, you may want to addexec-once = gnome-keyring-daemon --start to ~/.config/hypr/UserConfigs/Startup_Apps.conf if you don’t want to get asked for your password each time you reboot your machine and want to access Brave. Obviously, you need to install gnome-keyring
If you want to have a Fedora minimal installation, suggest to install using Fedora Everything. See THIS
🫥 Improving performance for Older Nvidia Cards using driver 470
KooL Hyprland-Dotfiles Showcase
评论