This page explains how to get and install Karaoke Mugené Mugen.
NOTE : Once installed, Karaoke Mugen does not need any internet connection, except for some features :
- Remote access for the public through the URL https://xx.kara.moe
- Online accounts
- Song updates on startup
- Most popular song lists
- Playing songs which haven’t been downloaded locally yet
Download Karaoke Mugen
Binaries for Windows, macOS and Linux are available. You’ll find either installers or portable installs. If you don’t know which to pick, we recommend the installer version.
Extract the .zip archive in a folder of your choice where there’s a lot of disk space available.
Install Karaoke Mugen
There are several ways to install depending on if you want the app from source or from compiled versions ready to use.
Once done, you can go to the getting started section!
Two choices :
Double-click on the executable and follow instructions
Extract the .zip archive in a folder/drive where you have enough space available.
Double-click on the DMG image and drag & drop Karaoke Mugen in your application folder.
Depending on your macOS version you might need to right-click the DMG image or the app and select “Open” the first time to force it to open since the system is more restrictive towards non-signed applications. We don’t have the money to sign Karaoke Mugen yet.
Debian/Ubuntu package (.deb)
The Debian package will install PostgreSQL, mvp and ffmpeg as dependencies to make sure Karaoke Mugen works. The package should also create an entry in your application menu.
After installing this package, you will need to configure PostgreSQL. You should take a look at your distribution’s documentation on how to setup PostgreSQL.
To configure the database for Karaoke Mugen, you’ll need to create it and name it
karaokemugen_app (or any other name) as well as a role for the app.
Here are the commands you’ll need to use on Debian or Ubuntu (this can vary a little depending on your distro)
user$ sudo -iu postgres postgres$ createuser -P karaokemugen_app > Un mot de passe vous sera demandé. Mettez celui que vous voulez. postgres$ createdb karaokemugen_app -O karaokemugen_app -E UTF8 postgres$ psql -c "create extension unaccent;" karaokemugen_app postgres$ psql -c "create extension pgcrypto;" karaokemugen_app
After this, you will need to configure Karaoke Mugen to tell the app which password you used to connect via the
There are two AUR packages,
karaokemugen-git. The first is based on the latest stable version and the second on the last commit from the
master git branch. They both can be installed in the same way.
$ pikaur -S karaokemugen-git
Installation can take some time depending on your configuration, from 10 to 20 minutes.
Once done, your console should look like this :
If you see this, everything went well!
As you saw, the AUR package comes with the
karaokemugen-install utility, allowing you to automatically configure Karaoke Mugen! Launch this utility as soon as install is over.
Warning: as said during launch, this script will probably not work if you changed the default PostgreSQL configuration. This script will need super-user rights several times via sudo.
At launch, the script warns you of potential problems which could keep it from working and then does all necessary actions to make Karaoke Mugen work (create database, apply configuration, etc.)
This script is interactive. It may ask you a few questions on what to do (especially if a previous Karaoke Mugen database is found) and other configuration items.
Once done, you’re ready to launch Karaoke Mugen.
Congratulations! Your Karaoke Mugen install is ready to start so you can experience incredible adventures.
You should be able to find Karaoke Mugen in your Applications menu’s desktop environment. If that’s not the case, launch it simply with
karaokemugen in a terminal.
It doesn’t work?
First, sorry. We want the install to be as simple as possible but we can’t think of everything. Don’t hesitate to contact us if you have a problem.
Install from source
You can install Karaoke Mugen by downloading its source code.
Download a Karaoke Mugen version from its git repository through
git cloneor the ZIP archive provided by gitlab.
Unzip/place the Karaoke Mugen source code where there’s enough free space.
- Version 0.33 or later required
Download ffmpeg and place the
ffmpegexecutable in the
- Version 3.3.1 is the minimum requirement
Download nodeJS which is required for Karaoke Mugen to run.
- Minimum version required is 16. Do not use a newer major version.
- Install nodeJS once it’s been downloaded
Download GNU Patch which is required for song database patches
- Minimum version required is 2.7
- Minimum version required is 13.x. Later versions do work.
- You’ll need to configure your database server for Karaoke Mugen to work. Modify the
config.ymlfile to point to your created database. See configuration. Check out the app’s README to see which commands to run on the database
Open the command line (cmd, terminal, bash…) and go into the Karaoke Mugen folder. Then launch :
yarn is not installed yet on your system, go to its website to install it.
yarn is installed :
yarn will install all necessary modules for Karaoke Mugen to work and build the React client. It can take from 1 to 5 minutes depending on your system’s speed and your internet connection.
You’ll need PostgreSQL installed and ready to use. Refer to the installation from sources section
On older Ubuntu releases (before 22.04) the version of mpv provided by the repositories is obsolete, and not compatible with Karaoke Mugen.
You must thus install another version. mpv’s official site provides several ways to install Karaoke Mugen, but the simplest is for Ubuntu and its derivatives to use the following PPA :
sudo add-apt-repository ppa:mc3man/mpv-tests sudo apt-get update sudo apt-get install mpv
Check out mpv’s website for more info.
The patch version bundled with macOS is too old, you’ll need to use Homebrew to install it.