Go to file

Hermes 08f7a1a9ee feat: add WireGuard Waybar custom module

- Added scripts/wireguard-status.sh — JSON output with lock/unlock icons,
  human-readable TX/RX stats, tooltip with peer/endpoint/IP details
- Added custom/wireguard module to Waybar modules.json (10s interval, JSON
  return type, click left/right for up/down)
- Added custom/wireguard to modules-right bar config
- Added CSS for #custom-wireguard (connected/disconnected classes)
- Added openresolv install and Waybar refresh instructions to README.org

2026-05-20 14:33:28 -04:00

README.org

Gortium Dotfiles

Welcome
Apps
- nvim
- emacs (Doom)
- btop
- hyprland
- kitty
- rclone
- starship
- tmux
- waybar
  - WireGuard Module
- Wireplumber
- wofi
- yazi
- zsh
Archives
- I3
- Terminator

Welcome

I use stow to deploy all this to where it need to go (mostly ~/.confg).

Apps

nvim

emacs (Doom)

btop

hyprland

kitty

rclone

starship

tmux

waybar

WireGuard Module

The Waybar includes a custom WireGuard VPN status module that shows connection status, TX/RX stats, and peer info.

Setup:

Install openresolv (needed by wg-quick for DNS):
```
sudo pacman -S openresolv
```

Configure sudo for wg-quick (required for click-to-toggle binds):

echo "$USER ALL=(ALL) NOPASSWD: /usr/bin/wg-quick" | sudo tee /etc/sudoers.d/wireguard

Create a WireGuard config (if not exists):

sudo cp /etc/wireguard/work-laptop.conf /etc/wireguard/
sudo chmod 600 /etc/wireguard/work-laptop.conf

Refresh Waybar to pick up new config:

killall -q waybar && waybar -c ~/.config/waybar/config.jsonc & -s ~/.config/waybar/style.css &

Or use the launch script:

~/.config/waybar/launch.sh

Keybinds:

$mainMod+Ctrl+V — Connect WireGuard (work-laptop)
$mainMod+Ctrl+Shift+V — Disconnect WireGuard

The module polls /usr/bin/wg every 10 seconds. It shows a lock icon with TX/RX when connected, or an unlock icon when disconnected.