Setup und Download

Nutzen Sie Paketmanager für die schnellste Einrichtung oder direkte Downloads über GitHub Releases.

Installationswege für macOS, Windows x86_64 und Linux x86_64.

Diese Seite wird parallel zum Repository gepflegt, um Konsistenz mit den neuesten Distributionsartefakten zu gewährleisten.

Aktuelle Unterstützung

macOS / Windows x86_64 / Linux x86_64

Enthält Homebrew und DMG für macOS, Winget und MSI für Windows sowie Homebrew und tar.gz für Linux x86_64.

macOS

Empfohlener Weg für die schnellste Einrichtung auf macOS.

brew tap HiroyukiFuruno/KatanA && brew install --cask katana-desktop

Laden Sie das neueste `KatanA-Desktop-x.y.z.dmg` von GitHub Releases herunter.
Verschieben Sie `KatanA Desktop.app` in Ihren Programme-Ordner.
Führen Sie bei Bedarf vor dem ersten Start den Gatekeeper-Befehl aus.
Auf macOS Sequoia (15.x) kann dies für nicht-notarisierte Builds erforderlich sein. Alternativ können Sie es über Systemeinstellungen > Datenschutz & Sicherheit zulassen.

xattr -cr /Applications/KatanA\ Desktop.app

Winget ist der schnellste Weg unter Windows. MSI ist ebenfalls auf GitHub Releases verfügbar.

Installation via Winget oder Download der `KatanA-windows-x86_64.msi` von GitHub Releases.
Doppelklick zum Installieren.
Startmenü- und Desktop-Verknüpfungen werden automatisch erstellt.

winget install HiroyukiFuruno.katana-desktop

Homebrew wird empfohlen, sofern verfügbar. tar.gz ist ebenfalls auf GitHub verfügbar.

Installation via Homebrew oder Download der `KatanA-linux-x86_64.tar.gz` von GitHub Releases.
Archiv entpacken.
Ausführbare Datei direkt starten.

brew tap HiroyukiFuruno/KatanA && brew install katana-desktop

KatanA bietet eine integrierte Auto-Update-Funktion.
Auf macOS nutzen Sie die Schaltfläche "Update & Restart" in der App.
Auf Windows/Linux verlinkt der Update-Dialog direkt auf das neueste Release.
Bei Installation via Homebrew auf macOS löst sich das erste In-App-Update automatisch von Homebrew, um Verwaltungskonflikte zu vermeiden.

Mermaid und ZenUML benötigen kein Extra-Setup; nur PlantUML kann eine zusätzliche Laufzeit benötigen.

Mermaid

Mermaid-Diagramme inklusive ZenUML-Sequenzdiagramme werden im aktuellen Dokumentfluss gerendert.

PlantUML

Führen Sie `brew install openjdk@25` aus und laden Sie `plantuml.jar` beim ersten Öffnen eines PlantUML-Dokuments.

Draw.io

Draw.io-Diagramme werden nativ im aktuellen Workflow unterstützt.

nach der installation

Workspace oeffnen: README und Specs im Baum pruefen.
Diagramme pruefen: Mermaid inklusive ZenUML oder PlantUML oeffnen und Rendering pruefen.
Updates pruefen: einmalige Update-Pruefung in der App ausfuehren.

support

PlantUML rendert nicht

Java Runtime installieren und plantuml.jar Download erlauben.

macOS blockiert die App

Open Anyway in Privacy & Security oder einmal xattr verwenden.