Commands
Every script the dotfiles install, with its options.
All of these live in ~/.local/bin after installing, so they work from any terminal.
install.sh
./install.sh [options]| Option | Effect |
|---|---|
--yes, -y | Accept the defaults: packages, configs, wallpapers, plugins. No SDDM or GRUB. |
--dry-run | Print every step, change nothing. |
--doctor | Only check which programs are missing, and that Hyprland is 0.55 or newer. |
--no-packages | Skip the package step (any distro the installer does not know). |
--no-plugins | Don't build the Hyprland plugins. |
--no-wallpapers | Don't download the wallpapers. |
--sddm | Also install the login screen theme (sudo). |
--grub | Also install the boot menu theme (sudo; backs up /etc/default/grub). |
uninstall.sh
./uninstall.sh [--dry-run]Removes what install.sh copied and restores the original backup. See Update and uninstall.
setwall
setwall <image> [n]Sets the wallpaper and rebuilds every colour from it with matugen. n (0–3, default 0) picks which of the
image's main colours leads. A fixed accent chosen in Settings wins over the wallpaper.
setaccent
setaccent [#rrggbb]Recolours everything from one accent colour, like macOS's accent picker. With no argument it goes back to the wallpaper's colours. Settings → Appearance calls it.
hypr-plugins
hypr-plugins build | auto | status | on | off| Command | Effect |
|---|---|
build | Fetch and build every plugin for the installed Hyprland, without sudo. |
auto | Run at each login: rebuild in the background if Hyprland changed. |
status | Show the Hyprland version and what the plugins were built for. |
on / off | Build them again / remove them and stop automatic rebuilds. |
snap
snap <screen|window|region|text> [delay-seconds]The screenshot helper behind the capture toolbar. Saves to ~/Pictures/Screenshots, copies to the clipboard and
shows the floating thumbnail. text is Live Text: it reads the words in the selected area (tesseract) and copies them.
hypr-saver
hypr-saver on | offEco look: turns off blur, shadows and animations, Hyprland's biggest GPU and battery costs. off reloads the
config and restores your look exactly. Bound to Win+Alt+G.
idle-step
idle-step <dim|undim|lock|off|on|suspend> [ac|bat|any]One step of the idle chain, called by hypridle. The second argument limits it to the charger, the battery or both; that is how sleep happens only on battery.
The shell's own commands
Keybinds talk to the shell with qs ipc call shell <function>. You can use the same calls in your own binds
or scripts:
qs ipc call shell spotlight # also: start, overview, controlCenter, calendar, wallpapers,
qs ipc call shell settingsAt glass # power, keys, capture, emoji, clipboard, lock, island
qs ipc call shell search "=5 km to miles"
qs ipc call shell quicklook ~/Pictures/photo.jpg