JaKooLit / Fedora-Hyprland

For automated installation of Hyprland on Fedora 38, 39 & 40 or any Fedora based distros
GNU General Public License v3.0
833 stars 65 forks source link
fedora fedora-linux fedora-workstation hyprland install-script installer rice rofi rofi-config swww wallust waybar


 Read this First 
  
 How to use this script 
  
 Gallery 
  

### 💌 ** JaKooLit's Fedora Hyprland Install Script ** 💌 ![GitHub Repo stars](https://img.shields.io/github/stars/JaKooLit/Fedora-Hyprland?style=for-the-badge&color=cba6f7) ![GitHub last commit](https://img.shields.io/github/last-commit/JaKooLit/Fedora-Hyprland?style=for-the-badge&color=b4befe) ![GitHub repo size](https://img.shields.io/github/repo-size/JaKooLit/Fedora-Hyprland?style=for-the-badge&color=cba6f7)
👇 KOOL's Hyprland-Dots related Links 👇


 Hyprland-Dots repo 
  
 Youtube 
  
 Wiki 
  
 Keybinds 
  
 FAQ 
  
 Discord 

Sparkles KooL Hyprland-Dotfiles Showcase Sparkles

https://github.com/JaKooLit/Hyprland-Dots/assets/85185940/50d53755-0f11-45d6-9913-76039e84a2cd
### Gallery and Videos
📷 Screenshots #### 📷 Hyprland-Dots-v2 Featuring Rofi

Installed on Fedora 40 👍 Installed on Nobara 39 🥰 ![alt text](https://github.com/JaKooLit/screenshots/blob/main/Distro-Hyprland/Fedora/nobara39.png) Installed on Nobara 38 🥰 ![alt text](https://github.com/JaKooLit/screenshots/blob/main/Hyprland-ScreenShots/Fedora/Hyprland-Nobara.png)
#### 📸 More up to date screenshots [`Link`](https://github.com/JaKooLit/screenshots/tree/main/Hyprland-Dots-Showcase) #### 📷 Older Screenshots [`V1`](https://github.com/JaKooLit/screenshots/tree/main/Hyprland-ScreenShots/Fedora) & [`V2`](https://github.com/JaKooLit/screenshots/tree/main/Hyprland-ScreenShots/Fedora-v2) #### ✨ Youtube presentation [`v1`](https://youtu.be/w2dt4GlHjV0) #### ✨ Youtube presentation [`v2`](https://youtu.be/_U_WR33XNYY) #### ✨ A video walk through my dotfiles[`Link`](https://youtu.be/fO-RBHvVEcc?si=ijqxxnq_DLiyO8xb) #### ✨ A video walk through of My Hyprland-Dots v2[`Link`](https://youtu.be/yaVurRoXc-s?si=iDnBC5S3thPBX3ZE) ### 🪧🪧🪧 ANNOUNCEMENT 🪧🪧🪧 - This Repo does not contain Hyprland Dots or configs! Dotfiles can be checked here [`Hyprland-Dots`](https://github.com/JaKooLit/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`](https://github.com/JaKooLit/Hyprland-Dots/wiki/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`](https://github.com/JaKooLit/Wallpaper-Bank) > [!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. #### EXPERIMENTAL UNINSTALL SCRIPT - 04 July, 2024 - uninstall.sh . Note that it is experimental. I DO NOT GUARANTEE that it will not mess up your system. USE with caution. > [!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 #### ✨ Some notes on installation / Pre-requisites - This install script was tested on Minimal Fedora using Fedora Everything [`Link`](https://youtu.be/_U_WR33XNYY) - 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. #### ⚠️ WARNING! If you have GDM already as log-in manager, DO NOT install SDDM - You will likely to encounter issues #### ⚠️ WARNING! nwg-look takes long time to install. - 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 > [!IMPORTANT] > For Fedora 38 & 39, including nobara 38 & 39 and all based to Fedora 38 & 39: > edit `install-scripts/nwg-look.sh` Line 15, edit tag to `v0.2.6`. nwg-look v0.2.7 wont build as it needs a higher golang version > Note that Fedora 39 and older, waybar was not updated. Hyprland and older waybar build than 0.10.3, you will have no workspace #### ✨ 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`](https://github.com/JaKooLit/simple-sddm-2) - If you opted to install GTK Themes, Icons here's the [`LINK`](https://github.com/JaKooLit/GTK-themes-icons) & Bibata Cursor Modern Ice (assets directory) #### 🔔 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`](https://rpmfusion.org/Howto/NVIDIA#Installing_the_drivers) and 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. ## ✨ 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 ```bash git clone --depth=1 https://github.com/JaKooLit/Fedora-Hyprland.git ~/Fedora-Hyprland cd ~/Fedora-Hyprland chmod +x install.sh ./install.sh ```

#### ✨ for ZSH and OH-MY-ZSH installation > installer should auto change your default shell to zsh. However, if it does not, do this ```bash chsh -s $(which zsh) zsh source ~/.zshrc ``` - reboot or logout - by default agnoster theme is installed. You can find more themes from this [`OH-MY-ZSH-THEMES`](https://github.com/ohmyzsh/ohmyzsh/wiki/Themes) - to change the theme, edit ~/.zshrc ZSH_THEME="desired theme" #### ✨ TO DO once installation done and dotfiles copied - SUPER H for HINT or click on the waybar HINT! Button - Head over to [FAQ](https://github.com/JaKooLit/Hyprland-Dots/wiki/FAQ) and [TIPS](https://github.com/JaKooLit/Hyprland-Dots/wiki/TIPS) - NVIDIA users / owners, after installation, check [`THIS`](https://github.com/JaKooLit/Hyprland-Dots/wiki/Notes_to_remember#--for-nvidia-gpu-users) #### ✨ Packages that are manually downloaded and build. These packages will not be updated by dnf and have to be manually updated - nwg-look [`LINK`](https://github.com/nwg-piotr/nwg-look) - wallust [`LINK`](https://codeberg.org/explosion-mental/wallust) #### 🙋 Got a questions regarding the Hyprland Dots or configurations? 🙋 - Head over to wiki Link [`WIKI`](https://github.com/JaKooLit/Hyprland-Dots/wiki) #### ⌨ Keybinds - Keybinds [`CLICK`](https://github.com/JaKooLit/Hyprland-Dots/wiki/Keybinds) #### 🙋 👋 Having issues or questions? - for the install part, kindly open issue on this repo - for the Pre-configured Hyprland dots / configuration, submit issue [`here`](https://github.com/JaKooLit/Hyprland-Dots/issues) #### 🔧 Proper way to re-installing a particular script from install-scripts directory - CD into Fedora-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 #### 🛣️ 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 - more info from the hyprland wiki [`Hyprland Wiki Link`](https://wiki.hyprland.org/FAQ/#my-external-monitor-is-blank--doesnt-render--receives-no-signal-laptop) - 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 > [!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. #### 🫥 Improving performance for Older Nvidia Cards using driver 470 - [`SEE HERE`](https://github.com/JaKooLit/Hyprland-Dots/discussions/123#discussion-6035205) #### 📒 Final Notes - join my discord channel [`Discord`](https://discord.com/invite/9JEgZsfhex) - 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`](https://github.com/JaKooLit/Hyprland-Dots/tree/development) #### 👍👍👍 Thanks and Credits! - [`Hyprland`](https://hyprland.org/) Of course to Hyprland and @vaxerski for this awesome Dynamic Tiling Manager. - [`HYPRLAND COPR REPO`](https://copr.fedorainfracloud.org/coprs/solopasha/hyprland/) - a shout out to the one who created and maintaining Hyprland COPR Repo ### 💖 Support - a Star on my Github repos would be nice 🌟 - Subscribe to my Youtube Channel [YouTube](https://www.youtube.com/@Ja.KooLit) - 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"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/JaKooLit) #### 📹 📹 Youtube videos (Click to view and watch the playlist) [![Youtube Playlist Thumbnail](https://raw.githubusercontent.com/JaKooLit/screenshots/main/Youtube.png)](https://youtube.com/playlist?list=PLDtGd5Fw5_GjXCznR0BzCJJDIQSZJRbxx&si=iaNjLulFdsZ6AV-t) ## 🥰🥰 💖💖 👍👍👍 [![Stargazers over time](https://starchart.cc/JaKooLit/Fedora-Hyprland.svg?variant=adaptive)](https://starchart.cc/JaKooLit/Fedora-Hyprland)