Problèmes récurrents

Les .kara.json

Les outils

Les fichiers .kara.json doivent être tous créés et remplis automagiquement par le formulaire dans l'interface de gestion

La génération de données par Karaoke Mugen

Au cas où vous modifieriez des fichiers médias ou de paroles, vous pouvez faire modifier les .kara.json correspondant de plusieurs façons :

  • Depuis la page d'un karaoke du panneau système : Glissez-déplacez un fichier média ou de paroles dans les zones prévues puis cliquez sur Sauvegarder pour que Karaoke Mugen génère et ermplace le fichier .kara.json
  • Au lancement de Karaoke Mugen avec l'option --validate ce dernier va vérifier que vos fichiers n'ont pas changé. S'ils ont changé, ils seront mis à jour et Karaoke Mugen s'arrêtera
  • Depuis l'interface de gestion système : dans l'onglet Database cliquez sur Valider

Erreurs récurrentes

Fichier vidéo introuvable alors qu'il est bien là

Vérifiez sur le FTP que le fichier est bien nommé comme dans le .kara.json. Attention aux majuscules et minuscules ! Windows étant insensible à la casse, ça passera, mais pas sous Linux où se trouve le Lab de Shelter. Vérifiez bien que les majuscules et minuscules sont bonnes.

L'autre possibilité est un caractère parasite invisible, un double espace ou autre. Dans le doute, copiez-collez le nom du fichier à partir du .kara.json lorsque vous renommez le fichier média.

Les .ass

Votre synchronisation est décalée

Voyez la section décalage temporel du guide avancé d'Aegisub

Les médias

Les outils

Pour faire de l'encodage vidéo, de multiples outils existent.

  • Handbrake est le plus simple d'utilisation, avec une interface relativement lisible et des options par défaut correctes.
  • MediaCoder est un peu plus brouillon mais regorge d'options supplémentaires : comme la possibilité de garder certains flux et réencoder d'autres. Attention, il s'agit d'un freemium : certaines options ne sont accessibles que via la version payante du logiciel,
  • MeGUI est beaucoup plus complexe d'utilisation mais optimise les encodages.
  • FFMPEG est utilisable en ligne de commande, ce qui le rend très puissant mais long à maîtriser.
  • ShotCut permet de couper à la frame près et embarque FFMPEG, ce qui fait que vos exportations seront au poil et peu lourdes.

Erreurs récurrentes

Métadonnées faussées

Il est déjà arrivé que des vidéos aient une métadonnée "duration" complètement fausses par rapport à la réalité. Si cela arrive, il est possible de régler le problème en recapsulant les flux vidéo et audio concernés dans un container MP4, en utilisant ffmpeg et la ligne de commande suivante (voir la section dédiée) :

./ffmpeg -i video_source.mp4 -vcodec copy -acodec copy video_destination.mp4

Paroles "écrasées" sur Karaoke Mugen

Si vous voyez que les paroles en haut de l'écran ont l'air écrasées par rapport à d'autres karaokés, c'est que votre vidéo a un mauvais ratio d'indiqué dans ses métadonnées. Cela se corrige avec ffmpeg. Venez nous en parler sur Discord.

Vidéos beaucoup trop lourdes

Il faudra se servir des outils cités en première partie de cette page pour faire respecter la règle liant résolution et bitrate. Il faut de toutes façons passer par un réencodage.

Pour rappel, voici le format vidéo attendu et le tableau de ratio poids / taille des vidéos :

  • Conteneur : MP4
  • Codec vidéo : h264 8bit
  • Codec audio : AAC

Ce tableau est à titre indicatif : pour une résolution de vidéo donnée vous devriez utiliser le paramètre de Bitrate maximum indiqué ci-dessous pour ainsi obtenir une taille de vidéo acceptable.

La base de karaokés contenant plusieurs milliers de fichiers vidéo, il est important de faire des économies là où c'est possible. Hors de question d'avoir des fichiers de 300 Mo pour 1 minute 30 par exemple.

Résolution vidéo (axe Y) Bitrate maximum Poids fichier approximatif, pour 1 min 30
4K 10000 kb/s 100Mo
1080p 8000 kb/s 80Mo
720p 4000 kb/s 40Mo
480p 3000 kb/s 30Mo
360p 2000 kb/s 20Mo