← Zurueck zur Dokumentation

macOS-Installationsanleitung

Diese Anleitung fuehrt Sie durch die Installation von Sokuji auf macOS-Systemen. Sokuji ist als signierter und notarisierter .pkg-Installer verfuegbar, der einen virtuellen Audiotreiber fuer erweiterte Audioverarbeitungsfunktionen enthaelt.

Fuer macOS herunterladen

Systemanforderungen

  • macOS 13 (Ventura) oder spaeter (seit v0.42.2; unter macOS 12 weiterhin v0.42.1 verwenden)
  • Apple Silicon (M1/M2/M3/M4) oder Intel (x86_64) Prozessor
  • Mindestens 4 GB RAM (8 GB empfohlen)
  • 200 MB verfuegbarer Festplattenspeicher
  • Administratorrechte (fuer die Installation des virtuellen Audiotreibers erforderlich)
  • Internetverbindung fuer KI-Uebersetzungsdienste
  • Mikrofon und Lautsprecher/Kopfhoerer

Installationsschritte

Schritt 1: Sokuji herunterladen

Besuchen Sie die offizielle GitHub-Releases-Seite, um die neueste Version von Sokuji fuer macOS herunterzuladen.

PKG-Installer herunterladen

  • Sokuji-x.x.x-arm64.pkg - Fuer Apple Silicon Macs (M1/M2/M3/M4)
  • Sokuji-x.x.x-x64.pkg - Fuer Intel Macs
  • Jeder Installer enthaelt die Sokuji-App und den virtuellen Audiotreiber
  • Die Dateigroesse betraegt etwa 150-200 MB

Tipp: Nicht sicher, welchen Sie herunterladen sollen? Klicken Sie auf das Apple-Menue () → "Ueber diesen Mac", um Ihren Chiptyp zu ueberpruefen. Wenn Sie "Apple M1/M2/M3/M4" sehen, waehlen Sie die arm64-Version. Wenn Sie "Intel" sehen, waehlen Sie die x64-Version.

Seit Version 0.46.5 ist der PKG-Installer signiert und notarisiert, macOS öffnet ihn also ohne zusätzliche Schritte.

Schritt 2: PKG installieren

Installieren Sie Sokuji und seinen virtuellen Audiotreiber.

Installationsprozess

  1. Suchen Sie die heruntergeladene .pkg-Datei in Ihrem Downloads-Ordner (z.B. Sokuji-x.x.x-arm64.pkg oder Sokuji-x.x.x-x64.pkg)
  2. Doppelklicken Sie auf die PKG-Datei, um die Installation zu starten
  3. Der macOS-Installer wird geoeffnet - klicken Sie auf "Fortfahren"
  4. Ueberpruefen Sie die Installationsdetails und klicken Sie auf "Installieren"
  5. Geben Sie Ihr Administratorpasswort ein, wenn Sie dazu aufgefordert werden (fuer die Treiberinstallation erforderlich)
  6. Warten Sie, bis die Installation abgeschlossen ist (normalerweise 1-2 Minuten)
  7. Klicken Sie auf "Schliessen", wenn die Installation abgeschlossen ist

Was installiert wird

  • Sokuji.app - Wird in /Applications installiert
  • SokujiVirtualAudio.driver - Virtueller Audiotreiber, installiert in /Library/Audio/Plug-Ins/HAL
  • Der Installer startet CoreAudio automatisch neu, um den Treiber zu laden
Das Administratorpasswort ist erforderlich, da der Installer einen Audiotreiber auf Systemebene installieren muss. Der virtuelle Audiotreiber ermoeglicht erweiterte Audioverarbeitungsfunktionen.

Schritt 3: Erster Start

Öffnen Sie Sokuji aus dem Ordner „Programme“. Zusätzliche Sicherheitsschritte sind nicht nötig.

Schritt 4: Sokuji konfigurieren

Nachdem Sokuji laeuft, konfigurieren wir es fuer die erste Verwendung:

Ersteinrichtung

  1. Erteilen Sie Mikrofonberechtigungen, wenn macOS Sie dazu auffordert
  2. Waehlen Sie Ihre bevorzugte Oberflaechensprache
  3. Waehlen Sie Ihren KI-Anbieter (OpenAI, Google Gemini usw.)
  4. Geben Sie Ihren API-Schluessel fuer den ausgewaehlten Anbieter ein
  5. Waehlen Sie Quell- und Zielsprache fuer die Uebersetzung
  6. Wählen Sie Ihr Mikrofon, und wählen Sie im Block Sprache Ihre Lautsprecher oder Kopfhörer als Standard-Wiedergabegerät. Sokuji führt dort sein eigenes virtuelles Audiogerät nicht auf: Übersetzung, die das Gegenüber hört schickt Ihre Übersetzung hinein, es ist das virtuelle Mikrofon, das Sie in Ihrer Meeting-App wählen
  7. Testen Sie Ihre Mikrofon- und Lautsprechereinrichtung
Herzlichen Glueckwunsch! Sokuji ist jetzt einsatzbereit. Der virtuelle Audiotreiber wurde installiert und ist in Ihrer Audiogeraete-Liste verfuegbar. Klicken Sie auf die Mikrofon-Schaltflaeche, um die Echtzeit-Uebersetzung zu starten.

Fehlerbehebung

Mikrofon funktioniert nicht

Wenn Sokuji nicht auf Ihr Mikrofon zugreifen kann:
  1. Oeffnen Sie Systemeinstellungen → Sicherheit & Datenschutz → Datenschutz
  2. Waehlen Sie Mikrofon in der linken Seitenleiste
  3. Stellen Sie sicher, dass Sokuji in der Liste aktiviert ist
  4. Wenn nicht aufgelistet, starten Sie Sokuji neu und erteilen Sie die Berechtigung bei Aufforderung

Keine Audioausgabe

Wenn Sie den uebersetzten Ton nicht hoeren koennen:
  1. Oeffnen Sie Systemeinstellungen → Ton → Ausgabe
  2. Waehlen Sie Ihr bevorzugtes Ausgabegeraet
  3. Pruefen Sie, ob die Ausgabelautstaerke nicht stummgeschaltet ist
  4. Prüfen Sie im Block Sprache in Sokuji das Gerät der Zeile, die Sie hören möchten: Ich höre es auch für Ihre eigene Übersetzung (standardmäßig aus), Übersetzung, die ich höre für die des Gegenübers und Standard-Wiedergabegerät für alles andere

App stuerzt auf Intel Macs ab oder Leistungsprobleme

Stellen Sie sicher, dass Sie den richtigen Installer fuer Ihren Mac heruntergeladen haben:
  • Apple Silicon (M1/M2/M3/M4): Verwenden Sie Sokuji-x.x.x-arm64.pkg
  • Intel: Verwenden Sie Sokuji-x.x.x-x64.pkg
  • Pruefen Sie Ihren Chiptyp: Apple-Menue () → "Ueber diesen Mac"
  • Wenn Sie den falschen Installer verwendet haben, laden Sie die richtige Version von der Releases-Seite herunter
  • Wenn Abstuerze mit dem richtigen Installer anhalten, ueberpruefen Sie Console.app auf Absturzprotokolle und melden Sie diese auf GitHub

Virtueller Audiotreiber wird nicht angezeigt

Wenn Sie "SokujiVirtualAudio" nicht in Ihren Audiogeraeten sehen:
  1. Lassen Sie es zuerst von Sokuji reparieren: Ist der Treiber installiert, aber von macOS nicht geladen, meldet Sokuji das beim Start und bietet Reparieren an. Geben Sie Ihr Administratorpasswort ein; Sokuji startet Core Audio neu, um den Treiber zu laden, ohne dass Sokuji neu gestartet werden muss
  2. Pruefen Sie, ob der Treiber installiert ist: ls /Library/Audio/Plug-Ins/HAL/
  3. Wenn nicht vorhanden, muessen Sie Sokuji moeglicherweise neu installieren
  4. Wenn vorhanden und Reparieren nicht geholfen hat, versuchen Sie CoreAudio neu zu starten: sudo killall coreaudiod, oder starten Sie den Mac neu
  5. Pruefen Sie Systemeinstellungen → Ton, ob das Geraet erscheint

Installation erfordert Administratorpasswort

Dies ist normal und erforderlich:
  • Der PKG-Installer muss einen Audiotreiber auf Systemebene installieren
  • System-Audiotreiber erfordern Administratorrechte fuer die Installation
  • Geben Sie Ihr Passwort ein, wenn Sie dazu aufgefordert werden - dies ist sicher und erwartet
  • Wenn Sie keinen Administratorzugang haben, wenden Sie sich an Ihren Systemadministrator