Tutoriel : Configuration macOS

Ce tutoriel vous guide à travers l'intégration complète spécifique à macOS pour Rephlo, de l'installation jusqu'à votre première commande par glisser-sélectionner. Si vous avez déjà suivi le guide général Installation & Configuration, ce tutoriel approfondit les particularités de macOS.

Objectif

macOS impose des exigences de sécurité et de confidentialité particulières qui influent sur le fonctionnement de Rephlo. Contrairement à Windows, où les raccourcis clavier globaux fonctionnent d'emblée, macOS exige un consentement explicite de l'utilisateur pour Accessibility (Accessibilité) et Screen Recording (Enregistrement d'écran). Ce tutoriel vous permet de tout configurer correctement afin que l'ensemble des fonctionnalités de Rephlo soit disponible dès le premier jour.

Prérequis

Prérequis	Détails
Version de macOS	10.15 Catalina ou ultérieure
Architecture	Apple Silicon (M1/M2/M3/M4) ou Intel (x64)
Espace disque	~250 Mo pour le pack applicatif
Ollama (facultatif)	Si vous prévoyez d'utiliser des modèles locaux, installez Ollama séparément

---

Étape 1 : Téléchargement et installation

1.1 Télécharger Rephlo

Rendez-vous sur https://rephlo.app/download et téléchargez le dernier pack macOS :

• Rephlo-macos-arm64.dmg pour les Mac Apple Silicon (M1/M2/M3/M4)
• Rephlo-macos-x64.dmg pour les Mac Intel

1.2 Installer dans Applications

1. Ouvrez le fichier .dmg téléchargé.
2. Faites glisser Rephlo.app dans le dossier /Applications.
3. Éjectez l'image disque.

1.3 Premier lancement — Gatekeeper

La première fois que vous ouvrez Rephlo, Gatekeeper (le mécanisme de sécurité de macOS) peut le bloquer avec un message : « Rephlo.app ne peut pas être ouvert, car son développeur ne peut être vérifié. »

Pour continuer :

1. Ne double-cliquez pas sur l'application. Faites plutôt un clic droit (ou Control-clic) sur Rephlo.app dans /Applications.
2. Sélectionnez "Open" (Ouvrir) dans le menu contextuel.
3. Dans la boîte de dialogue de confirmation, cliquez à nouveau sur "Open" (Ouvrir).

macOS mémorise ce choix. Les lancements suivants fonctionnent normalement par double-clic.

Pourquoi cela se produit-il ? Gatekeeper avertit à propos des applications téléchargées en dehors du Mac App Store. La méthode clic droit > Open (Ouvrir) contourne cette vérification pour l'application en question.

---

Étape 2 : Accorder les autorisations requises

Pourquoi ces autorisations sont nécessaires

Rephlo écoute les raccourcis clavier globaux et lit votre sélection de texte actuelle lorsque vous déclenchez une commande, ce qui exige l'autorisation Accessibility sous macOS. L'autorisation Screen Recording est nécessaire séparément pour la capture d'écran.

Sans ces autorisations, l'intégration système de Rephlo ne fonctionnera pas.

2.1 La PermissionPreCheckDialog

Immédiatement après le premier lancement, Rephlo affiche la boîte de dialogue PermissionPreCheckDialog :

2.2 Accorder l'autorisation Accessibility

1. Dans la PermissionPreCheckDialog, cliquez sur "Open System Settings" (Ouvrir Réglages Système) en regard d'Accessibility.
2. macOS ouvre System Settings > Privacy & Security > Accessibility (Réglages Système > Confidentialité et sécurité > Accessibilité).
3. Repérez Rephlo dans la liste des applications.
4. Activez le commutateur (ON).
5. Si vous y êtes invité, authentifiez-vous avec votre mot de passe macOS ou Touch ID.
6. Revenez à la boîte de dialogue Rephlo.

2.3 Accorder l'autorisation Screen Recording

1. Dans la PermissionPreCheckDialog, cliquez sur "Open System Settings" (Ouvrir Réglages Système) en regard de Screen Recording.
2. macOS ouvre System Settings > Privacy & Security > Screen Recording (Réglages Système > Confidentialité et sécurité > Enregistrement de l'écran).
3. Repérez Rephlo dans la liste des applications.
4. Activez le commutateur (ON).
5. Authentifiez-vous si demandé.
6. Revenez à la boîte de dialogue Rephlo.

2.4 Vérifier et redémarrer

1. De retour dans la boîte de dialogue Rephlo, cliquez sur "Check Again".
2. Les deux autorisations doivent maintenant apparaître comme Accordé.
3. Quittez complètement Rephlo (clic droit sur l'icône de la barre de menus > Exit, ou Cmd+Q).
4. Relancez Rephlo depuis /Applications. Certaines modifications d'autorisations macOS nécessitent un redémarrage complet pour prendre effet.

Astuce : Si les cases à cocher affichent toujours « Not Granted » après avoir activé les autorisations, essayez de quitter Rephlo, d'attendre quelques secondes, puis de le relancer. macOS met parfois en cache l'ancien état des autorisations.

---

Étape 3 : Configurer votre premier fournisseur

Une fois les autorisations accordées, configurez un fournisseur d'IA afin que Rephlo puisse traiter vos commandes.

1. Cliquez sur l'icône Rephlo dans la barre de menus, puis sélectionnez "Settings" (ou ouvrez le Dashboard et accédez à Settings).
2. Allez dans Settings > LLM Providers.
3. Choisissez un fournisseur dans la liste :

Fournisseur	Ce dont vous avez besoin
OpenAI	Clé API depuis platform.openai.com
Anthropic	Clé API depuis console.anthropic.com
Google	Clé API depuis aistudio.google.dev
Groq	Clé API depuis console.groq.com
xAI (Grok)	Clé API depuis console.x.ai
OpenRouter	Clé API depuis openrouter.ai
Azure OpenAI	URL de point de terminaison + clé API depuis votre portail Azure
Ollama	Installation locale, aucune clé nécessaire (point de terminaison : http://localhost:11434)
OpenAI-Compatible	URL de point de terminaison + clé API pour tout service compatible

4. Saisissez votre API Key (et l'URL de point de terminaison, le cas échéant).
5. Cliquez sur Test Connection pour vérifier.
6. Cliquez sur Save.

Recommandation pour un démarrage rapide : Si vous découvrez les API d'IA, OpenAI ou Anthropic sont les plus simples à configurer. Si vous préférez une confidentialité totale sans dépendance au cloud, installez Ollama et utilisez des modèles locaux.

---

Étape 4 : Découvrir les raccourcis clavier macOS

Rephlo utilise des raccourcis clavier par défaut propres à chaque plateforme. Voici les valeurs par défaut de macOS comparées à Windows/Linux :

Action	macOS	Windows / Linux
Superposition du menu contextuel	Shift+Cmd+C	Ctrl+Shift+Alt+C
Capture d'écran	Shift+Cmd+S	Ctrl+Shift+Alt+S
Modificateur de glisser-sélection	Cmd	Ctrl
Zoom avant	Cmd+Plus	Ctrl+Plus
Zoom arrière	Cmd+Minus	Ctrl+Minus
Réinitialiser le zoom	Cmd+0	Ctrl+0

Personnaliser les raccourcis clavier

Tous les raccourcis clavier sont entièrement personnalisables :

1. Ouvrez Settings > Hotkeys.
2. Cliquez sur le champ de raccourci que vous voulez modifier.
3. Appuyez sur la combinaison de touches souhaitée.
4. Cliquez sur Save.

Astuce : Si un raccourci entre en conflit avec une autre application (par exemple Spotlight, Alfred ou Raycast), choisissez une autre combinaison. Rephlo vous avertira si le raccourci choisi est déjà utilisé par le système.

---

Étape 5 : Tester avec le glisser-sélection

Le glisser-sélection (drag-select) est le moyen le plus rapide d'utiliser Rephlo sur macOS. Essayons-le :

5.1 Ouvrir n'importe quelle application de texte

Ouvrez TextEdit, Notes, Safari, ou toute application avec du texte sélectionnable.

5.2 Effectuer le glisser-sélection

1. Maintenez la touche Cmd enfoncée (le modificateur de glisser-sélection par défaut sur macOS).
2. Tout en maintenant Cmd, cliquez et faites glisser votre souris sur du texte pour le sélectionner.
3. Lorsque vous relâchez le bouton de la souris, la superposition Rephlo apparaît immédiatement près de votre curseur.

5.3 Exécuter une commande

1. Dans la superposition, cliquez sur "Summarize" (ou toute autre commande).
2. Rephlo envoie le texte sélectionné à votre fournisseur d'IA configuré.
3. Le résultat apparaît dans la superposition.
4. Cliquez sur Copy pour placer le résultat dans votre presse-papiers, ou sur Insert pour remplacer le texte d'origine.

Remarque : La touche modificatrice du glisser-sélection est personnalisable. Allez dans Settings > Hotkeys > Text Selection Trigger pour la remplacer par une autre touche que Cmd si vous le préférez.

---

Dépannage des problèmes spécifiques à macOS

Les raccourcis clavier ne fonctionnent pas

Symptôme : Appuyer sur Shift+Cmd+C ne fait rien. La superposition n'apparaît pas.

Cause : L'autorisation Accessibility n'est pas accordée, ou l'application n'a pas été redémarrée après l'octroi de l'autorisation.

Solution :

1. Ouvrez System Settings > Privacy & Security > Accessibility.
2. Confirmez que Rephlo est activé (ON).
3. S'il était déjà activé, désactivez-le (OFF), puis réactivez-le (ON).
4. Quittez et relancez Rephlo.

La capture d'écran ne fonctionne pas

Symptôme : Les commandes de capture d'écran échouent ou produisent une image vide.

Cause : L'autorisation Screen Recording n'est pas accordée.

Solution :

1. Ouvrez System Settings > Privacy & Security > Screen Recording.
2. Confirmez que Rephlo est activé (ON).
3. Quittez et relancez Rephlo.

La superposition n'apparaît pas

Symptôme : Vous appuyez sur le raccourci ou effectuez un glisser-sélection, mais aucune fenêtre de superposition n'apparaît.

Causes possibles et solutions :

Cause possible	Solution
Accessibility non accordée	Accordez l'autorisation Accessibility et redémarrez
L'application ne s'exécute pas en tant que pack .app	Lancez depuis /Applications/Rephlo.app, pas via dotnet run
Conflit de raccourci avec une autre application	Vérifiez Settings > Hotkeys pour détecter les conflits ; changez la combinaison
L'application est en pause	Faites un clic droit sur l'icône de la barre de menus ; si « Resume Rephlo » s'affiche, cliquez dessus

Gatekeeper bloque l'application à chaque lancement

Symptôme : macOS continue d'afficher l'avertissement « le développeur ne peut être vérifié ».

Solution : Vérifiez que vous avez bien fait un clic droit et sélectionné "Open" lors du premier lancement. Si le problème persiste :

1. Ouvrez System Settings > Privacy & Security.
2. Faites défiler jusqu'à la section Sécurité.
3. Vous devriez voir un message indiquant que Rephlo est bloqué. Cliquez sur "Open Anyway" (Ouvrir quand même).

Rephlo n'apparaît pas dans les listes d'autorisations

Symptôme : Vous ouvrez System Settings > Accessibility mais Rephlo n'y figure pas.

Solution : Lancez Rephlo au moins une fois. macOS n'ajoute les applications aux listes d'autorisations qu'après leur première tentative d'utilisation de la fonctionnalité protégée. Après le lancement, vérifiez à nouveau la liste des autorisations.

---

Prochaines étapes

Vous êtes maintenant entièrement configuré sur macOS. Voici les prochaines étapes recommandées :

• Parcours de première utilisation — Exécutez votre première commande IA étape par étape.
• Commands — Apprenez à créer et personnaliser vos propres commandes.
• Spaces — Ajoutez vos documents comme contexte IA pour des réponses ancrées.
• Template Gallery — Parcourez des commandes prêtes à l'emploi pour les tâches courantes.
• Cas d'usage avancés — Flux de travail avancés et recettes d'automatisation.