Files
dotfiles/README.md
T
2026-05-25 10:45:24 -07:00

63 lines
2.0 KiB
Markdown

# 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 | gtklock |
| Login/greeter | greetd + regreet |
| Wallpaper | swww |
| 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.).