Color has a through-line
Matugen carries wallpaper colors into your apps and desktop chrome. Change the scene, keep the system together.
An Arch + Hyprland desktop, brought together
Everything matches — because everything listens.
One wallpaper drives Matugen, Waybar, Rofi, terminal, GTK, and lock — the whole rice stays in conversation.
01 A desktop in sync
WAVESOS / 2025
One change. Every layer.
Hyprland Matugen + Wallfliper Waybar + Rofi GTK + Qt themes qylock + SDDM
02 / Why WavesOS
A desktop is more
than its windows.
Most setups stop at the compositor. WavesOS connects the details around it—so your colors, controls and daily tools feel like parts of the same place.
WavesOS / desktop systemEverything in its element.
Hyprland at the center
Wallfliper, Waybar and Rofi work around a tuned Wayland workflow, not beside it.
Install on your terms
Use the guided menu, or choose the complete setup. The scripts are there to inspect before you run them.
Yours to understand
Open source, community shaped, and built on your Arch install—not a mystery image.
A closer look
Six screenshot slots · WebP or AVIF, 1200 × 750 · add them in public/previews
01Desktop overviewScreenshot slot / replace in public/previews
02Waybar layoutsScreenshot slot / replace in public/previews
03Rofi launcherScreenshot slot / replace in public/previews
04Lock / SDDMScreenshot slot / replace in public/previews
05Dark vs LightScreenshot slot / replace in public/previews
06Terminal / ThunarScreenshot slot / replace in public/previews
03 / The toolkit
Separate tools.
One visual logic.
A wallpaper-led system works because each layer has a job. WavesHyprland installs the pieces and gives them a shared language.
Hyprland + Lua
A configurable Wayland compositor with a workflow shaped around it.
Matugen + Wallfliper
Wallpaper rotation and generated colors, carried through the system.
Waybar
Multiple layouts and a layout switcher, with styles driven by the active Matugen colors.
Rofi
A multi-style launcher and theme switcher, with previews and colors matched to the wallpaper.
GTK + Qt themes
Dark and light switches coordinate Relax GTK, Kvantum and Relax icon packs across apps.
Kitty, Hyprlock + qylock
Matugen-colored terminal, Hyprlock session lock and SDDM login themed through qylock.
↳ Plus Thunar, wlogout, cliphist, screenshots, brightness and volume controls, nightlight, and other daily-use scripts.
04 / Start with a clean Arch install
Your system.
Your call.
Download or clone WavesHyprland, review the README, then run the installer from its directory.
Run as a normal user. Do not launch with sudo. The installer requests elevated access only for steps that need it.
bash / WavesHyprlandINSTALL
# Enter the project directory
$ cd WavesHyprland
$ chmod +x install.sh scripts/*.sh
# Guided installer menu
$ ./install.sh
# Or select the complete setup
$ ./install.sh --all
Ready when you arenormal user · sudo when needed
05 / The heart of Hyprland
Simple
on purpose.
Hyprland is a modern Wayland compositor built on one idea: you shape the desktop through configuration you can read. WavesOS respects that.
Readable configs
Modular Hyprland files you can open, understand and change—no generated maze.
Scripts, not black boxes
Practical controls are plain shell scripts. Read them, tweak them, or replace them.
Arch ownership
Your files live in ~/.config. Your updates stay with pacman. You stay in charge.
06 / Common questions
Before you
install.
Straight answers about what WavesOS is, what it isn’t, and how it fits into your Arch system.
01What is WavesOS?
WavesOS is an Arch Linux + Hyprland rice delivered by the WavesHyprland installer. It sets up a coordinated desktop—compositor, bar, launcher, theming, lock and login—so you start from something that already feels intentional, not from an empty tty and a pile of unrelated dotfiles.
Explore the source02Is WavesOS a full Linux distribution?
No. It isn’t a separate distro like Omarchy. You stay on Arch. WavesOS is the desktop layer and installer that makes Hyprland usable and cohesive from the first session.
03Is WavesOS free and open source?
Yes. The installer and configuration live in the open as WavesHyprland on GitHub. You can read every script before you run it.
Explore the source04Do I need Quickshell or a custom desktop shell?
No. WavesOS doesn’t replace Hyprland with a heavy shell stack. It stays close to Hyprland itself: modular config, scripts and familiar tools like Waybar and Rofi.
05How do settings work?
There’s no separate settings app hiding everything behind a proprietary panel. Practical controls use scripts and Hyprland configuration—including a Hyprland settings script that edits your config directly. You keep the Arch habit of knowing where your files live.
06Can I still customize everything?
Yes. The point is a strong default, not a cage. Configs are modular and editable—install for a finished baseline, then change what you care about.
07What hardware do I need?
A machine that runs Arch and Hyprland comfortably: 64-bit, with working GPU drivers for Wayland. Exactly like any modern Hyprland setup—nothing exotic beyond that.
08How do updates work?
You update Arch as usual with pacman or your normal workflow. WavesOS doesn’t take over your system updater. Desktop config lives in your home directory, so you stay in control of what changes.
wavesos.live / make it yours
Hyprland,
finished.
Start with the installer. Shape the desktop around you.
Get WavesOS Open source · Arch Linux · Hyprland