Skip to Content
MvpDots

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]
OptionEffect
--yes, -yAccept the defaults: packages, configs, wallpapers, plugins. No SDDM or GRUB.
--dry-runPrint every step, change nothing.
--doctorOnly check which programs are missing, and that Hyprland is 0.55 or newer.
--no-packagesSkip the package step (any distro the installer does not know).
--no-pluginsDon't build the Hyprland plugins.
--no-wallpapersDon't download the wallpapers.
--sddmAlso install the login screen theme (sudo).
--grubAlso 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
CommandEffect
buildFetch and build every plugin for the installed Hyprland, without sudo.
autoRun at each login: rebuild in the background if Hyprland changed.
statusShow the Hyprland version and what the plugins were built for.
on / offBuild 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 | off

Eco 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

On this page