WLAN aufs Handy beamen, ohne das Passwort laut vorzulesen 📶
  • Shell 97%
  • Nix 3%
Find a file
2026-09-16 00:13:20 +02:00
.gitignore feat: wifi-qr — WLAN-QR-Codes aus dem Secret-Store, Key nie sichtbar 2026-09-15 23:31:06 +02:00
.toolctl-install feat: wifi-qr — WLAN-QR-Codes aus dem Secret-Store, Key nie sichtbar 2026-09-15 23:31:06 +02:00
CHANGELOG.md docs: CHANGELOG v0.1.0 2026-09-15 23:31:07 +02:00
cliff.toml feat: wifi-qr — WLAN-QR-Codes aus dem Secret-Store, Key nie sichtbar 2026-09-15 23:31:06 +02:00
LICENSE feat: wifi-qr — WLAN-QR-Codes aus dem Secret-Store, Key nie sichtbar 2026-09-15 23:31:06 +02:00
README.md docs: README-Symlink ohne absoluten Home-Pfad 2026-09-16 00:12:39 +02:00
shell.nix feat: wifi-qr — WLAN-QR-Codes aus dem Secret-Store, Key nie sichtbar 2026-09-15 23:31:06 +02:00
wifi-qr.sh feat: wifi-qr — WLAN-QR-Codes aus dem Secret-Store, Key nie sichtbar 2026-09-15 23:31:06 +02:00

wifi-qr

shell pass license

WLAN-QR-Codes aus pass erzeugen — je SSID ein PNG mit QR und Klartext-Beschriftung (SSID + Key) darunter. Der Schlüssel wird direkt aus pass in die Bild-Pipeline gereicht und erscheint nie in Terminal, Shell-History oder Prozess-Argumenten.

Features

  • Beliebig viele SSIDs als Parameter, ein PNG je SSID (wifi-<ssid>.png).
  • Schlüssel kommt aus pass (<passdir>/<ssid>), nie sichtbar (QR-String über stdin, Beschriftung über @datei, kein echo, kein argv).
  • Klartext unter dem QR für die WLAN-Karte am Kühlschrank.
  • -l listet die in pass hinterlegten WLANs.
  • Sonderzeichen im Key werden fürs WIFI-QR-Format maskiert.

Aufruf

wifi-qr zentonic                 # ~/wifi-zentonic.png (im aktuellen Ordner)
wifi-qr zentonic z6c-gast        # mehrere auf einmal
wifi-qr -l                       # hinterlegte SSIDs auflisten
WIFI_QR_OUTDIR=~/Bilder wifi-qr zentonic

Voraussetzungen

pass, qrencode, imagemagick (magick), fontconfig (fc-match), optional shred. Auf NixOS via shell.nix oder nix shell nixpkgs#{qrencode,imagemagick}.

Konfiguration

Woher die WLAN-Einträge in pass kommen (Priorität oben > unten):

Quelle Beispiel
Env WIFI_QR_PASSDIR ssh/contexts/<kontext>/network/wifi
Datei ~/.config/wifi-qr/config Zeile PASSDIR=ssh/contexts/<kontext>/network/wifi
Default wifi

Weitere Env: WIFI_QR_OUTDIR (Zielordner), WIFI_QR_SEC (WPA Default oder nopass).

Installation

Über den .toolctl-install-Hook (toolctl sync wifi-qr) wird ~/bin/wifi-qr gelegt. Manuell:

ln -s ~/git/forgejo.mueller.network/holm.tools.public/wifi-qr/wifi-qr.sh ~/bin/wifi-qr

Changelog

Siehe CHANGELOG.md.

Lizenz

MIT — siehe LICENSE.