Zum Hauptinhalt springen

Tutorial: macOS-Einrichtung

Dieses Tutorial führt Sie durch das vollständige macOS-spezifische Onboarding für Rephlo – von der Installation bis zu Ihrem ersten Drag-Select-Befehl. Wenn Sie die allgemeine Installation & Einrichtung bereits abgeschlossen haben, behandelt dieses Tutorial die macOS-spezifischen Details ausführlicher.

Zweck​

macOS hat einzigartige Sicherheits- und Datenschutzanforderungen, die sich auf die Funktionsweise von Rephlo auswirken. Anders als unter Windows, wo globale Tastenkombinationen ohne weiteres Zutun funktionieren, erfordert macOS eine ausdrückliche Zustimmung des Nutzers für Accessibility (Bedienungshilfen) und Screen Recording (Bildschirmaufnahme). Dieses Tutorial stellt sicher, dass Sie alles korrekt konfigurieren, damit Ihnen der volle Funktionsumfang von Rephlo von Anfang an zur Verfügung steht.

Voraussetzungen​

AnforderungDetails
macOS-Version10.15 Catalina oder neuer
ArchitekturApple Silicon (M1/M2/M3/M4) oder Intel (x64)
Speicherplatzca. 250 MB für das Anwendungspaket
Ollama (optional)Wenn Sie lokale Modelle verwenden möchten, installieren Sie Ollama separat

Schritt 1: Herunterladen und Installieren​

1.1 Rephlo herunterladen​

Rufen Sie https://rephlo.app/download auf und laden Sie das aktuelle macOS-Paket herunter:

  • Rephlo-macos-arm64.dmg für Macs mit Apple Silicon (M1/M2/M3/M4)
  • Rephlo-macos-x64.dmg für Intel-Macs

1.2 In den Applications-Ordner installieren​

  1. Öffnen Sie die heruntergeladene .dmg-Datei.
  2. Ziehen Sie Rephlo.app in den Ordner /Applications.
  3. Werfen Sie das Disk-Image aus.

1.3 Erster Start — Gatekeeper​

Wenn Sie Rephlo zum ersten Mal öffnen, blockiert macOS Gatekeeper die App möglicherweise mit der Meldung: „Rephlo.app kann nicht geöffnet werden, da der Entwickler nicht verifiziert werden kann."

So gehen Sie vor:

  1. Doppelklicken Sie die App nicht. Führen Sie stattdessen einen Rechtsklick (oder Control-Klick) auf Rephlo.app in /Applications aus.
  2. Wählen Sie im Kontextmenü "Open" (Öffnen).
  3. Klicken Sie im Bestätigungsdialog erneut auf "Open".

macOS merkt sich diese Entscheidung. Bei späteren Starts genügt ein normaler Doppelklick.

Warum passiert das? macOS Gatekeeper warnt vor Apps, die außerhalb des Mac App Store heruntergeladen wurden. Die Methode Rechtsklick > "Open" umgeht diese Prüfung für die aktuelle App.

Schritt 2: Erforderliche Berechtigungen erteilen​

Warum Berechtigungen benötigt werden​

Rephlo lauscht auf globale Tastenkombinationen und liest Ihre aktuelle Textauswahl aus, wenn Sie einen Befehl auslösen – dafür ist unter macOS die Berechtigung Accessibility erforderlich. Die Berechtigung Screen Recording wird separat für die Bildschirmaufnahme benötigt.

Ohne diese Berechtigungen funktioniert die systemweite Integration von Rephlo nicht.

2.1 Der PermissionPreCheckDialog​

Unmittelbar nach dem ersten Start zeigt Rephlo den PermissionPreCheckDialog an:

2.2 Accessibility-Berechtigung erteilen​

  1. Klicken Sie im PermissionPreCheckDialog neben Accessibility auf "Open System Settings".
  2. macOS öffnet System Settings > Privacy & Security > Accessibility.
  3. Suchen Sie Rephlo in der App-Liste.
  4. Schalten Sie den Regler auf ON.
  5. Authentifizieren Sie sich bei Aufforderung mit Ihrem macOS-Passwort oder Touch ID.
  6. Kehren Sie zum Rephlo-Dialog zurück.

2.3 Screen-Recording-Berechtigung erteilen​

  1. Klicken Sie im PermissionPreCheckDialog neben Screen Recording auf "Open System Settings".
  2. macOS öffnet System Settings > Privacy & Security > Screen Recording.
  3. Suchen Sie Rephlo in der App-Liste.
  4. Schalten Sie den Regler auf ON.
  5. Authentifizieren Sie sich bei Aufforderung.
  6. Kehren Sie zum Rephlo-Dialog zurück.

2.4 Überprüfen und neu starten​

  1. Klicken Sie im Rephlo-Dialog auf "Check Again".
  2. Beide Berechtigungen sollten jetzt als Granted angezeigt werden.
  3. Beenden Sie Rephlo vollständig (Rechtsklick auf das Menüleisten-Symbol > Exit, oder Cmd+Q).
  4. Starten Sie Rephlo erneut aus /Applications. Einige macOS-Berechtigungsänderungen erfordern einen vollständigen Neustart, damit sie wirksam werden.

Tipp: Wenn die Kontrollkästchen nach dem Aktivieren der Berechtigungen weiterhin "Not Granted" anzeigen, beenden Sie Rephlo, warten Sie einige Sekunden und starten Sie es erneut. macOS speichert den alten Berechtigungsstatus manchmal zwischen.

Schritt 3: Richten Sie Ihren ersten Anbieter ein​

Nachdem die Berechtigungen erteilt wurden, konfigurieren Sie einen AI-Anbieter, damit Rephlo Ihre Befehle verarbeiten kann.

  1. Klicken Sie auf das Rephlo-Symbol in der Menüleiste und wählen Sie dann "Settings" (oder öffnen Sie das Dashboard und navigieren Sie zu Settings).
  2. Gehen Sie zu Settings > LLM Providers.
  3. Wählen Sie einen Anbieter aus der Liste:
AnbieterWas Sie benötigen
OpenAIAPI-Schlüssel von platform.openai.com
AnthropicAPI-Schlüssel von console.anthropic.com
GoogleAPI-Schlüssel von aistudio.google.dev
GroqAPI-Schlüssel von console.groq.com
xAI (Grok)API-Schlüssel von console.x.ai
OpenRouterAPI-Schlüssel von openrouter.ai
Azure OpenAIEndpunkt-URL + API-Schlüssel aus Ihrem Azure-Portal
OllamaLokale Installation, kein Schlüssel erforderlich (Endpunkt: http://localhost:11434)
OpenAI-CompatibleEndpunkt-URL + API-Schlüssel für einen beliebigen kompatiblen Dienst
  1. Geben Sie Ihren API-Schlüssel ein (und die Endpunkt-URL, falls zutreffend).
  2. Klicken Sie zur Überprüfung auf Test Connection.
  3. Klicken Sie auf Save.

Schnellstart-Empfehlung: Wenn Sie neu bei AI-APIs sind, lassen sich OpenAI oder Anthropic am einfachsten einrichten. Wenn Sie vollständige Privatsphäre ohne Cloud-Abhängigkeit bevorzugen, installieren Sie Ollama und verwenden Sie lokale Modelle.

Schritt 4: macOS-Tastenkombinationen kennenlernen​

Rephlo verwendet plattformspezifische Standard-Tastenkombinationen. Hier sehen Sie die macOS-Standardwerte im Vergleich zu Windows/Linux:

AktionmacOSWindows / Linux
Kontextmenü-OverlayShift+Cmd+CCtrl+Shift+Alt+C
BildschirmaufnahmeShift+Cmd+SCtrl+Shift+Alt+S
Drag-Select-ModifikatorCmdCtrl
VergrößernCmd+PlusCtrl+Plus
VerkleinernCmd+MinusCtrl+Minus
Zoom zurücksetzenCmd+0Ctrl+0

Tastenkombinationen anpassen​

Alle Tastenkombinationen lassen sich vollständig anpassen:

  1. Öffnen Sie Settings > Hotkeys.
  2. Klicken Sie auf das Tastenkombinationsfeld, das Sie ändern möchten.
  3. Drücken Sie die gewünschte Tastenkombination.
  4. Klicken Sie auf Save.

Tipp: Wenn eine Tastenkombination mit einer anderen Anwendung kollidiert (z. B. Spotlight, Alfred oder Raycast), wählen Sie eine alternative Kombination. Rephlo warnt Sie, wenn die gewählte Tastenkombination bereits vom System verwendet wird.

Schritt 5: Mit Drag-Select testen​

Der Drag-Select-Workflow ist die schnellste Möglichkeit, Rephlo unter macOS zu verwenden. Probieren wir es aus:

5.1 Öffnen Sie eine beliebige Textanwendung​

Öffnen Sie TextEdit, Notes, Safari oder eine beliebige App mit auswählbarem Text.

5.2 Führen Sie den Drag-Select aus​

  1. Halten Sie die Taste Cmd gedrückt (der standardmäßige Drag-Select-Modifikator unter macOS).
  2. Klicken und ziehen Sie bei gedrückter Cmd-Taste mit der Maus über einen Text, um ihn auszuwählen.
  3. Sobald Sie die Maustaste loslassen, erscheint das Rephlo-Overlay sofort in der Nähe des Cursors.

5.3 Einen Befehl ausführen​

  1. Klicken Sie im Overlay auf "Summarize" (oder einen anderen Befehl).
  2. Rephlo sendet den ausgewählten Text an Ihren konfigurierten AI-Anbieter.
  3. Das Ergebnis erscheint im Overlay.
  4. Klicken Sie auf Copy, um das Ergebnis in die Zwischenablage zu kopieren, oder auf Insert, um den ursprünglichen Text zu ersetzen.

Hinweis: Die Drag-Select-Modifikatortaste lässt sich anpassen. Gehen Sie zu Settings > Hotkeys > Text Selection Trigger, um sie bei Bedarf von Cmd auf eine andere Taste zu ändern.

Fehlerbehebung bei macOS-spezifischen Problemen​

Tastenkombinationen funktionieren nicht​

Symptom: Das Drücken von Shift+Cmd+C bewirkt nichts. Das Overlay erscheint nicht.

Ursache: Die Accessibility-Berechtigung wurde nicht erteilt, oder die App wurde nach dem Erteilen der Berechtigung nicht neu gestartet.

Lösung:

  1. Öffnen Sie System Settings > Privacy & Security > Accessibility.
  2. Stellen Sie sicher, dass Rephlo auf ON gestellt ist.
  3. War die Berechtigung bereits aktiviert, schalten Sie sie auf OFF und dann wieder auf ON.
  4. Beenden und starten Sie Rephlo neu.

Bildschirmaufnahme funktioniert nicht​

Symptom: Screenshot-Befehle schlagen fehl oder erzeugen ein leeres Bild.

Ursache: Die Screen-Recording-Berechtigung wurde nicht erteilt.

Lösung:

  1. Öffnen Sie System Settings > Privacy & Security > Screen Recording.
  2. Stellen Sie sicher, dass Rephlo auf ON gestellt ist.
  3. Beenden und starten Sie Rephlo neu.

Overlay erscheint nicht​

Symptom: Sie drücken die Tastenkombination oder führen Drag-Select aus, aber es erscheint kein Overlay-Fenster.

Mögliche Ursachen und Lösungen:

Mögliche UrsacheLösung
Accessibility nicht erteiltAccessibility-Berechtigung erteilen und neu starten
App läuft nicht als .app-BundleStarten Sie die App aus /Applications/Rephlo.app, nicht über dotnet run
Tastenkombinations-Konflikt mit einer anderen AppPrüfen Sie Settings > Hotkeys auf Konflikte; ändern Sie die Kombination
App ist pausiertRechtsklick auf das Menüleisten-Symbol; falls "Resume Rephlo" angezeigt wird, klicken Sie darauf

Gatekeeper blockiert die App bei jedem Start​

Symptom: macOS zeigt weiterhin die Warnung „der Entwickler kann nicht verifiziert werden" an.

Lösung: Stellen Sie sicher, dass Sie beim ersten Start einen Rechtsklick ausgeführt und "Open" ausgewählt haben. Falls das Problem weiterhin besteht:

  1. Öffnen Sie System Settings > Privacy & Security.
  2. Scrollen Sie nach unten zum Abschnitt Security.
  3. Sie sollten eine Meldung sehen, dass Rephlo blockiert wird. Klicken Sie auf "Open Anyway".

Rephlo erscheint nicht in den Berechtigungslisten​

Symptom: Sie öffnen System Settings > Accessibility, aber Rephlo wird nicht aufgeführt.

Lösung: Starten Sie Rephlo mindestens einmal. macOS fügt Apps erst dann zu den Berechtigungslisten hinzu, wenn die App zum ersten Mal versucht, die geschützte Funktion zu nutzen. Prüfen Sie die Berechtigungsliste nach dem Start erneut.

Nächste Schritte​

Sie sind jetzt vollständig für macOS eingerichtet. Hier sind die empfohlenen nächsten Schritte:

  • Rundgang zur ersten Nutzung — Führen Sie Ihren ersten AI-Befehl Schritt für Schritt aus.
  • Commands — Erfahren Sie, wie Sie eigene Commands erstellen und anpassen.
  • Spaces — Fügen Sie Ihre Dokumente als AI-Kontext hinzu, um fundierte Antworten zu erhalten.
  • Template Gallery — Durchstöbern Sie vorgefertigte Commands für gängige Aufgaben.
  • Erweiterte Anwendungsfälle — Workflows und Automatisierungsrezepte für Power-User.