Prérequis
- Accès à MediaCP
Ce guide vous aide à diagnostiquer et résoudre les problèmes courants avec votre webradio. Avant de contacter le support, essayez ces solutions.
Le flux ne démarre pas
- Vérifiez que l'AutoDJ est activé et qu'il y a des playlists avec du contenu
- Assurez-vous qu'il y a des fichiers audio valides dans la bibliothèque
- Vérifiez que le service est actif dans votre espace client WHMCS
- Redémarrez le serveur depuis MediaCP → Configuration → Redémarrer
Impossible de se connecter en direct
- Vérifiez l'adresse du serveur, le port et le mot de passe source
- Pour Icecast, assurez-vous que le point de montage commence par /
- Vérifiez que le port n'est pas bloqué par votre pare-feu
- Testez avec un autre logiciel de diffusion (BUTT est recommandé pour les tests)
- Assurez-vous qu'aucune autre source n'est déjà connectée
Connection refused : Mauvais serveur/port ou service arrêté
Authentication failed : Mot de passe incorrect
Mount point in use : Une source est déjà connectée
Codec not supported : Format audio non supportéLes auditeurs ne peuvent pas écouter
- Vérifiez que le flux est actif (AutoDJ ou source en direct connectée)
- Testez l'URL d'écoute dans VLC ou un navigateur
- Vérifiez que vous n'avez pas dépassé la limite d'auditeurs
- Assurez-vous que le flux est en mode 'Public'
- Essayez une URL alternative (fichier .m3u ou .pls)
Test rapide
Pour tester votre flux, ouvrez VLC → Média → Ouvrir un flux réseau → Collez votre URL d'écoute.
Qualité audio médiocre
- Vérifiez le bitrate de vos fichiers source (minimum 128 kbps recommandé)
- Assurez-vous que le bitrate du flux correspond à vos fichiers
- Évitez d'uploader des fichiers déjà encodés à bas bitrate
- Pour le live : vérifiez votre connexion Internet et les paramètres de l'encodeur
Coupures et interruptions du flux
- Vérifiez votre connexion Internet (pour la diffusion en direct)
- Augmentez le buffer dans les paramètres de l'encodeur
- Assurez-vous que votre bande passante n'est pas épuisée
- Vérifiez les logs dans MediaCP pour identifier les erreurs
L'AutoDJ ne reprend pas après le live
- Vérifiez que l'AutoDJ est activé dans les paramètres
- Assurez-vous qu'il y a une playlist par défaut configurée
- Vérifiez que la playlist contient des morceaux valides
- Déconnectez proprement votre source live
- Si le problème persiste, redémarrez le serveur
Les métadonnées ne s'affichent pas
- Vérifiez que vos fichiers MP3 ont des tags ID3 valides
- Lancez un rescan de la bibliothèque après modification
- Pour le live : configurez l'envoi des métadonnées dans votre encodeur
- Attendez quelques secondes, la mise à jour peut prendre du temps
Impossible d'uploader des fichiers
- Vérifiez que vous n'avez pas dépassé votre quota d'espace disque
- Assurez-vous que le fichier est dans un format supporté (MP3, AAC, OGG, FLAC)
- Pour les gros fichiers, utilisez FTP plutôt que l'interface web
- Vérifiez que le fichier n'est pas corrompu
Consulter les logs
- Allez dans 'Configuration' → 'Logs' ou 'Journaux'
- Consultez les logs du serveur pour identifier les erreurs
- Notez les messages d'erreur pour le support technique
Redémarrer le serveur
En cas de problème persistant, un redémarrage peut résoudre de nombreux soucis :
- Allez dans 'Configuration' → 'Actions du serveur'
- Cliquez sur 'Redémarrer le serveur'
- Attendez 30 secondes à 1 minute
- Vérifiez que le service est revenu en ligne
Interruption
Le redémarrage déconnectera temporairement tous les auditeurs et les sources en direct.
Contacter le support
Si le problème persiste après ces vérifications :
- Notez les étapes que vous avez déjà essayées
- Copiez les messages d'erreur des logs
- Ouvrez un ticket depuis votre espace client WHMCS
- Décrivez le problème en détail avec les heures où il se produit