macOS-Installationsanleitung

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

Fuer macOS herunterladen

Systemanforderungen

macOS 10.15 (Catalina) oder spaeter
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.

Der PKG-Installer ist unsigniert, was bedeutet, dass Sie spezielle Schritte unternehmen muessen, um ihn zu installieren (im naechsten Schritt erklaert).

Schritt 2: Installation vorbereiten

Da der PKG-Installer unsigniert ist, wird macOS ihn standardmaessig blockieren. Sie muessen das Quarantaene-Attribut vor der Installation entfernen.

Quarantaene-Attribut entfernen (erforderlich)

Oeffnen Sie Terminal (Programme → Dienstprogramme → Terminal)
Geben Sie den folgenden Befehl ein oder fuegen Sie ihn ein (ersetzen Sie x.x.x durch Ihre Versionsnummer):

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

Fuer Intel Macs verwenden Sie: sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-x64.pkg
Druecken Sie Enter und geben Sie Ihr Administratorpasswort ein, wenn Sie dazu aufgefordert werden
Der Befehl wird ohne Ausgabe abgeschlossen (keine Ausgabe bedeutet Erfolg)

Was macht das? Dieser Befehl entfernt das Quarantaene-Flag, das macOS heruntergeladenen Dateien hinzufuegt. Es ist sicher und notwendig fuer unsignierte PKG-Installer.

Dieser Schritt ist entscheidend! Ohne Entfernung des Quarantaene-Attributs kann der PKG-Installer nicht geoeffnet oder installiert werden.

Schritt 3: PKG installieren

Nachdem Sie den Installer vorbereitet haben, koennen Sie Sokuji und seinen virtuellen Audiotreiber installieren.

Installationsprozess

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)
Doppelklicken Sie auf die PKG-Datei, um die Installation zu starten
Der macOS-Installer wird geoeffnet - klicken Sie auf "Fortfahren"
Ueberpruefen Sie die Installationsdetails und klicken Sie auf "Installieren"
Geben Sie Ihr Administratorpasswort ein, wenn Sie dazu aufgefordert werden (fuer die Treiberinstallation erforderlich)
Warten Sie, bis die Installation abgeschlossen ist (normalerweise 1-2 Minuten)
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 4: Erster Start

Nach der Installation muessen Sie Sokuji moeglicherweise die Ausfuehrung erlauben, da es ausserhalb des App Store heruntergeladen wurde.

Sokuji zum ersten Mal oeffnen

Navigieren Sie zu Ihrem Programme-Ordner
Finden Sie Sokuji in der Liste
Rechtsklicken (oder Control-Klick) Sie auf Sokuji
Waehlen Sie "Oeffnen" aus dem Kontextmenue
Wenn der Sicherheitsdialog erscheint, klicken Sie auf "Oeffnen" zur Bestaetigung

Hinweis: Wenn Sie Schritt 2 korrekt abgeschlossen haben, sehen Sie moeglicherweise keine Sicherheitswarnungen.

Alternative Methode

Wenn macOS Sokuji weiterhin blockiert:

Oeffnen Sie Systemeinstellungen → Sicherheit & Datenschutz
Gehen Sie zum Tab "Allgemein"
Sie sollten eine Meldung ueber die Blockierung von Sokuji sehen
Klicken Sie auf "Trotzdem oeffnen"

Diese Sicherheitswarnung erscheint nur beim ersten Start. Danach koennen Sie Sokuji normal ueber das Launchpad oder Programme oeffnen.

Schritt 5: Sokuji konfigurieren

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

Ersteinrichtung

Erteilen Sie Mikrofonberechtigungen, wenn macOS Sie dazu auffordert
Waehlen Sie Ihre bevorzugte Oberflaechensprache
Waehlen Sie Ihren KI-Anbieter (OpenAI, Google Gemini usw.)
Geben Sie Ihren API-Schluessel fuer den ausgewaehlten Anbieter ein
Waehlen Sie Quell- und Zielsprache fuer die Uebersetzung
Waehlen Sie Ihre Audiogeraete (Sie sollten "Sokuji Virtual Audio" in der Liste sehen)
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

"Das Paket ist beschaedigt und kann nicht geoeffnet werden" oder PKG wird nicht installiert

Dies passiert, wenn das Quarantaene-Attribut nicht von der PKG-Datei entfernt wurde:

Oeffnen Sie Terminal (Programme → Dienstprogramme → Terminal)
Fuehren Sie aus: sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-*.pkg
Geben Sie Ihr Passwort ein, wenn Sie dazu aufgefordert werden
Versuchen Sie die PKG-Installation erneut

Dies ist das haeufigste Installationsproblem bei unsignierten PKG-Installern.

"Sokuji kann nicht geoeffnet werden, da es von einem nicht identifizierten Entwickler stammt"

Dies passiert, wenn Sie den xattr-Befehl nicht vor der Installation ausgefuehrt haben:

Rechtsklicken Sie auf die Sokuji-App in Programme
Waehlen Sie "Oeffnen" aus dem Menue
Klicken Sie im erscheinenden Dialog auf "Oeffnen"

Sie muessen dies nur einmal tun. Besserer Ansatz: Deinstallieren und nach Entfernung des Quarantaene-Attributs neu installieren.

Mikrofon funktioniert nicht

Wenn Sokuji nicht auf Ihr Mikrofon zugreifen kann:

Oeffnen Sie Systemeinstellungen → Sicherheit & Datenschutz → Datenschutz
Waehlen Sie Mikrofon in der linken Seitenleiste
Stellen Sie sicher, dass Sokuji in der Liste aktiviert ist
Wenn nicht aufgelistet, starten Sie Sokuji neu und erteilen Sie die Berechtigung bei Aufforderung

Keine Audioausgabe

Wenn Sie den uebersetzten Ton nicht hoeren koennen:

Oeffnen Sie Systemeinstellungen → Ton → Ausgabe
Waehlen Sie Ihr bevorzugtes Ausgabegeraet
Pruefen Sie, ob die Ausgabelautstaerke nicht stummgeschaltet ist
Ueberpruefen Sie in Sokuji, ob das richtige Ausgabegeraet ausgewaehlt ist

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 "Sokuji Virtual Audio" nicht in Ihren Audiogeraeten sehen:

Pruefen Sie, ob der Treiber installiert ist: ls /Library/Audio/Plug-Ins/HAL/
Wenn nicht vorhanden, muessen Sie Sokuji moeglicherweise neu installieren
Wenn vorhanden, versuchen Sie CoreAudio neu zu starten: sudo killall coreaudiod
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