Setup und Download
KatanA installieren
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.
- 01
Unterstützt Homebrew und Winget
- 02
Direkte Downloads verfügbar
- 03
Plattformspezifische Hinweise enthalten
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
macOS + Homebrew
Empfohlener Weg für die schnellste Einrichtung auf macOS.
- Bevorzugte Methode laut offiziellem README.
- Direkt nach der Installation einsatzbereit.
brew tap HiroyukiFuruno/KatanA && brew install --cask katana-desktopmacOS Manueller Download
- 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.appWindows x86_64
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-desktopLinux x86_64
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-desktopAktualisierung
- 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.
Optionale Diagramm-Einrichtung
Mermaid und ZenUML benötigen kein Extra-Setup; nur PlantUML kann eine zusätzliche Laufzeit benötigen.
Mermaid
Keine Einrichtung nötig
Mermaid-Diagramme inklusive ZenUML-Sequenzdiagramme werden im aktuellen Dokumentfluss gerendert.
PlantUML
Java-Laufzeit installieren
Führen Sie `brew install openjdk@25` aus und laden Sie `plantuml.jar` beim ersten Öffnen eines PlantUML-Dokuments.
Draw.io
Keine Einrichtung nötig
Draw.io-Diagramme werden nativ im aktuellen Workflow unterstützt.
nach der installation
Nach der Installation (3 Pruefungen)
- 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
FAQ
PlantUML rendert nicht
Java Runtime installieren und plantuml.jar Download erlauben.
macOS blockiert die App
Open Anyway in Privacy & Security oder einmal xattr verwenden.