A CachyOS Hyprland Starter Kit

All right, I’ve got a working repo going for anyone that wants to try it out.

Just bear in mind that it’s not finalized and there a couple notable things off with it:

  1. Currently using Breeze for the icons. This may or may not be the final form. Easy enough to switch to your own in any case.
  2. Noctalia’s first start setup wizard is not activating at the moment. I’m trying to get it turned back on even though I’m starting it off with a settings.json already placed in its config directory, but no luck yet. In the interim, you can and should manually activate the setup wizard yourself by clicking this button in the settings panel:

Installation Instructions

  1. Run the CachyOS Installer and do whatever you wish until you get to the desktop environment selection.
  2. Select “No Desktop” as your desktop environment. You should do this instead of selecting “Hyprland” because doing that activates a suite of software that are unnecessary and unused. “No Desktop” ensures that you only install what you need since the install script will take care of everything that Hyprland needs to run.
  3. Do whatever you want in the Additional Packages section as long as you don’t select anything from inside the desktop environment menus. I’d also advise leaving the cachyos-wallpapers package checked unless you will be immediately changing the wallpapers in the login greeter(nwg-hello).
  4. Complete the installation.
  5. You will reboot into a tty since we selected no display manager package in the installer. Log in.
  6. Clone the git repository:
git clone https://codeberg.org/dirge/cachyos-hyprland-noctalia.git
  1. Navigate into the base directory just created:
cd cachyos-hyprland-noctalia
  1. Allow install.sh to be run as an executable:
chmod 755 install.sh
  1. Run the script:
./install.sh
  1. It will ask you to authenticate a couple times. Once for package installation and the other for moving greetd into position so it is used next time you boot.
  2. Reboot
systemctl reboot

And then you’re done