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
L'installation peut prendre du temps selon votre configuration, de 10 à 20 minutes.
Une fois l'installation finie, votre console devrait ressembler à ça :
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.
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.
Ç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.- Chaque version est étiquetée (tag) : prenez la version qui vous intéresse.
- Si vous aimez le risque, vous pouvez télécharger la version en cours de développement. Attention, elle contient très probablement des bugs !
- 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 dossierapp/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/postgres
de façon à avoir un dossierbin
,share
,lib
, etc. dansapp/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éfautkaraokemugen_app
). Pour cela connectez-vous avec le super utilisateur postgres à la base de données et lancez la commandeCREATE 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.