Lokales Netzwerk

Dies ist der einfachste Verbindungsmodus. Dein iPhone verbindet sich direkt über dein lokales WLAN mit dem Mac. Die Latenz ist minimal und kein Internet erforderlich.

Wann verwenden

iPhone und Mac sind im selben WLAN-Netzwerk.
Du bist zu Hause, im Büro oder in einem vertrauenswürdigen Netzwerk.
Du möchtest die niedrigste Latenz und einfachste Einrichtung.

Schritt 1: Netzwerk prüfen

Beide Geräte müssen im selben WLAN-Netzwerk und Subnetz sein. Mögliche Hindernisse:

Firmen- oder Hotel-WLAN mit Geräteisolierung (Client Isolation).
VPN auf einem der Geräte, das den Netzwerkpfad ändert.
Mac-Firewall, die eingehende Verbindungen auf dem Server-Port blockiert.

Schritt 2: IP-Adresse des Macs finden

Die Mac-App zeigt deine IP im Menüleisten-Panel an. Alternativ:

ipconfig getifaddr en0

Das gibt etwas wie 192.168.1.42 zurück.

Schritt 3: Server starten

Bei Nutzung der Mac-App: Klicke auf Server starten in der Menüleiste. Der Standardport ist 8765.

Bei Nutzung des Standalone-Servers:

cd MacServer && npm start

Den Port kannst du mit der Umgebungsvariable PORT anpassen:

PORT=9000 npm start

Schritt 4: Vom iPhone verbinden

Option A: QR-Code (am schnellsten)

Klicke auf das QR-Icon im Menüleisten-Panel der Mac-App. Scanne ihn mit der iPhone-App.

Option B: Bonjour-Erkennung

Der Server sendet per Bonjour/mDNS. Dein Mac sollte in der Server-Liste der iPhone-App erscheinen.

Option C: Manuelle Eingabe

Gib 192.168.x.x und Port 8765 (oder deinen angepassten Port) in der iPhone-App ein.
Gib den API-Schlüssel ein, falls gesetzt.
Tippe auf Verbinden.

Schritt 5: Überprüfung

Nach der Verbindung erstelle oder wähle eine Session und sende einen Test-Prompt. Die Terminal-Ausgabe sollte innerhalb von 1-2 Sekunden erscheinen.

Tipps

Mac-Ruhezustand: Die Mac-App kann den Ruhezustand verhindern, solange der Server läuft. Aktiviere dies in den App-Einstellungen, wenn dein Mac bei langen Aufgaben in den Ruhezustand geht.
Statische IP: Wenn sich die IP deines Macs häufig ändert (DHCP), weise eine statische IP in Systemeinstellungen > Netzwerk zu, oder nutze stattdessen die Bonjour-Erkennung.
Firewall: Falls die macOS-Firewall aktiv ist, erlaube eingehende Verbindungen für die Tactic Remote App (oder den node-Prozess beim Standalone-Server).