# Dotfiles (Niri + Wayland)

A personal Wayland desktop configuration centered around the **Niri** tiling compositor.

| Area | Tool |
|---|---|
| Compositor | niri |
| Bar | waybar |
| Terminal | alacritty |
| Shell | fish + starship |
| Launcher | wofi |
| Notifications | mako |
| Lockscreen | hyprlock |
| Login/greeter | greetd + regreet |
| Wallpaper | awww |
| Screenshots | grim + slurp + satty |
| Clipboard | cliphist |
| Theme | Tomorrow Night (GTK: Materia-dark, icons: Papirus) |

Everything is symlinked into `~/.config` via `install.sh`, with packages listed in `packages.txt`.

## Setup

```bash
git clone git@github.com:YOURNAME/dotfiles.git
cd dotfiles
./install.sh
```

### One-time hibernation enablement

Hibernation requires a persistent swap file, kernel resume parameters, and a regenerated UKI. Run once, then reboot:

```bash
sudo bash scripts/enable-hibernation.sh
```

After reboot, `systemctl hibernate` will work, and lid close / 30-min idle will suspend-then-hibernate per the tracked logind config.

### One-time NetworkManager activation

After `install.sh` deploys the NetworkManager config, swap from `systemd-networkd` to `NetworkManager` (one-time, persistent across reboots):

```bash
sudo systemctl disable --now systemd-networkd
sudo systemctl enable --now NetworkManager
```

Wifi will drop for a few seconds and reconnect via iwd's stored profiles. If reconnection fails, re-enter the wifi password via `nm-applet` (tray icon) or `networkmanager_dmenu` (waybar network widget click).

### One-time fingerprint setup

After `install.sh` installs `fprintd`, enroll a finger and wire it into the sudo + lockscreen auth stacks:

```bash
fprintd-enroll                                  # interactive; touch the reader as prompted
sudo bash scripts/enable-fingerprint.sh         # idempotent — safe to re-run
```

Test with `sudo true` (should prompt for fingerprint) or `Mod+Shift+E` to lock + touch the reader.

To enroll additional fingers: `fprintd-enroll -f left-thumb` (or `right-thumb`, `left-index`, etc.).