Troubleshooting

Troubleshooting — Dépannage

🇬🇧 English · 🇫🇷 Français

---

🇬🇧 English

FFmpeg Not Found

Symptom: "FFmpeg not found" on launch or during encoding.

Fix:

1. Options tab → Update FFmpeg → choose an installation method
2. Or manually enter the full path to ffmpeg.exe
3. Click Test to verify

"Format not found" or "Invalid data"

Cause: FFmpeg doesn't have enough data to detect the file format.

Fix: In Advanced Parameters, increase:

• Analyze Duration: 80M → 200M
• Probe Size: 60M → 100M

soxr Error

Symptom: Option resampler not found or soxr-related error.

Cause: Your FFmpeg build is "Essentials" (no soxr).

Fix: In Advanced Parameters, change Resampler to swr. Or install the Full version of FFmpeg.

WAV Conversion Timeout

Symptom: WAV Timeout after Xs — reduce parallel file count.

Cause: Very long or large file (Blu-ray PCM), disk I/O saturated.

Fix:

• Reduce CPU Cores to 2-4 in Options
• Disable Parallel Processing for sequential encoding

App Won't Start

Check pyaudiocodingtools_crash.log next to the exe. It contains the full error message and system info.

Interrupted Batch Detected on Startup

The app found an incomplete encoding session.

• Yes → Resume automatically from where it stopped
• No → Delete the saved state, start fresh
• Cancel → Ignore for this session (asked again next time)

---

🇫🇷 Français

FFmpeg introuvable

Symptôme : "FFmpeg introuvable" au lancement ou à l'encodage.

Solution :

1. Onglet Options → Mise à jour FFmpeg → choisissez une méthode d'installation
2. Ou saisissez manuellement le chemin complet vers ffmpeg.exe
3. Cliquez Test pour vérifier

Erreur "Format not found" ou "Invalid data"

Cause : FFmpeg n'a pas assez de données pour détecter le format du fichier.

Solution : Dans les Paramètres avancés, augmentez :

• Durée d'analyse : 80M → 200M
• Taille de sonde : 60M → 100M

Erreur avec soxr

Symptôme : Option resampler not found ou erreur liée à soxr.

Cause : Build FFmpeg "Essentials" (sans soxr).

Solution : Dans les Paramètres avancés, changez Resampler sur swr. Ou installez la version Full de FFmpeg.

Timeout pendant la conversion WAV

Symptôme : Timeout WAV après Xs — réduisez le nombre de fichiers parallèles.

Cause : Fichier très long ou très gros (PCM Blu-ray), I/O disque saturés.

Solution :

• Réduisez les Cœurs CPU à 2-4 dans l'onglet Options
• Désactivez le Traitement parallèle pour un traitement séquentiel

L'application ne démarre pas

Consultez pyaudiocodingtools_crash.log créé à côté de l'exe. Il contient le message d'erreur complet et les infos système.

Un batch interrompu est proposé au démarrage

L'application a détecté une session d'encodage incomplète.

• Oui → Reprend les fichiers non traités automatiquement
• Non → Supprime la sauvegarde, repart à zéro
• Annuler → Ignore pour cette session