Back to workbench
/usr/bin/hyprland-wizard

Hyprland Easy Setup Wizard

A script I built to automate my Hyprland configuration.

I really like tiling window managers, but setting up Hyprland from scratch can be a bit tedious with all the different components like Waybar and Rofi. I built this wizard to automate that process for myself and others.

Why I made this

I wanted a way to get a functional Hyprland desktop with just one command. I use both Arch and Ubuntu I use Arch, so I made sure the script can detect which one you're on and install the right packages.

How it works

It's a collection of Bash scripts. It checks for your distribution and then installs a curated list of tools like Kitty for the terminal and Waybar for the status bar. I also included some pre-configured settings so the workflow feels smooth right out of the box.

Distro Detection

The script handles the differences between pacman and apt so I don't have to worry about manual installation.

# How I detect the distribution if [ -f /etc/arch-release ]; then PKM="sudo pacman -S --noconfirm" DEPS=("hyprland" "kitty" "waybar") elif [ -f /etc/lsb-release ]; then PKM="sudo apt install -y" DEPS=("hyprland" "kitty") fi

Things I learned

Building this taught me a lot about Wayland and how it differs from X11. I had to learn about different compositor settings and how to handle Nvidia GPUs, which was a real challenge at first.

What's next

I want to try adding a simple theme switcher and maybe some automatic configuration for different monitor setups.