← Retour a la documentation

Guide d'installation macOS

Ce guide vous accompagnera dans l'installation de Sokuji sur les systemes macOS. Sokuji est disponible sous forme d'installateur .pkg non signe qui inclut un pilote audio virtuel pour des capacites de traitement audio ameliorees.

Telecharger pour macOS

Configuration requise

  • macOS 10.15 (Catalina) ou ulterieur
  • Processeur Apple Silicon (M1/M2/M3/M4) ou Intel (x86_64)
  • 4 Go de RAM minimum (8 Go recommandes)
  • 200 Mo d'espace disque disponible
  • Privileges d'administrateur (requis pour l'installation du pilote audio virtuel)
  • Connexion Internet pour les services de traduction IA
  • Microphone et haut-parleurs/ecouteurs

Etapes d'installation

Etape 1 : Telecharger Sokuji

Visitez la page officielle des versions sur GitHub pour telecharger la derniere version de Sokuji pour macOS.

Telecharger l'installateur PKG

  • Sokuji-x.x.x-arm64.pkg - Pour les Mac Apple Silicon (M1/M2/M3/M4)
  • Sokuji-x.x.x-x64.pkg - Pour les Mac Intel
  • Chaque installateur comprend l'application Sokuji et le pilote audio virtuel
  • La taille du fichier est d'environ 150-200 Mo

Conseil : Vous ne savez pas lequel telecharger ? Cliquez sur le menu Apple () → "A propos de ce Mac" pour verifier votre type de puce. Si vous voyez "Apple M1/M2/M3/M4", choisissez la version arm64. Si vous voyez "Intel", choisissez la version x64.

L'installateur PKG n'est pas signe, ce qui signifie que vous devrez suivre des etapes speciales pour l'installer (couvert dans l'etape suivante).

Etape 2 : Preparer l'installation

L'installateur PKG n'etant pas signe, macOS le bloquera par defaut. Vous devez supprimer l'attribut de quarantaine avant l'installation.

Supprimer l'attribut de quarantaine (obligatoire)

  1. Ouvrez Terminal (Applications → Utilitaires → Terminal)
  2. Tapez ou collez la commande suivante (remplacez x.x.x par votre numero de version) :

    sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-arm64.pkg

    Pour les Mac Intel, utilisez : sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-x64.pkg

  3. Appuyez sur Entree et saisissez votre mot de passe administrateur lorsque demande
  4. La commande se terminera silencieusement (aucune sortie signifie succes)

Que fait cette commande ? Cette commande supprime le drapeau de quarantaine que macOS ajoute aux fichiers telecharges. C'est sur et necessaire pour les installateurs PKG non signes.

Cette etape est essentielle ! Sans supprimer l'attribut de quarantaine, l'installateur PKG ne pourra pas s'ouvrir ou s'installer.

Etape 3 : Installer le PKG

Maintenant que vous avez prepare l'installateur, vous pouvez installer Sokuji et son pilote audio virtuel.

Processus d'installation

  1. Localisez le fichier .pkg telecharge dans votre dossier Telechargements (par ex., Sokuji-x.x.x-arm64.pkg ou Sokuji-x.x.x-x64.pkg)
  2. Double-cliquez sur le fichier PKG pour demarrer l'installation
  3. L'installateur macOS s'ouvrira - cliquez sur "Continuer" pour poursuivre
  4. Examinez les details de l'installation et cliquez sur "Installer"
  5. Saisissez votre mot de passe administrateur lorsque demande (requis pour l'installation du pilote)
  6. Attendez que l'installation se termine (generalement 1-2 minutes)
  7. Cliquez sur "Fermer" lorsque l'installation est terminee

Ce qui est installe

  • Sokuji.app - Installe dans /Applications
  • SokujiVirtualAudio.driver - Pilote audio virtuel installe dans /Library/Audio/Plug-Ins/HAL
  • L'installateur redemarrera automatiquement CoreAudio pour charger le pilote
Le mot de passe administrateur est requis car l'installateur doit installer un pilote audio au niveau du systeme. Le pilote audio virtuel active des fonctionnalites avancees de traitement audio.

Etape 4 : Premier lancement

Apres l'installation, vous devrez peut-etre autoriser Sokuji a s'executer car il a ete telecharge en dehors de l'App Store.

Ouvrir Sokuji pour la premiere fois

  1. Accedez a votre dossier Applications
  2. Trouvez Sokuji dans la liste
  3. Faites un clic droit (ou Control-clic) sur Sokuji
  4. Selectionnez "Ouvrir" dans le menu contextuel
  5. Lorsque la boite de dialogue de securite apparait, cliquez sur "Ouvrir" pour confirmer

Remarque : Si vous avez correctement termine l'etape 2, vous ne verrez peut-etre pas d'avertissements de securite.

Methode alternative

Si macOS bloque toujours Sokuji :
  1. Ouvrez Preferences Systeme → Securite et confidentialite
  2. Allez a l'onglet General
  3. Vous devriez voir un message indiquant que Sokuji a ete bloque
  4. Cliquez sur "Ouvrir quand meme"
Cet avertissement de securite n'apparait qu'au premier lancement. Ensuite, vous pouvez ouvrir Sokuji normalement depuis le Launchpad ou les Applications.

Etape 5 : Configurer Sokuji

Maintenant que Sokuji est en cours d'execution, configurons-le pour la premiere utilisation :

Configuration initiale

  1. Accordez les autorisations du microphone lorsque macOS vous le demande
  2. Selectionnez votre langue d'interface preferee
  3. Choisissez votre fournisseur d'IA (OpenAI, Google Gemini, etc.)
  4. Saisissez votre cle API pour le fournisseur selectionne
  5. Selectionnez les langues source et cible pour la traduction
  6. Choisissez vos peripheriques audio (vous devriez voir "Sokuji Virtual Audio" dans la liste)
  7. Testez votre configuration microphone et haut-parleurs
Felicitations ! Sokuji est maintenant pret a l'emploi. Le pilote audio virtuel a ete installe et est disponible dans votre liste de peripheriques audio. Cliquez sur le bouton du microphone pour demarrer la traduction en temps reel.

Depannage

"Le paquet est endommage et ne peut pas etre ouvert" ou le PKG ne s'installe pas

Cela se produit lorsque l'attribut de quarantaine n'a pas ete supprime du fichier PKG :
  1. Ouvrez Terminal (Applications → Utilitaires → Terminal)
  2. Executez : sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-*.pkg
  3. Saisissez votre mot de passe lorsque demande
  4. Reessayez d'installer le PKG
C'est le probleme d'installation le plus courant avec les installateurs PKG non signes.

"Sokuji ne peut pas etre ouvert car il provient d'un developpeur non identifie"

Cela se produit si vous n'avez pas execute la commande xattr avant l'installation :
  1. Faites un clic droit sur l'application Sokuji dans Applications
  2. Selectionnez "Ouvrir" dans le menu
  3. Cliquez sur "Ouvrir" dans la boite de dialogue qui apparait
Vous n'avez besoin de faire cela qu'une seule fois. Meilleure approche : desinstallez et reinstallez apres avoir supprime l'attribut de quarantaine.

Le microphone ne fonctionne pas

Si Sokuji ne peut pas acceder a votre microphone :
  1. Ouvrez Preferences Systeme → Securite et confidentialite → Confidentialite
  2. Selectionnez Microphone dans la barre laterale gauche
  3. Assurez-vous que Sokuji est coche dans la liste
  4. S'il n'est pas dans la liste, redemarrez Sokuji et accordez l'autorisation lorsque demande

Pas de sortie audio

Si vous ne pouvez pas entendre l'audio traduit :
  1. Ouvrez Preferences Systeme → Son → Sortie
  2. Selectionnez votre peripherique de sortie prefere
  3. Verifiez que le volume de sortie n'est pas coupe
  4. Dans Sokuji, verifiez que le bon peripherique de sortie est selectionne

L'application plante sur Mac Intel ou problemes de performances

Assurez-vous d'avoir telecharge le bon installateur pour votre Mac :
  • Apple Silicon (M1/M2/M3/M4) : Utilisez Sokuji-x.x.x-arm64.pkg
  • Intel : Utilisez Sokuji-x.x.x-x64.pkg
  • Verifiez votre type de puce : menu Apple () → "A propos de ce Mac"
  • Si vous avez utilise le mauvais installateur, telechargez la bonne version depuis la page des versions
  • Si les plantages persistent avec le bon installateur, consultez Console.app pour les journaux de plantage et signalez-les sur GitHub

Le pilote audio virtuel n'apparait pas

Si vous ne voyez pas "Sokuji Virtual Audio" dans vos peripheriques audio :
  1. Verifiez si le pilote est installe : ls /Library/Audio/Plug-Ins/HAL/
  2. S'il n'est pas present, vous devrez peut-etre reinstaller Sokuji
  3. S'il est present, essayez de redemarrer CoreAudio : sudo killall coreaudiod
  4. Verifiez Preferences Systeme → Son pour voir si le peripherique apparait

L'installation necessite un mot de passe administrateur

C'est normal et necessaire :
  • L'installateur PKG doit installer un pilote audio au niveau du systeme
  • Les pilotes audio systeme necessitent des privileges d'administrateur pour l'installation
  • Saisissez votre mot de passe lorsque demande - c'est sur et attendu
  • Si vous n'avez pas d'acces administrateur, contactez votre administrateur systeme