quick-visor

A Quickshell-based display manager overlay for Hyprland.

Usage

Install from the AUR:

paru -S quick-visor

Launch the display layout window:

quick-visor

Optionally bind a key to launch it:

bind = SUPER, D, exec, quick-visor

For local development, run directly from the clone:

quickshell -n -p qml/shell.qml

Configuration

~/.config/quick-visor/config.json controls panel dimensions. Missing keys fall back to built-in defaults, so the file can be omitted.

{
  "panelWidth": 760,
  "panelHeight": 520
}

Theming

~/.config/quick-visor/theme.jsonc controls fonts and colors. It supports JSONC comments and reloads while quick-visor is running.

{
  "fontFamily": "JetBrainsMono Nerd Font",
  "fontSize": 14,
  "background": "#101010",
  "foreground": "#e6e6e6",
  "idle": "#9a9a9a",
  "accent": "#7aa2f7",
  "warning": "#f7768e",
  "overlayStrong": "#26344d",
  "overlayWeak": "#202020",
  "border": "#3a3a3a",
  "padding": 8,
  "spacing": 8,
  "radius": 12
}

Persisting the layout

Applying a layout runs hyprctl keyword monitor for each display, which takes effect immediately but is lost when Hyprland restarts.

To make changes survive a restart, quick-visor also rewrites ~/.config/hypr/monitors.conf only if that file already exists (the same file generated by tools like nwg-displays and typically sourced from hyprland.conf). If the file is absent, quick-visor leaves it alone and applies the layout at runtime only. Add the following to your hyprland.conf to enable persistence:

source = ~/.config/hypr/monitors.conf