Fonctionnement général

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 :

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

Base de karaokés

Avant toute chose, il vous faudra une base de karaokés. Vous avez plusieurs choix :

Créer votre propre base

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.

Utilisez les samples fournis

Une série de 6 karaokés (en vrai on a triché, y'en a que 3 différents) est fournie avec Karaoke Mugen pour l'exemple.

Ils se trouvent dans le dossier samples

Par défaut, Karaoke Mugen va chercher à intégrer tous les karaokés qu'il trouvera dans le dossier app/data. S'il ne trouve rien, alors il utilisera ce dossier samples pour les intégrer dans ses données. De cette façon, vous pourrez sommairement tester l'application.

Récupérer une base existante

Pour la plupart des utilisateurs, c'est la première étape à suivre pour avoir un logiciel utilisable immédiatement sans se poser de question. Vous allez récupérer la base de karaokés existante et Karaoke Mugen va se charger de l'intégrer dans ses données.

Vous pouvez installer la base complète de plusieurs façons :

Via le panneau de contrôle de l'application

Allez sur le panneau de contrôle et connectez-vous avec le compte administrateur (que vous avez crée au premier lancement de l'application).

Dans l'onglet Database vous pouvez cliquer sur Update pour télécharger la dernière version de la base ainsi que ses vidéos. Les messages s'affichent dans la console de Karaoke Mugen.

ATTENTION : Les vidéos prennent au bas mot 200 Go, assurez-vous d'avoir suffisamment d'espace disque disponible.

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

via un téléchargement manuel

Vous pouvez récupérer et utiliser la base complète via son dépôt Git ou en téléchargeant la dernière version (vidéos à part).

Utiliser git clone vous permettra de rester à jour, ce qui n'est pas le cas avec l'archive zip qui est un instantané à un instant T de la base.

Consultez la page du dépôt git de la base en lien juste au-dessus pour plus d'informations, notamment sur comment récupérer les vidéos.

Mettre à jour la base de karaokés

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

Premier lancement

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

Il s'agit de la fenêtre de logs. C'est votre amie, elle vous dira tout ce qu'il se passe dans Karaoke Mugen, même des choses que vous ne voulez pas savoir.

Vous pouvez la minimiser si elle vous gêne, bien sûr.

--------------------------------------------------------------------
Karaoke Mugen v2.2.0 (Haruhi Hagiographique)
--------------------------------------------------------------------


11:36:44 - info: [Gen] Starting database generation
11:36:44 - info: [Gen] GENERATING DATABASE CAN TAKE A WHILE, PLEASE WAIT.
11:36:45 - info: [Gen] Running user database integrity checks
11:36:45 - info: [Gen] Integrity checks complete! Please wait a little bit more...
11:36:45 - info: Karaoke count   : 6
11:36:45 - info: Total duration  : 5 minutes, 38 seconds
11:36:45 - info: Series count    : 3
11:36:45 - info: Languages count : 2
11:36:45 - info: Artists count   : 0
11:36:45 - info: Playlists count : 0
11:36:46 - info: [User] Created user admin
11:36:46 - info: [Engine] Initial current playlist created
11:36:46 - info: [PLC] Dummy Plug : Adding 5 karas into current playlist
11:36:46 - info: [Engine] Initial public playlist created
11:36:50 - info: [PLC] Dummy Plug : Activation complete. The current playlist has now 5 sample songs in it.
11:36:50 - info: [Engine] Initialization complete

"Smile! Sweet! Sister! Sadistic! Surprise! SING!" --The Karaoke Mugen Dev Team

On y voit que le logiciel initialise les différents composants. Notamment, comme il ne trouve pas de base de données, il va en créer une à partir de votre dossier app/data et de ce qu'il contient.

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 6000 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.

Des utilisateurs invités sont créés de base, mais vous pouvez en ajouter/supprimer et créer un utilisateur normal simplement en vous connectant à l'interface Web.

Au lancement, Karaoke Mugen va ouvrir un navigateur Web pour vous sur la page d'accueil. Depuis cette page d'accueil, vous pourrez ensuite lancer l'interface utilisateur, l'interface admin ou celle de management.

Bases de données

Karaoke Mugen stocke ses données dans deux bases SQLite3 qui se trouvent dans le dossier app/db :

Lors d'une mise à jour du logiciel, les bases de données seront mises à jour en conséquence de façon transparente pour vous.

Que faire si je mets à jour mes karaokés

Cela veut dire que si vous ajoutez/supprimez des karaokés, vous devez régénérer votre base de données. Pour cela, plusieurs solutions :

Fonctionnement

Si la génération s'est bien passée, la fenêtre de logs devrait afficher les statistiques des karaokés dans votre base :

23:51:36 - info: [DBI] Karaoke count   : 4828
23:51:36 - info: [DBI] Total duration  : 7 day(s), 12 hour(s), 50 minute(s), 54 second(s)
23:51:36 - info: [DBI] Total series    : 2502
23:51:36 - info: [DBI] Total languages : 15
23:51:36 - info: [DBI] Total artists   : 443
23:51:36 - info: [DBI] Total playlists : 22

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

Background

Le QR Code et l'adresse indiquée serviront à votre public pour se connecter à l'interface de sélection des karaokés. Il s'agit de votre adresse locale de réseau. En aucun cas il ne s'agit de votre IP sur Internet. Seules les personnes sur votre réseau local peuvent participer.

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 acheter la clé de licence DLC... euh, 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", il suffit de double-cliquer à l'intérieur.

Quitter l'application

Plusieurs possibilités :

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 :

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é.

Interfaces

L'interface invité

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

Vous arriverez alors sur l'interface suivante :

Exemple d'interface invité

Vous pouvez aussi utiliser le QR code pour accéder à cette page, si votre smartphone est équipé du logiciel adéquat.

Si vous pouvez bien sûr ajouter des karaokés et consulter la liste de lecture depuis cette interface, vous ne pouvez pas lancer la lecture, car seul l'opérateur le peut !

Pour plus d'informations sur l'interface, consultez la section interface utilisateur !

L'interface opérateur

Vous pouvez vous connecter depuis votre propre machine ou une autre à la page d'administration via l'adresse http://<votre_ip>:1337/admin. Regardez le fond d'écran du lecteur, votre adresse IP est indiquée !

Exemple d'interface admin

Vous pouvez facilement depuis le panneau d'administration 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 !

Pour plus d'informations sur l'interface, consultez la section interface opérateur !

Gestion système

Toujours en utilisant votre navigateur, vous pouvez accéder à cette troisième interface pour gérer des options spécifiques à Karaoke Mugen.

Depuis cette interface, on pourra : créer et supprimer des utilisateurs, créer ou éditer des karaokés, créer ou éditer des noms de séries (rattachées à des karaokés), mettre à jour la base de karaokés...

Contrairement aux options opérateur, qui ont un effet direct sur votre session de karaoké, là on va toucher plus profondément au logiciel en lui-même. Il est donc fortement recommandé de faire un tour sur cette interface avant de vous lancer dans une session de karaoké. La plupart des modifications ne seront prises en compte qu'au redémarrage du logiciel.

Pour plus d'informations sur l'interface, consultez la section interface de gestion !

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.

Deux listes de lectures sont indispensables. Vous devez absolument les avoir :

Liste de lecture publique

La liste de lecture publique est une liste de suggestions. Elle est principalement utilisée dans le mode de karaoké public (voir plus bas). Si vous faites un karaoké en mode privé (mode par défaut), vous n'avez pas à vous en soucier.

Liste de lecture courante

C'est la liste de lecture principale ! C'est la liste à partir de laquelle Karaoke Mugen lancera les karaokés.

Dans un karaoké en mode privé (par défaut) quand le public choisit une chanson, elle est ajoutée à la fin de cette liste.

La liste courante peut contenir plusieurs fois le même karaoké si l'option est activée.

Liste noire

Karoke 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 :

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.

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 d'abord sélectionner un karaoké, lui faire afficher les détails et enfin cliquer sur l'icône en forme d'étoile.

Les utilisateurs peuvent utiliser leurs pistes de favoris pour suggérer rapidement des titres à l'opérateur. Mais l'inverse est aussi possible, l'opérateur peut aller voir les listes de favoris de ses utilisateurs pour piocher dedans (par exemple pour faire une liste de chansons à partir des gens présents dans une salle).

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.

Mode de karaoké

Deux modes sont disponibles selon votre public et peuvent être changés à tout moment.

Mode privé

C'est le mode par défaut !

En privé, vous êtes bien, posés avec vos amis, et vous voulez vous faire un karaoké : vous savez avec qui vous chantez. Chaque karaoké ajouté via l'interface invité arrive dans la liste de lecture courante et est donc traité à la suite par le lecteur vidéo.

Il s'agit du mode le plus simple pour s'amuser en karaoké.

Mode public

Vous êtes en public, c'est-à-dire avec des gens que vous ne connaissez pas forcément et vous ne voulez pas que tout le monde ajoute n'importe quoi à la liste de lecture.

Cela tombe bien, le mode public est là pour ça !

Grâce à ce mode, plutôt que d'arriver directement dans la liste de lecture courante, les karaokés ajoutés par vos invités / votre public arriveront dans la liste de lecture publique. Il faut donc la traiter comme une liste de suggestions de votre public. À vous ensuite d'ajouter les karaokés que vous jugez pertinents dans la liste courante.

Le mode public propose d'autres fonctionnalités innovantes comme :

Le 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 publique/de suggestions.

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.

Les likes

Lors de la consultation de la liste publique, 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 leur panneau d'information.

Utilisateurs

Chaque utilisateur peut avoir un compte sur l'application. Ce compte est local et utilisable uniquement sur votre instance de Karaoke Mugen et contient un profil (avatar, login, pseudo, password...), mais aussi votre liste de favoris personnelle.

Vous n'avez besoin que de saisir un nom d'utilisateur et un mot de passe pour vous créer un compte.

Votre nom d'utilisateur n'est pas modifiable une fois crée, mais le nom affiché l'est (le pseudo)

Si vous ne souhaitez pas créer de compte, il suffit de cliquer sur "Continuer comme invité" pour que le logiciel vous attribue un compte invité (parmi de multiples possibilités).

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.

En savoir plus

Jetez un oeil à la configuration, l'interface Web et à la gestion de la base de karaokés pour en savoir plus !