AYVI

Installationsanleitung

AYVI aus dem Quellcode starten.

Es gibt derzeit keinen öffentlichen, signierten und notarisierten App-Download. Der Quellcode ist öffentlich auf GitHub: Diese Anleitung baut einen lokalen Entwicklungsstand.

1. Anforderungen

  • macOS 14 oder neuer laut App-Bundle-Metadaten.
  • Swift 6 Toolchain und Git. Xcode oder die Command Line Tools stellen Swift bereit; in dieser Entwicklungsumgebung wurde Swift 6.3.2 mit Command Line Tools verwendet.
  • Eine Internetverbindung nur zum Klonen und gegebenenfalls für einen Cloud-Provider. Der Mock-Provider sendet nichts; Ollama benötigt ein lokal verfügbares Modell.

Die laufende App benötigt Bedienungshilfen-Zugriff, um ausgewählten Text aus anderen Apps lesen und – soweit möglich – ersetzen zu können.

2. Repository holen

Der folgende Befehl lädt den Quellcode des Repositorys in einen neuen Ordner.

git clone https://github.com/masiv42/AYVI.git AYVI
cd AYVI

Erwartet: Git erstellt den Ordner AYVI. Wenn GitHub nicht erreichbar ist, prüfe Netzwerk und Repository-URL. Führe keine Installationsbefehle aus nicht vertrauenswürdigen Quellen aus.

3. Build prüfen und App-Bundle erstellen

Zuerst den SwiftPM-Build ausführen. Er kompiliert die App, startet sie aber nicht.

swift --version
swift build -j 2
./scripts/bundle.sh

Erwartet: Swift meldet Version 6.x; der Build endet mit „Build complete“; das Skript prüft ein temporäres Bundle und installiert nur die App nach /Applications/AYVI.app. Mit IVY_INSTALL=0 wird nur geprüft und kein App-Bundle zurückgelassen. Ohne das lokale Entwicklerzertifikat verwendet das Skript Ad-hoc-Signierung; dann muss die Bedienungshilfen-Freigabe nach jedem Build neu erteilt werden. Das Bundle ist nicht notarisiert.

Das Bundle kann mit Finder geöffnet werden. Ein Terminal-Start zum lokalen Test ist ebenfalls möglich:

open "/Applications/AYVI.app"

Diese Build-Schritte wurden im Repository ausgeführt. Sie belegen keinen erfolgreichen Start oder eine funktionierende Accessibility-Integration in jeder macOS-Konfiguration.

4. Bedienungshilfen-Zugriff erlauben

  1. AYVI einmal starten.
  2. Öffne Systemeinstellungen → Datenschutz & Sicherheit → Bedienungshilfen.
  3. Aktiviere AYVI. Falls AYVI nicht in der Liste steht, füge /Applications/AYVI.app über die App-Auswahl hinzu.
  4. Beende und öffne die App erneut, wenn macOS es verlangt.

Nach einem erneuten Build: Ad-hoc-signierte Apps können für macOS wie eine neue App-Identität aussehen. Falls die Berechtigung aktiv ist, AYVI sie aber weiterhin anfordert, entferne nur den alten AYVI-Eintrag und füge das aktuelle Bundle erneut hinzu. Andere Berechtigungen nicht pauschal zurücksetzen.

Falls Gatekeeper vor einer nicht verifizierten App warnt, ignoriere oder umgehe die Warnung nicht blind. Dieses Projekt stellt derzeit kein signiertes und notarisiertes Release bereit. Prüfe Herkunft und Quellcode selbst; entscheide dann anhand der offiziellen Apple-Hinweise, ob du diese Entwicklungs-App öffnen möchtest.

5. Erster vorsichtiger Test

  1. Starte AYVI und prüfe, dass das Menüleisten-Symbol vorhanden ist.
  2. Wähle zunächst harmlosen Beispieltext, keine vertraulichen Daten.
  3. Drücke den konfigurierten Shortcut (Standard: ⌥ Space).
  4. Wähle eine lokale Aktion im Quick Mode und prüfe den angezeigten Provider.
  5. Bei normalem Ersetzen den Diff prüfen und bestätigen oder abbrechen. Direkt verbessern ist ein separater, standardmäßig aktivierter Modus ohne zweite Bestätigung; verwende ihn nur, wenn du genau das möchtest.

Die Kompatibilität realer Ziel-Apps ist nicht systematisch manuell geprüft. Falls Auswahl oder Panel nicht wie erwartet erscheint, siehe Fehlerbehebung. Zum automatisierten Testlauf: ./scripts/test.sh.

Autostart

Ein Start-bei-Anmeldung-Schalter ist für diesen Stand nicht als verifiziert dokumentiert. Nutze die macOS-Anmeldeobjekte nur, wenn du den lokalen Entwicklungsbuild bewusst automatisch starten lassen möchtest.