Utilisation

Karaoke Mugen est un gestionnaire de karaokés.

Le but est que vous et vos invités ou votre public créiez une liste de lecture (playlist) ensemble et chantiez dessus.

Comment ça marche

Dans les grandes lignes :

  • L'application se construit une base de données avec les karaokés présents dans son dossier de départ (app/repos/* par défaut).
  • Un serveur web se lance sur votre ordinateur : il permet aux visiteurs de s'y connecter et de rechercher dans votre base de données de karaokés, et d'ajouter ceux qu'ils veulent chanter. Deux modes sont disponibles : "privé" et "public". Vos visiteurs doivent être sur votre réseau informatique, généralement en WiFi.
  • L'opérateur, ou le DJ selon comment vous voulez l'appeler, peut gérer le lecteur de vidéos, mettre en pause, modifier la liste de lecture ou changer la configuration du karaoké depuis une interface uniquement accessible à l'aide d'un mot de passe.
  • Le monde devient meilleur !

Nous allons voir comment tout cela se configure pour une première utilisation.

Lancement

En ayant téléchargé le binaire

Double-cliquez sur l'exécutable Karaoke Mugen sous Windows ou macOS et le tour est joué.

En ayant téléchargé les sources

Avec une invite de commande / un terminal, allez dans le dossier de Karoke Mugen et tapez la commande suivante :

yarn start

Initialisation

Voici ce qui devrait s'afficher (plus ou moins) dans une fenêtre.

Initialisation

Le logiciel initialise les différents composants. Notamment, vérifier si vous avez de nouveaux fichiers dans app/repos/* pour mettre à jour sa base de données.

La génération de la base peut être quasi instantanée si vous n'avez pas beaucoup de karaokés. Avec un peu plus de 8000 karaokés, ça peut prendre quelques minutes, mais ce n'est pas une opération que vous ferez très souvent. Selon si la base se trouve sur un SSD, un HDD, ou en réseau va aussi grandement influer sur la rapidité de sa génération.

Une série de questions vous sera posée pour savoir si vous désirez créer un compte local à votre ordinateur ou un compte en ligne qui sera utilisable sur toutes les apps Karaoke Mugen (si vous allez faire un karaoké chez quelqu'un d'autre, ou si vous vous connectez en ligne sur kara.moe par exemple).

Suivez les instructions à l'écran et tout devrait bien se passer.

Screen accueil

Une fois sur l'écran d'acceuil, le logiciel va chercher à mettre à jour ses répertoires app/intros, app/jingles et autres avant d'envoyer ses statistiques (s'il y a une connexion à Internet).

Depuis cette page d'accueil, vous pourrez ensuite lancer le tutoriel, l'interface de gestion ou l'interface publique des utilisateurs (ou afficher ce document d'aide en ligne), mais aussi configurer l'application, télécharger des chansons, consulter les nouveautés et aussi le journal d'évènements.

Base de données

Petite parenthèse sur la base de données :

Karaoke Mugen stocke ses données dans une base de données PostgreSQL se trouvant dans app/db/postgres

La version binaire de Karaoke Mugen inclut un serveur PostgreSQL lancé au démarrage du logiciel donc vous n'avez à vous soucier de rien. Vous pouvez néanmoins utiliser votre propre serveur PostgreSQL si vous le souhaitez en suivant les instructions dans la section configuration.

Lors d'une mise à jour du logiciel, la base de données est mise à jour en conséquence de façon transparente pour vous.

Premiers pas

Une fenêtre devrait également s'ouvrir dans le coin inférieur droit avec un fond d'écran et des indications :

Background

L'adresse indiquée servira à votre public pour se connecter à l'interface de sélection des karaokés. Par défaut il s'agit de https://kara.moe. Seules les personnes sur votre réseau local peuvent participer en allant à cette adresse.

Pour ceux n'étant pas connectés à Internet, votre adresse IP de réseau local sera affichée à la place de kara.moe

Par défaut, Karoke Mugen est configuré en mode PIP : Picture in Picture. Le lecteur vidéo qui va jouer vos karaokés est une petite fenêtre pour vous permettre de le tester et de le déplacer (sur un autre écran, par exemple). Pour l'avoir en plein écran au démarrage, il va falloir configurer l'application.

Ce mode PIP est idéal pour effectuer des tests, ou avoir le karaoké qui se joue en arrière-plan pendant que vous travaillez. Pour le passer en plein écran "manuellement" ou en sortir, vous pouvez :

  • Double-cliquer à l'intérieur
  • Cliquer puis d'appuyer sur la touche F
  • Changer l'option dans le panneau de configuration de l'interface opérateur

Lecteur vidéo

Le lecteur vidéo utilisé est mpv, que vous pouvez trouver sur son site web, mpv.io.

Ce lecteur possède quelques raccourcis clavier utiles :

  • ESC : Quitter le plein écran.
  • Q : Quitter le lecteur (cela ne quitte pas Karaoke Mugen !).
  • Flèche gauche/flèche droite : Avancer/reculer un peu dans la vidéo.
  • Flèche haut/flèche bas : Avancer/reculer beaucoup dans la vidéo.
  • F : Basculer entre le mode plein-écran et fenêtré. Karaoke Mugen laisse le lecteur ouvert entre deux karaokés, ce réglage restera donc ainsi tant que vous ne quittez pas l'application. L'application sera de nouveau fenêtrée au prochain démarrage si vous n'allez pas changer ce paramètre dans la configuration.
  • Molette de souris haut/bas : Changer le volume (en laissant votre curseur dans la fenêtre du lecteur).

Ces touches ne fonctionneront que si vous avez le "focus" sur le lecteur vidéo. Cliquez dans la fenêtre pour obtenir le focus.

Vous pouvez également déplacer la fenêtre à votre guise sur votre écran. Par défaut, elle est toujours au-dessus des autres, mais cela peut être configuré.

Base de karaokés

Télécharger des karaokés

Au premier démarrage, Karaoke Mugen, s'il ne trouve aucun karaoké, va vous demander si vous voulez en télécharger 6 aléatoirement depuis Karaoke Mugen Server

Vous pouvez ensuite télécharger les karaokés de votre choix depuis le panneau système, ou depuis le bouton "Téléchargement" de l'écran d'accueil.

Download

Vous pouvez également télécharger l'intégralité des karaokés mis à votre disposition par la communauté.

Download_All

ATTENTION : Les vidéos prennent au bas mot plusieurs centaines de giga-octets, assurez-vous d'avoir suffisamment d'espace disque disponible.

Vous pouvez quitter Karaoke Mugen à tout moment et reprendre vos téléchargements plus tard.

Ceci dit, vous n'avez peut-être pas envie de récupérer toute la base en entier, mais seulement les karaokés qui vous intéressent. Pour cela, vous avez plusieurs façons de sélectionner ou trier vos choix. Il y a un champ de recherche, bien sûr, mais aussi un filtre de tri sur la droite, qui vous permet de n'afficher que les karaokés ayant une valeur spécifique. Par exemple, si je veux récupérer uniquement les karaokés en breton, il faut aller dans le champ "Filtre des tags" cliquer sur "Langues", puis sur "bre" pour faire apparaître tous les karaokés possibles en breton :

Download_Bre

Une simple recherche sur le terme "breton" fonctionne également.

Une fois que la liste affichée est celle voulue, vous pouvez soit télécharger les chansons de votre choix avec le bouton en bout de ligne, soit télécharger tous les karaokés affichés avec le bouton en haut de la colonne :

Download

Créer votre propre base

Réservé aux utilisateurs avancés.

Pour cela, direction la page sur comment gérer votre base de karaoké, notamment si vous avez déjà des vidéos + fichiers .ass de karaoké à disposition.

Mettre à jour la base de karaokés

  • En utilisant le panneau système, comme indiqué ci-dessus, cliquez simplement sur "Synchroniser" pour récupérer les dernières nouveautés de vos dépôts configurés.
  • Vous pouvez également lancer Karoke Mugen en ligne de commande avec l'option --updateBase.

Dépôts

Les dépôts permettent de séparer les karaokés de la base principale communément appelée "OTAKU". La base OTAKU est ajoutée par défaut à votre logiciel lors de l'installation, mais si d'autres communautés créent des karaokés qu'ils ne veulent pas voir figurer dans la base OTAKU pour une raison ou une autre (des dépôts privés en somme) ils pourront être ajoutés dans votre application pour que vous puissiez vous fournir chez eux !

Interfaces

Karaoke Mugen possède plusieurs interfaces selon ce que vous souhaitez faire.

Vous pouvez passer d'une interface à l'autre depuis le menu "Aller à" de l'application, ou depuis la page d'acceuil.

L'interface publique

Celle-ci est destinée à vos invités/votre public. Cette page leur permet de rechercher des chansons et de voir les playlists. Elle ne permet pas de contrôler le lecteur vidéo ou de configurer le karaoké.

Entrez tout simplement l'adresse indiquée par le fond d'écran du lecteur vidéo !

Vous arriverez alors sur l'interface suivante :

public

L'interface opérateur

Vous pouvez vous y connecter via la fenêtre de l'application.

Sans passer par la fenêtre de l'application, depuis un autre périphérique que votre ordinateur, vous pouvez vous connecter page d'administration via l'adresse http://<votre_ip>:1337/admin.

Vous pouvez facilement depuis l'interface opérateur gérer le lecteur (en haut) et vos différentes listes de lecture. Ici, on a la liste de tous les karaokés à gauche, et la liste de lecture courante à droite.

Essayez d'ajouter des karaokés dans la liste de lecture courante et appuyez sur Play !

admin

Panneau système

Depuis cette interface, vous pourrez :

  • Configurer les sessions de karaoké
  • Afficher les logs
  • Configurer des options avancées
  • Créer et supprimer des utilisateurs
  • Créer ou éditer des karaokés
  • Créer ou éditer des noms de séries et tags (rattachées à des karaokés)
  • Mettre à jour la base de karaokés
  • Télécharger des karaokés
  • et plein d'autres choses !

Fonctionnement

Listes de lecture

Vous pouvez créer autant de listes de lecture que vous voulez. Ces listes peuvent être utiles pour préparer à l'avance des soirées, ou bien pour écouter des chansons selon vos humeurs.

Une liste de lecture peut avoir autant de karaokés que vous le souhaitez, mais (par défaut) un karaoké ne peut pas exister deux fois dans la même liste de lecture.

Une liste de lecture peut avoir plusieurs attributs. La liste crée par défaut possède les attributs publique et courante. Explications :

Liste de lecture publique

Une liste de lecture publique est une liste de suggestions. C'est la liste dans laquelle vos invités enverront leurs chansons.

Une seule liste peut avoir l'attribut publique.

Liste de lecture courante

Une liste de lecture courante est celle utilisée par le lecteur vidéo.

Une seule liste peut avoir l'attribut courante.

Liste à la fois publique et courante

La liste crée par défaut est à la fois publique est courante, ce qui signifie que vos invités pourront ajouter des chansons qui seront directement prises en compte par le lecteur vidéo.

A l'inverse, avoir deux listes différentes, une publique et une courante vous permet de filtrer les suggestions de vos invités avant de les envoyer au lecteur !

Liste noire

Karaoke Mugen propose un système de liste noire (blacklist) fonctionnant par critères.

Les karaokés de cette liste n'apparaîtront plus dans la base de karaokés visible du public. Les opérateurs par contre peuvent toujours les voir.

Vous pouvez directement ajouter des karaokés à la liste noire, mais vous pouvez définir des critères de sélection pour en ajouter automatiquement. Une fois ceux-ci définis, Karaoke Mugen génèrera une liste noire pour vous.

Les critères sont par exemple :

  • Karaoké : Ajoute directement un karaoké précis.
  • Titre contenant : Karaokés dont le titre contient le mot sélectionné (exemple "Gundam").
  • Plus long que/plus court que : Tous les karaokés plus longs ou plus courts que la valeur indiquée, en secondes. Pratique pour bannir les AMVs et autres chansons longues.
  • Tags : Bannir par tag précis (contrairement à bannir si le tag contient tel mot).
  • Chanteur : Bannissement par chanteur.
  • Type : Type de chanson (Opening, Ending, Clip, AMV, etc.).
  • Créateur : Entité créatrice de l'œuvre.
  • Auteur du Kara : Bannir selon l'auteur du karaoké (celui qui a écrit les fichiers permettant de chanter).
  • Langue : Bannir par langue.
  • Divers : Bannir par tag divers (Concert, Jeu vidéo, R18, etc.).
  • Compositeur : Bannir par compositeur.
  • etc.

Quelques idées de choses à bannir : les karaokés plus longs que 4 minutes, ceux ayant le tag Spoiler ou Pour Adultes, etc.

Lors de la génération de la liste noire, tous les karaokés présents dans la liste blanche ne sont pas pris en compte.

Vous pouvez sauvegarder plusieurs collections de critères selon les évènements. Par exemple vous pouvez vouloir bannir les karaokés d'animés de mecha pour punir vos amis, tandis qu'en convention bannir les chansons pour adulte et les chansons trop longues.

Liste blanche

Dans cette liste, vous pouvez ajouter tous les karaokés dont vous voulez empêcher le bannissement même s'ils sont pris en compte dans la liste noire. Par exemple, si vous voulez bannir tous les karaokés de mechas, vous pouvez vouloir garder celui de King Gainer, parce qu'il est cool.

L'ajout d'un karaoké à la liste blanche se fait en l'ajoutant depuis une autre liste (votre liste de favoris par exemple)

Listes de favoris

Chaque utilisateur a sa liste de favoris personnelle dans laquelle il peut retrouver rapidement les pistes qu'il utilise le plus souvent.

Pour ajouter un titre à sa liste de favoris, il faut cliquer sur la clé à molette à gauche d'un karaoké depuis la vue opérateur, ou depuis la vue publique d'abord sélectionner un karaoké pour lui faire afficher les détails et enfin cliquer sur le bouton Favoris.

Les utilisateurs peuvent utiliser leurs pistes de favoris pour suggérer rapidement des titres à l'opérateur.

Listes AutoMix

L'opérateur peut à tout moment créer une liste spéciale composée de tous les favoris des gens présents lors d'une session. Vous pouvez créer une liste AutoMix en appuyant sur le bouton de création de liste.

Vote du public

Envie de laisser le public choisir ses chansons ? Le vote du public s'active dans les options de l'interface opérateur et propose durant les chansons de voter pour la prochaine. L'interface web proposera à vos utilisateurs de voter pour le karaoké qu'ils souhaitent voir ensuite. Les karaokés sont sélectionnés depuis la liste qui a le statut public.

Si aucun karaoké n'est au-dessus des autres, le karaoké à passer sera choisi parmi ceux ayant le meilleur score.

C'est un mode idéal pour ne pas se prendre la tête.

Likes

Lors de la consultation de la liste des chansos, les utilisateurs peuvent like un karaoké demandé afin de le faire remonter pour que l'opérateur voie quels sont les karaokés les plus populaires de sa liste.

Comme chaque utilisateur a un nombre de demandes d'ajout limité lors d'une session, si sa demande (l'opening 1 de Naruto par exemple) est suffisamment likée, elle ne compte plus comme demande et l'utilisateur peut ainsi demander d'autres karaokés supplémentaires ! Ce mécanisme de libération de karaokés est configurable à loisir (combien de likes sont nécessaires, quel pourcentage de la population connectée, etc.).

Les opérateurs peuvent libérer des chansons manuellement via le menu contextuel de chaque karaoké.

Utilisateurs

Chaque utilisateur de Karaoke Mugen a besoin d'un compte, qu'il soit en ligne, ou local.

Les comptes en ligne nécessitent que Karaoke Mugen soit connecté à Internet, et permettent aux gens de sauvegarder leurs favoris, avatar et autres informations pour les retrouvoer sur chaque instance.

Les comptes en ligne se reconnaissent car ils possèdent un @ dans leur nom. Par exemple axel@kara.moe. La deuxième partie fonctionne comme une adresse mail et permet d'identifier sur quel serveur Karaoke Mugen se trouve le compte en ligne.

Si vos utilisateurs ne souhaitent pas créer de compte, il suffit de cliquer sur "Continuer comme invité" pour que le logiciel leur attribue un compte invité.

Les invités ne peuvent pas changer leur nom et n'ont pas de liste de favoris. Ils ne peuvent pas non plus "liker" de suggestion.

Vous pouvez également reconvertir votre compte en ligne en compte local : cela supprimera toute possibilité de se connecter avec sur une autre instance et supprimera votre compte de Karaoke Mugen Server (le kara.moe)

kara.moe est mis à disposition des utilisateurs de Karaoke Mugen, mais vous pouvez ouvrir votre propre serveur Karaoke Mugen pour proposer des comptes en ligne et une URL raccourcie de votre choix (tant que vous possédez le nom de domaine)

Sessions

Les sessions sont des moments de karaoké. Des soirées, des anniversaires, des évènements... Chaque session contient les karaokés joués et demandés durant celles-ci et peuvent vous servir à faire des stats.

Vous pouvez selectionner la session en cours depuis l'écran d'acceuil.

Vous pouvez également modifier les sessions dans le panneau système.

Une session marquée "privée" ne sera pas envoyée sur Karaoke Mugen Server à fins de stats.

Quotas d'ajout de chanson

Dans sa configuration par défaut, Karaoke Mugen permet à chacun d'ajouter 10 000 chansons à la liste de lecture. Cependant, cette limite peut être modifiée (dans les deux sens) par l'administrateur dans les options. Votre quota de chansons est affiché en bas de l'écran.

  • Quand vous ajoutez une chanson, votre quota baisse d'un point.
  • Quand votre chanson passe à l'écran, votre quota remonte d'un point.
  • Si le karaoké est suffisament liké alors il sera "libéré" (délivré) et vous regagnerez un point.
  • Une chanson est libérée automatiquement au bout d'un certain temps si elle n'a pas été jouée.

Dans les options de l'administrateur, le quota peut aussi être basé sur une durée au lieu du nombre de chansons. C'est pratique contre les gens qui ajoutent trop de karaokés super longs.

Restreindre l'interface

Par défaut l'interface publique est ouverte : tout le monde à accès à toutes ses fonctions. Cependant, en fin de karaoké par exemple il peut être intéressant de restreindre voire fermer cette interface pour éviter que les gens n'ajoutent des chansons.

Trois modes sont disponibles :

  • Ouvert : les utilisateurs peuvent ajouter des chansons ou en suggérer
  • Restreint : les utilisateurs peuvent uniquement voir le kara en cours, les informations de ce dernier et la playlist courante
  • Fermé : c'est... fermé. Rien n'est possible côté public.

Ajouts mystère

L'opérateur peut décider si ce que les gens ajoutent est visible ou non dans la playlist. Les chansons invisibles comptent dans la liste mais sont affichés avec un nom configurable (par défaut ???).

Idéal pour faire des surprises à vos invités, ou simplement laisser planer le mystère sur ce qui va passer ensuite.

L'opérateur peut faire en sorte que tous ses ajouts soient considérés comme mystère également.