Docs · Documentation

Customization

Keybindings, waybar, walker, first-boot flow. The four surfaces most users tweak first.

vinOS ships an opinionated default. Everything in this section is how to change that default without giving up the parts you like.

Keybindings — the shipped Hyprland chord map, and how to add your own.
Waybar — top bar layout, modules, and per-theme styling.
Walker menu — app launcher, emoji picker, custom entries.
First-boot customization — what vinos-first-run does, opting out of routines and bundles.

The shipped Hyprland keybindings, grouped by purpose. Extend them by dropping conf files into ~/.config/hypr/bindings.d/.

The shipped top-bar layout, the modules, and how to reorder or hide them without losing the default when you rebuild.

The walker launcher, its providers, and how to add custom entries you can trigger from Super+Space.

What vinos-first-run and vinos-welcome do on your first login, and how to opt out of the bits you don't want.