Daemon Behavior

## Why a daemon

You save profiles with the TUI. But who applies them when you're not looking?

That's what `hyprmoncfgd` does. It runs in the background, watches for monitor hotplug events, and applies the best matching profile automatically. Plug in a monitor, undock your laptop, connect to a projector -- the daemon handles it.

This is especially useful if you move between setups regularly. A conference projector, a coworking space monitor, your desk at home -- each one has different resolution, position, and scale requirements. Save a profile once, and the daemon takes care of it from then on.

## How it works

1. Read the current monitor set from Hyprland
2. Score every saved profile against the connected hardware
3. Pick the best match (by hardware identity, not connector name)
4. Write `monitors.conf` atomically
5. Reload Hyprland
6. Re-read monitor state and verify the result

The daemon uses the **same apply engine** as the TUI. There is no separate "best effort" code path. If the TUI can apply a profile correctly, so can the daemon.

## Profile matching

Profiles are scored based on how well their stored hardware identities match what's currently plugged in. A profile saved with a Dell UltraSharp and a laptop display will score highest when exactly those monitors are connected.

The scoring rewards overlap and penalizes mismatches:

- Monitors in both the profile and the current set: high score
- Monitors in the profile but not connected: moderate penalty
- Connected monitors not in the profile: smaller penalty

Ties are broken alphabetically. The daemon tracks what it last applied and skips redundant re-applications.

## Setup

```bash
mkdir -p ~/.config/systemd/user
cp packaging/systemd/hyprmoncfgd.local.service ~/.config/systemd/user/hyprmoncfgd.service
systemctl --user daemon-reload
systemctl --user enable --now hyprmoncfgd
```

## Run manually

For testing or one-off use:

```bash
hyprmoncfgd
```

### Useful flags

```bash
hyprmoncfgd --debounce 1500ms     # wait longer before applying after a plug event
hyprmoncfgd --poll-interval 5s    # how often to check if socket2 is unavailable
hyprmoncfgd --profile desk        # always apply this specific profile
hyprmoncfgd --quiet               # suppress log output
```

## Forcing a specific profile

Use `--profile <name>` when you want the daemon to skip matching and always apply one chosen profile. Useful when you know exactly what's connected and don't want the scoring algorithm involved.

```bash
hyprmoncfgd --profile conference-projector
```

## Logs

```bash
journalctl --user -u hyprmoncfgd -f
```

You'll see profile scoring, match results, apply steps, and any verification failures.

Why a daemon

You save profiles with the TUI. But who applies them when you’re not looking?

That’s what hyprmoncfgd does. It runs in the background, watches for monitor hotplug events, and applies the best matching profile automatically. Plug in a monitor, undock your laptop, connect to a projector – the daemon handles it.

This is especially useful if you move between setups regularly. A conference projector, a coworking space monitor, your desk at home – each one has different resolution, position, and scale requirements. Save a profile once, and the daemon takes care of it from then on.

How it works

Read the current monitor set from Hyprland
Score every saved profile against the connected hardware
Pick the best match (by hardware identity, not connector name)
Write monitors.conf atomically
Reload Hyprland
Re-read monitor state and verify the result

The daemon uses the same apply engine as the TUI. There is no separate “best effort” code path. If the TUI can apply a profile correctly, so can the daemon.

Profile matching

Profiles are scored based on how well their stored hardware identities match what’s currently plugged in. A profile saved with a Dell UltraSharp and a laptop display will score highest when exactly those monitors are connected.

The scoring rewards overlap and penalizes mismatches:

Monitors in both the profile and the current set: high score
Monitors in the profile but not connected: moderate penalty
Connected monitors not in the profile: smaller penalty

Ties are broken alphabetically. The daemon tracks what it last applied and skips redundant re-applications.

Setup

mkdir -p ~/.config/systemd/user
cp packaging/systemd/hyprmoncfgd.local.service ~/.config/systemd/user/hyprmoncfgd.service
systemctl --user daemon-reload
systemctl --user enable --now hyprmoncfgd

Run manually

For testing or one-off use:

hyprmoncfgd

Useful flags

hyprmoncfgd --debounce 1500ms     # wait longer before applying after a plug event
hyprmoncfgd --poll-interval 5s    # how often to check if socket2 is unavailable
hyprmoncfgd --profile desk        # always apply this specific profile
hyprmoncfgd --quiet               # suppress log output

Forcing a specific profile

Use --profile <name> when you want the daemon to skip matching and always apply one chosen profile. Useful when you know exactly what’s connected and don’t want the scoring algorithm involved.

hyprmoncfgd --profile conference-projector

Logs

journalctl --user -u hyprmoncfgd -f

You’ll see profile scoring, match results, apply steps, and any verification failures.