Übersicht
Sysplained ist eine macOS-Desktop-App, die schwer verständliche Terminalausgaben in klare, visuelle Einblicke umwandelt. Sie deckt die Bereiche Netzwerk, laufende Prozesse und Festplattenspeicher ab – alles an einem Ort, mit leicht verständlichen Erklärungen zu jeder Kennzahl.
Während ich mich auf meine AWS-Zertifizierung vorbereitete, hatte ich genug von den wenig benutzerfreundlichen Terminalansichten unter macOS. In dieser Zeit während meines Studiums startete ich Sysplained als Nebenprojekt. Gleichzeitig wollte ich Claude Code ausprobieren, das ich intensiv nutzte, um die gesamte Codebasis zu schreiben: Die App selbst war bis ins Detail geplant, aber jede Codezeile wurde von Claude Code verfasst. Von der ersten Idee bis zur von Apple signierten, herunterladbaren App dauerte der gesamte Prozess nicht länger als eine Woche.
Auf dieser Seite findest du eine Zusammenfassung der Funktionen von Sysplained und erfährst, wie die App dir helfen kann. Am besten probierst du sie aber einfach direkt aus.
Funktionen
12 Ansichten sind in drei Gruppen organisiert:
Netzwerk
Schnittstellen, Live-Bandbreite, aktive Verbindungen, offene Ports, DNS-Abfrage, Routing, ARP-Nachbarn und WLAN-Details machen die Netzwerkaktivität des Macs leichter verständlich.
System
Laufende Prozesse, CPU- und Speicherauslastung, Festplatten- und Speicherlayouts sowie Umgebungsinformationen erklären, was der Mac tut und welche Ressourcen er verwendet.
Architektur
macOS-Shell-Befehle (ifconfig, lsof, netstat, ps, df, dig, …) werden über ein Tauri-Rust-Backend unter Einhaltung einer strengen Capability Allowlist ausgeführt. Reine TypeScript-Parserfunktionen wandeln Rohdaten aus der Standardausgabe in typisierte Daten um, wodurch sie sich unabhängig mit Fixture-Dateien und Unit Tests prüfen lassen. TanStack Query übernimmt das Caching und die Abfrageintervalle pro Ansicht – inaktive Ansichten pausieren ihre Aktualisierung, um unnötige Systemaufrufe zu vermeiden.
Deployment und AWS-Infrastruktur
Sysplained nutzt zwei getrennte AWS-Auslieferungswege, die mit AWS CDK als Infrastructure as Code definiert sind. Die Astro-Landingpage unter sysplained.com wird durch GitHub Actions in einen privaten, versionierten S3 Bucket deployed und über CloudFront ausgeliefert. Route 53 übernimmt DNS, ACM stellt die TLS-Zertifikate bereit und Edge Caching, URL Rewriting sowie Security Headers sorgen für eine schnelle und sichere statische Website.
Die App selbst läuft lokal auf macOS, während AWS unter downloads.sysplained.com den Release-Kanal bereitstellt. Version Tags lösen einen GitHub Actions Workflow aus, der die App baut, signiert und von Apple notarisiert. Anschliessend übernimmt der Workflow über OIDC eine eng begrenzte AWS-Rolle und lädt versionierte DMGs, Checksummen, Updater-Archive, Signaturen sowie ein latest.json-Manifest in einen zweiten privaten S3 Bucket hinter CloudFront. Die Landingpage verwendet eine stabile Download URL, während die App das Manifest auf neue Releases prüft und signierte Update-Pakete vor der Installation kryptografisch verifiziert. In GitHub werden keine dauerhaften AWS-Zugangsdaten gespeichert.
Tech Stack
Entwickelt mit Tauri 2 + React 19 + TypeScript + Tailwind CSS 4. UI-Komponenten von shadcn/ui. Tabellen über TanStack Table, Diagramme über Recharts. 117 Unit Tests decken alle Parser ab. Automatisierte Screenshot-Erfassung über Playwright.
Die App wird zu einer einzigen, etwa 11 MB grossen .app-Binärdatei gepackt, die für macOS 12+ bestimmt ist.
