mirror of
https://github.com/AlexMacocian/quick-visor.git
synced 2026-07-15 15:09:32 +00:00
Alexandru Macocian
82 lines
1.6 KiB
Markdown
82 lines
1.6 KiB
Markdown
# quick-visor
|
|
|
|
A Quickshell-based display manager overlay for Hyprland.
|
|
|
|
## Usage
|
|
|
|
Install from the AUR:
|
|
|
|
```sh
|
|
paru -S quick-visor
|
|
```
|
|
|
|
Launch the display layout window:
|
|
|
|
```sh
|
|
quick-visor
|
|
```
|
|
|
|
Optionally bind a key to launch it:
|
|
|
|
```conf
|
|
bind = SUPER, D, exec, quick-visor
|
|
```
|
|
|
|
For local development, run directly from the clone:
|
|
|
|
```sh
|
|
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.
|
|
|
|
```json
|
|
{
|
|
"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.
|
|
|
|
```jsonc
|
|
{
|
|
"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:
|
|
|
|
```conf
|
|
source = ~/.config/hypr/monitors.conf
|
|
```
|
|
|