1  ### 1. Das Programm meldet "Konfigurationsdatei nicht gefunden" oder "xxxxx erfordert die Konfiguration des xxxxx API-Schlüssels." Wie kann ich das beheben?
  2  
  3  Dies ist ein häufiges Einrichtungsproblem. Es gibt einige Gründe, warum dies passieren könnte:
  4  
  5  1. **Falscher Dateipfad oder Name:**
  6  
  7  * Das Programm benötigt eine Konfigurationsdatei mit dem genauen Namen `config.toml`. Stellen Sie sicher, dass Sie sie nicht versehentlich `config.toml.txt` genannt haben.
  8  * Diese Datei muss sich in einem `config`-Ordner befinden. Die korrekte Struktur des Arbeitsverzeichnisses sollte wie folgt aussehen:
  9    ```
 10    /── config/
 11    │   └── config.toml
 12    └── krillinai.exe (Ihre ausführbare Datei)
 13    ```
 14  * **Für Windows-Benutzer:** Es wird empfohlen, das gesamte Softwareverzeichnis in einen Ordner zu legen, der sich nicht auf dem C:-Laufwerk befindet, um mögliche Berechtigungsprobleme zu vermeiden.
 15  
 16  2. **Unvollständige API-Schlüssel-Konfiguration:**
 17  
 18  * Die Anwendung benötigt separate Konfigurationen für das große Sprachmodell (für Übersetzungen), den Sprachdienst (für Transkription und Sprachsynthese) und den TTS-Dienst.
 19  * Selbst wenn Sie OpenAI für alles verwenden, müssen Sie den Schlüssel in verschiedenen Abschnitten der `config.toml`-Datei ausfüllen. Suchen Sie nach dem Abschnitt `llm`, dem Abschnitt `transcribe`, dem Abschnitt `tts` und fügen Sie die entsprechenden API-Schlüssel und andere erforderliche Informationen ein.
 20  
 21  ### 2. Ich erhalte einen Fehler, der "yt-dlp error" enthält. Was soll ich tun?
 22  
 23  Dieser Fehler weist auf ein Problem mit dem Video-Downloader hin, das normalerweise mit Ihrem Netzwerk oder der Version des Downloaders zusammenhängt.
 24  
 25  * **Netzwerk:** Wenn Sie einen Proxy verwenden, stellen Sie sicher, dass er in den Proxy-Einstellungen in Ihrer `config.toml`-Datei korrekt konfiguriert ist.
 26  * **Aktualisieren Sie `yt-dlp`:** Die mit der Software gebündelte Version von `yt-dlp` könnte veraltet sein. Sie können sie manuell aktualisieren, indem Sie ein Terminal im `bin`-Verzeichnis der Software öffnen und den Befehl ausführen:
 27    ```
 28    ./yt-dlp.exe -U
 29    ```
 30    
 31    (Ersetzen Sie `yt-dlp.exe` durch den korrekten Dateinamen für Ihr Betriebssystem, falls er abweicht).
 32  
 33  ### 3. Die Untertitel im endgültigen Video sind unleserlich oder erscheinen als quadratische Blöcke, insbesondere unter Linux.
 34  
 35  Dies wird fast immer durch fehlende Schriftarten im System verursacht, insbesondere solche, die chinesische Zeichen unterstützen. Um dies zu beheben, müssen Sie die erforderlichen Schriftarten installieren.
 36  
 37  1. Laden Sie die benötigten Schriftarten herunter, wie [Microsoft YaHei](https://modelscope.cn/models/Maranello/KrillinAI_dependency_cn/resolve/master/%E5%AD%97%E4%BD%93/msyh.ttc) und [Microsoft YaHei Bold](https://modelscope.cn/models/Maranello/KrillinAI_dependency_cn/resolve/master/%E5%AD%97%E4%BD%93/msyhbd.ttc).
 38  2. Erstellen Sie ein neues Schriftartenverzeichnis: `sudo mkdir -p /usr/share/fonts/msyh`.
 39  3. Kopieren Sie die heruntergeladenen `.ttc`-Schriftartdateien in dieses neue Verzeichnis.
 40  4. Führen Sie die folgenden Befehle aus, um den Schriftarten-Cache neu zu erstellen:
 41      ```
 42      cd /usr/share/fonts/msyh
 43      sudo mkfontscale
 44      sudo mkfontdir
 45      sudo fc-cache -fv
 46      ```
 47  
 48  ### 4. Unter macOS startet die Anwendung nicht und zeigt einen Fehler wie "KrillinAI ist beschädigt und kann nicht geöffnet werden."
 49  
 50  Dies wird durch die Sicherheitsfunktion von macOS, Gatekeeper, verursacht, die Apps von nicht identifizierten Entwicklern einschränkt. Um dies zu beheben, müssen Sie manuell das Quarantäne-Attribut entfernen.
 51  
 52  1. Öffnen Sie die **Terminal**-App.
 53  2. Geben Sie den Befehl `xattr -cr` gefolgt von einem Leerzeichen ein, und ziehen Sie dann die Datei `KrillinAI.app` aus Ihrem Finder-Fenster in das Terminal. Der Befehl sieht dann etwa so aus:
 54      ```
 55      xattr -cr /Applications/KrillinAI.app
 56      ```
 57  3. Drücken Sie die Eingabetaste. Sie sollten nun in der Lage sein, die Anwendung zu öffnen.
 58  
 59  ### 5. Ich erhalte Fehler wie `ffmpeg error`, `audioToSrt error` oder `exit status 1` während der Verarbeitung.
 60  
 61  Diese Fehler weisen normalerweise auf Probleme mit Abhängigkeiten oder Systemressourcen hin.
 62  
 63  * **`ffmpeg error`:** Dies deutet darauf hin, dass `ffmpeg` entweder nicht installiert oder nicht im System-Pfad zugänglich ist. Stellen Sie sicher, dass Sie eine vollständige, offizielle Version von `ffmpeg` installiert haben und dass ihr Speicherort zu den Umgebungsvariablen Ihres Systems hinzugefügt wurde.
 64  * **`audioToSrt error` oder `exit status 1`:** Dieser Fehler tritt während der Transkriptionsphase (Audio-zu-Text) auf. Die häufigsten Ursachen sind:
 65    * **Modellprobleme:** Das lokale Transkriptionsmodell (z. B. `fasterwhisper`) konnte nicht geladen werden oder war während des Downloads beschädigt.
 66    * **Unzureichender Speicher (RAM):** Das Ausführen lokaler Modelle ist ressourcenintensiv. Wenn Ihr Computer nicht genügend Speicher hat, kann das Betriebssystem den Prozess beenden, was zu einem Fehler führt.
 67    * **Netzwerkausfall:** Wenn Sie einen Online-Transkriptionsdienst (wie die Whisper-API von OpenAI) verwenden, deutet dies auf ein Problem mit Ihrer Netzwerkverbindung oder einen ungültigen API-Schlüssel hin.
 68  
 69  ### 6. Der Fortschrittsbalken bewegt sich nicht. Ist das Programm eingefroren?
 70  
 71  Nein, solange Sie keine Fehlermeldung sehen, arbeitet das Programm. Der Fortschrittsbalken wird nur nach Abschluss einer größeren Aufgabe (wie Transkription oder Video-Encoding) aktualisiert. Diese Aufgaben können sehr zeitaufwendig sein, was dazu führen kann, dass der Fortschrittsbalken für längere Zeit pausiert. Bitte haben Sie Geduld und warten Sie, bis die Aufgabe abgeschlossen ist.
 72  
 73  ### 7. Meine NVIDIA 5000-Serie GPU wird von `fasterwhisper` nicht unterstützt. Was soll ich tun?
 74  
 75  Es wurde beobachtet, dass das `fasterwhisper`-Modell möglicherweise nicht korrekt mit NVIDIA 5000-Serie GPUs funktioniert (Stand Mitte 2025). Sie haben einige Alternativen für die Transkription:
 76  
 77  1. **Verwenden Sie ein cloudbasiertes Modell:** Setzen Sie `transcribe.provider.name` in Ihrer `config.toml`-Datei auf `openai` oder `aliyun`. Füllen Sie dann den entsprechenden API-Schlüssel und die Konfigurationsdetails aus. Dies verwendet das Whisper-Modell des Cloud-Anbieters anstelle des lokalen.
 78  2. **Verwenden Sie ein anderes lokales Modell:** Sie können mit anderen lokalen Transkriptionsmodellen experimentieren, wie dem ursprünglichen `whisper.cpp`.
 79  
 80  ### 8. Wie finde und fülle ich den richtigen Sprach-/Toncode für die Sprachsynthese aus?
 81  
 82  Die verfügbaren Stimmen und ihre entsprechenden Codes werden vom Sprachdienstanbieter definiert, den Sie verwenden. Bitte beziehen Sie sich auf deren offizielle Dokumentation.
 83  
 84  * **OpenAI TTS:** [Dokumentation](https://platform.openai.com/docs/guides/text-to-speech/api-reference) (siehe die `voice`-Optionen).
 85  * **Alibaba Cloud:** [Dokumentation](https://help.aliyun.com/zh/isi/developer-reference/overview-of-speech-synthesis) (siehe den `voice`-Parameter in der Tonliste).
 86  
 87  ### 9. Wie kann ich ein lokales großes Sprachmodell (LLM), wie eines, das auf Ollama läuft, für Übersetzungen verwenden?
 88  
 89  Ja, Sie können KrillinAI so konfigurieren, dass es jedes lokale LLM verwendet, das einen OpenAI-kompatiblen API-Endpunkt bereitstellt.
 90  
 91  1. **Starten Sie Ihr lokales LLM:** Stellen Sie sicher, dass Ihr lokaler Dienst (z. B. Ollama, das Llama3 ausführt) aktiv und zugänglich ist.
 92  2. **Bearbeiten Sie `config.toml`:** Im Abschnitt für das große Sprachmodell (Übersetzer):
 93  
 94  * Setzen Sie den Anbieter `name` (oder `type`) auf `"openai"`.
 95  * Setzen Sie den `api_key` auf einen beliebigen zufälligen String (z. B. `"ollama"`), da er für lokale Aufrufe nicht benötigt wird.
 96  * Setzen Sie die `base_url` auf den API-Endpunkt Ihres lokalen Modells. Für Ollama ist dies typischerweise `http://localhost:11434/v1`.
 97  * Setzen Sie das `model` auf den Namen des Modells, das Sie bereitstellen, zum Beispiel `"llama3"`.
 98  
 99  ### 10. Kann ich den Untertitelstil (Schriftart, Größe, Farbe) im endgültigen Video anpassen?
100  
101  Nein. Derzeit generiert KrillinAI **hardcodierte Untertitel**, was bedeutet, dass sie direkt in die Videorahmen eingebrannt werden. Die Anwendung **bietet keine Optionen zur Anpassung des Untertitelstils**; sie verwendet einen vordefinierten Stil.
102  
103  Für eine erweiterte Anpassung ist der empfohlene Workaround:
104  
105  1. Verwenden Sie KrillinAI, um die übersetzte `.srt`-Untertiteldatei zu generieren.
106  2. Importieren Sie Ihr Originalvideo und diese `.srt`-Datei in einen professionellen Video-Editor (z. B. Premiere Pro, Final Cut Pro, DaVinci Resolve), um benutzerdefinierte Stile vor dem Rendern anzuwenden.
107  
108  ### 11. Ich habe bereits eine übersetzte `.srt`-Datei. Kann KrillinAI sie verwenden, um nur das Synchronisieren durchzuführen?
109  
110  Nein, diese Funktion wird derzeit nicht unterstützt. Die Anwendung führt eine vollständige Pipeline von der Transkription bis zur endgültigen Videoerstellung aus.