oui-decode

wer steckt hinter der MAC? 🕵️ — OUI-Lookup offline, kein Netz, kein Server, nur HTML

Features

• Offline-first — keine API-Calls, keine Cloud, keine Abhängigkeiten zur Laufzeit
• Dual-Interface — Web-App (index.html) und CLI/TUI (mac-vendor.sh) aus derselben DB
• IEEE MA-L Datenbank — 39.516 Einträge (24-bit OUI), direkt eingebettet in db.js
• Bit-Dekodierung — I/G-Bit (Individual/Group) und U/L-Bit (Universally/Locally Administered)
• Byte-Strip — OUI-Extraktion aus beliebigen MAC-Formaten (EC:1C:5D:78:2E:F1 → EC1C5D)
• Synthwave-Terminal-Look — Web-App und TUI im gleichen Neon-Stil (Palette/Fonts aus evpn-docs); Farbe stets mit Text-Label
• Erweiterbar — add / del schreiben atomar auf db.js

Aufruf

Web-App

Doppelklick auf index.html   # oder im Browser: file:///pfad/zu/index.html

Eingabe: MAC-Adresse in beliebigem Format. Live-Lookup während der Eingabe.

CLI / TUI (mac-vendor.sh)

mac-vendor.sh lookup EC:1C:5D:78:2E:F1   # → Siemens AG
mac-vendor.sh lookup ec1c5d               # OUI direkt
mac-vendor.sh search siemens             # Freitextsuche in Vendor-Namen
mac-vendor.sh list                       # alle Einträge (optional: Präfix)
mac-vendor.sh count                      # Anzahl Einträge
mac-vendor.sh add EC1C5D "Siemens AG"    # Eintrag hinzufügen (atomar)
mac-vendor.sh del EC1C5D                 # Eintrag entfernen (atomar)
mac-vendor.sh tui                        # interaktive TUI (bash-nativ)
mac-vendor.sh --help                     # Syntax (auch: help, -h)

Flags werden in drei Formen akzeptiert: lookup, -l, --lookup.

Die DB wird relativ zum echten Skript gesucht (Symlink-Ketten werden aufgelöst), Override per MAC_VENDOR_DB=/pfad/zu/db.js.

Voraussetzungen

• bash 4+
• Linux-Standardtools (awk, sed, sort, cut) — keine externen Deps
• Für DB-Rebuild: nxr + shell.nix (lädt IEEE-OUI-Rohdaten, erzeugt oui.csv/oui.tsv)

db.js ist bereits enthalten und versioniert — Rebuild nur nötig wenn IEEE neue Einträge veröffentlicht.

Fonts: Die Web-App referenziert die kommerziellen Fonts Berkeley Mono und PragmataPro. Die Dateien liegen nicht im Repo — die Lizenzen erlauben das Ausliefern per @font-face von einem eigenen Web-Server, nicht die Weitergabe der Dateien. @font-face nennt daher zwei Quellen: zuerst lokal assets/, dann fonts.assets.mueller.network. Fehlt beides, greift ein System-Monospace-Fallback — Farben, Layout und Glows bleiben identisch, und das Layout ist gegen die abweichenden Fallback-Metriken bis hinunter zu 320 px Breite abgesichert.

Changelog

Siehe CHANGELOG.md. Wird per git-cliff aus Conventional Commits generiert. Manuell nicht editieren.

Installation

git clone ssh://git@forgejo.mueller.network:2222/holm.tools.public/oui-decode.git
cd oui-decode
ln -sfn "$PWD/mac-vendor.sh" ~/bin/mac-vendor

Web-App: index.html direkt im Browser öffnen (file://). Kein Webserver nötig.

Lizenz

MIT — Copyright (c) 2026 holm / Christian Müller, unter Zuhilfenahme von Claude.ai (Anthropic).

Siehe LICENSE.