Skip to content

Latest commit

 

History

History
255 lines (187 loc) · 15.5 KB

README.md

File metadata and controls

255 lines (187 loc) · 15.5 KB

💌 ** JaKooLit's Opensuse Tumbleweed - Hyprland Install Script ** 💌

GitHub Repo stars GitHub last commit GitHub repo size


👇 KOOL's Hyprland-Dots related Links 👇

Sparkles KooL Hyprland-Dotfiles Showcase Sparkles

Show.Case.mp4

Gallery and Videos

📷 Screenshots #### 📷 Some Screenshots

📷 More Screenshots (from other distros since it it using same Hyprland Dots) Link

📹 Video presentation Youtube 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

♨️ Activating Packman 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 installed.
  • In theory, This should work on a any Tumbleweed with DE (Plasma, Gnome, XFCE). Although I am not sure about xfce default login manager if able to detect 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.

✨ Some notes on installation

  • Some apps are being installed using OPI. These packages are wlogout, swaylock-effects and nwg-look
  • for SDDM, by script sddm-qt6 will be installed. If you have already sddm, I HIGHLY SUGGEST NOT to install sddm through this script since I dont know the impact to your current sddm. Opensuse ship 2 version, sddm and sddm-qt6. The latter is more up to date... (I think)
  • Another for SDDM, if you are installing from a server type of opensuse install, I highly suggest to install the sddm theme since you'll get a vanilla look sddm theme.

✨ Costumize the packages

  • inside the install-scripts directory, you can edit 02-hypr-pkgs.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
  • If you opted to install GTK Themes, Icons here's the LINK & Bibata Cursor Modern Ice (assets directory)

⚠️ WARNING! If you have GDM already as log-in manager, DO NOT install SDDM

  • You will likely to encounter issues

🔔 NOTICE TO NVIDIA OWNERS

  • Please take note that the nvidia driver will be install is G06 driver, which is for GeForce 700 series (Maxwell, Pascal...) and up see here NVIDIA-Opensuse-Link
  • You can edit the install-scripts/nvidia.sh if you require for older cards. However, do take note that it may not work as older nvidia drivers dont support wayland well.

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.

  • NVIDIA users / owners, after installation, check THIS

🔔 NOTICE TO ASUS ROG Laptop owners

  • There is an guide by Asusctl dev Asusctl
  • However. during my test, the ROG gui is not behaving well, and I cant click any button. So The asusctl and supergfxctl that I have set here are build from source through their gitlab

✨ 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/OpenSuse-Hyprland.git ~/OpenSuse-Hyprland
cd ~/OpenSuse-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

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
  • to change the theme, edit ~/.zshrc 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

🙋 👋 Having issues or questions?

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

❗ some known issues on this Installer

  • some users reported that they have to install some packages. It is in the install-scripts/force-install.sh
  • At this time the packages force to install are the following playerctl

✨ Packages that are manually downloaded and build. These packages will not be updated by dnf and have to be manually updated

❗ 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

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 zypper rm rofi . Install rofi-wayland with sudo zypper in rofi-wayland. Rofi-wayland is compatible with x11 so no need to worry.

🔧 Proper way to re-installing a particular script from install-scripts directory

  • CD into OpenSuse-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

🛣️ TO DO:

  • [ ] Install zsh and oh-my-zsh without necessary steps above DONE
  • [ ] Make it fully functional (duh 🤣) done
  • [ ] hyprland-nvidia - NOT SUPPORTED NOW SUPPORTED 🥳
  • [ ] SDDM is not starting. However, if you opt to install zsh, I have already set for auto log-in to Hyprland so once you set up zsh like the instruction above. You just need to type username and password. FIXED 🥳

🫥 Improving performance for Older Nvidia Cards using driver 470

❗ some known issues on Hyprland-Dots

  • See FAQ section of Hyprland-Dots FAQ

⌨ 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

⏩ 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

📒 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 :)

👍👍👍 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