README

_// design by t2_

!hyde_banner


















  Installation    
  Updating    
  Themes    
  Styles    
  Contributing    
  Keybindings    
  Youtube    
  Wiki    
  Discord  




  
    
    
    
    
    
  


Check this out for the full note:
Journey to HyDE and beyond




--








---

The installation script is designed for a minimal Arch Linux install, but may work on some Arch-based distros.
While installing HyDE alongside another DE/WM should work, due to it being a heavily customized setup, it will conflict with your GTK/Qt theming, Shell, SDDM, GRUB, etc. and is at your own risk.

For NixOS support there is a separate project being maintained @ Hydenix

 [!IMPORTANT]
 The install script will auto-detect an NVIDIA card and install a matching DKMS driver path for your kernel.
 Newer cards may use nvidia-dkms / nvidia-open-dkms, while legacy cards should be checked first against Scripts/nvidia-db/.
 Please ensure that your NVIDIA card supports the DKMS driver family selected for it in the list provided here.

 If a DKMS package is selected, expect a local module build for the current kernel during installation. This can take several minutes and may happen even when an NVIDIA DKMS package was already installed, because DKMS rebuilds modules for the active kernel.

 [!CAUTION]
 The script modifies your grub or systemd-boot config to enable NVIDIA DRM.

 [!TIP]
 BigLinux / Manjaro users may want to take a snapshot with Timeshift before running the installer, especially when HyDE is being installed alongside an existing desktop environment. On older NVIDIA cards, review the legacy driver list in Scripts/nvidia-db/ before continuing.

To install, execute the following commands:

shell
sudo pacman -S --needed git base-devel
git clone --depth 1 https://github.com/HyDE-Project/HyDE ~/HyDE
cd ~/HyDE/Scripts
./install.sh


 [!TIP]
 You can also add any other apps you wish to install alongside HyDE to Scripts/pkg_user.lst and pass the file as a parameter to install it like so:

 shell
 ./install.sh pkg_user.lst
 

 [!IMPORTANT]
 Refer your list from Scripts/pkg_extra.lst
 or you can cp Scripts/pkg_extra.lst Scripts/pkg_user.lst if you wish to install all extra packages.



Please reboot after the install script completes and takes you to the SDDM login screen (or black screen) for the first time.
For more details, please refer to the installation wiki.

Quick checklist for Arch-based distros such as BigLinux / Manjaro:

- Create a restore point (for example with Timeshift) before running install.sh.
- Expect changes to GRUB, SDDM, and /etc/pacman.conf during installation.
- If your GPU is an older NVIDIA model, verify whether it belongs to a legacy dkms series before accepting the default driver path.
- If a -dkms NVIDIA package is selected, expect a local module build for the current kernel during install; this can take a while even if the package was already