Installation

Cette page décrit comment récupérer et installer Karaoke Mugen.

NOTE : Une fois installé, Karaoke Mugen ne nécessite pas de connexion internet, sauf pour certaines fonctionnalités comme l'URL d'accès raccourcie ou les comptes en ligne.

Télécharger Karaoke Mugen

Des exécutables pour Windows et macOS sont disponibles. Vous trouverez soit des installeurs, soit des archives portables.

Si vous n'avez pas déjà téléchargé Karaoke Mugen, consultez la page de téléchargement du site.

Installer Karaoke Mugen

Plusieurs façons d'installer sont possibles, via des versions compilées prêtes à l'emploi ou les sources.

Une fois que c'est fait, vous pouvez passer à la section démarrage rapide

Windows

Deux possibilités :

Installeur

Double-cliquez sur l'executable et suivez les instructions.

Portable

Décompressez l'archive .zip dans un dossier où vous avez de la place.

macOS

Image DMG

Double-cliquez sur l'image DMG et faites glisser Karaoke Mugen dans votre dossier Applications.

Linux

ArchLinux

Il existe deux paquets AUR, karaokemugen et karaokemugen-git. Le premier est basé sur la dernière version en date, le second est basé sur le dernier commit de la branche master. La méthode d'installation reste la même peut importe celui que vous choisissez.

N'importe quel empaqueteur AUR devrait fonctionner, ici nous utiliserons pikaur.

Installation
$ pikaur -S karaokemugen-git

Capture d'écran de Pikaur

L'installation peut prendre du temps selon votre configuration, de 10 à 20 minutes.

Une fois l'installation finie, votre console devrait ressembler à ça :

Capture d'écran de Pikaur, à la fin de l'installation

Si vous voyez ça, c'est que tout s'est bien passé !

Configuration initiale

Comme vous avez pu le lire, le paquet AUR est fourni avec un utilitaire, karaokemugen-install, permettant la configuration automatique de Karaoke Mugen ! Lancez cet utilitaire dès que l'installation est terminée.

$ karaokemugen-install

Attention : comme indiqué au lancement, ce script risque fort de ne pas fonctionner si vous avez changé la configurtaion de PostgreSQL. Ce script va nécessiter les droits super-utilisateur à plusieurs reprises à l'aide de sudo.

Au lancement, le script vous avertit d'éventuels problèmes qui pourraient empêcher le bon déroulement de l'installation et effectue ensuite toutes les actions nécessaires pour prévoir le fonctionnement de Karaoke Mugen (créer la base de données, appliquer la configuration nécessaire, etc...).

Ce script est interactif, il se peut que le script vous pose quelques questions sur les actions à adopter (notamment si une base de Karaoke Mugen est détectée) ou sur certains éléments de configuration.

Capture d'écran de karaokemugen-install

Une fois le script terminé, vous êtes prêts pour lancer Karaoke Mugen.

Lancement

Bravo ! Votre installation de Karaoke Mugen est désormais prête à être lancée pour vivre de formidables aventures.

Vous devriez pouvoir trouver Karaoke Mugen dans le menu Applications de votre environnement de bureau, si ce n'est pas le cas, lancez simplement karaokemugen dans un terminal.

Capture d'écran du lanceur d'applications

Capture d'écran de l'application Karaoke Mugen

Ça ne marche pas ?

Tout d'abord, désolé, nous voulons que l'installation soit la plus simple possible mais nous ne pouvons pas tout prévoir. N'hésitez pas à venir nous voir si vous avez le moindre souci.

Installer Karaoke Mugen depuis les sources

Vous pouvez installer Karaoke Mugen en téléchargeant son code source.

  • Téléchargez une version de Karaoke Mugen depuis le dépôt Git via la commande git clone ou via l'archive ZIP correspondante.
  • Téléchargez mpv et placez son exécutable dans le dossier app/bin ou indiquez son chemin dans le fichier de configuration si vous avez déjà mpv d'installé sur votre système.
    • Version 0.25 minimum requise (0.27 pour Mac OS)
    • Version >0.29 sous Windows a un problème avec l'affichage des balises progressives en karaoke
    • Une version 0.32 sous Windows compilée sans ce problème est livrée avec Karaoke Mugen
  • Téléchargez ffmpeg et placez l'executable ffmpeg dans le dossier app/bin.
    • Version 3.3.1 minimum requise
  • Téléchargez nodeJS qui est nécessaire pour faire tourner Karaoke Mugen.
    • Version 12 requise (actuellement notée LTS).
    • Installez nodeJS une fois téléchargé.
  • Décompressez les sources de Karaoke Mugen dans un dossier de votre disque où il y a de l'espace disque disponible (environ 125 Mo).
  • Téléchargez la version de PostgreSQL correspondante à votre système.
    • Version 10.6 minimum requise. Karaoke Mugen peut fonctionner avec PostgreSQL 9.x mais ça n'a pas été testé. Les versions supérieures fonctionnent (jusqu'à 12.x)
    • Soit vous placez le contenu de l'archive des binaires dans app/bin/postgresde façon à avoir un dossier bin, share, lib, etc. dans app/bin/postgres soit vous utilisez votre propre serveur PostgreSQL
    • Si vous voulez utiliser votre propre serveur PostgreSQL, consultez la partie configuration et créez l'extension unaccent dans votre base de données Karaoke Mugen (par défaut karaokemugen_app). Pour cela connectez-vous avec le super utilisateur postgres à la base de données et lancez la commande CREATE EXTENSION unaccent;

Si vous n'avez pas déjà yarn, consultez le site web pour l'installer sur votre système.

Une fois yarn installé, ouvrez une ligne de commande (cmd, terminal, bash...) et allez dans le dossier où vous avez décompressé les sources de Karaoke Mugen. Lancez alors la commande :

yarn setup

yarn va installer les modules nécessaires au bon fonctionnement de l'application et construire le client React. Cela peut prendre de 1 à 5 minutes selon la rapidité de votre connexion Internet ou de votre machine. Sans accès à Internet, l'installation ne pourra pas continuer.

Une fois que c'est fait, vous pouvez passer à la section démarrage !

Spécificités selon la plateforme

Windows

mpv

Si vous utilisez votre propre lecteur vidéo mpv, notez que les versions supérieures à la 0.29 ont un souci au niveau du sous-titrage karaoké qui décale quelque peu l'affichage des syllabes en karaoké progressif (qui se remplissent progressivement. Il s'agit de la balise \kf pour être plus précis).

Nous fournissons avec Karaoke Mugen un mpv compilé maison avec une libass corrigée.

Linux

Vous aurez besoin de PostgreSQL d'installé et prêt à l'emploi. Consultez la section dédiée à l'installation depuis les sources pour savoir comment le configurer

Linux (Ubuntu)

Attention, la version de mpv fournie dans le dépôt Ubuntu officiel est obsolète, et n'est pas compatible avec Karaoke Mugen.

Il est donc nécessaire d'installer une autre version. Le site officiel fournit plusieurs méthodes d'installation, mais la plus simple pour les distributions basées sur Ubuntu est d'utiliser le PPA :

sudo add-apt-repository ppa:mc3man/mpv-tests
sudo apt-get update
sudo apt-get install mpv

Consultez le site web de mpv pour plus d'informations.

macOS

Sécurité

Sous macOS Catalina, vous devrez faire un clic droit -> Ouvrir pour lancer Karaoke Mugen. Nous ne pouvons pour le moment pas signer le code de l'executable.

mpv

La version de mpv requise est la 0.25, mais pour bénéficier du plein écran correctement, vous aurez besoin de la version 0.27 du logiciel. Installez-la via votre méthode préférée (MacPorts, Homebrew, binaires, etc.).

Raspberry Pi

Une version pour Raspberry Pi est disponible via le projet Mugen Pi.