Here are a list of frequently asked questions about issues you might have with Karaoke Mugen.

I lost my admin password!

Don't panic. You can proceed in two ways :

  • Use the Security Code found in the console at Karaoke Mugen startup. When logging in, check the "Forgotten password" toggle if it's an online account and you did specify an email address. A password recovery mail will be sent to you. In case it's a local account or you did not specify an email address, create a new operator account from the login screen. Check the "Operator Account" toggle, and there you'll be able to input the security code and input a new, changed password for the user of your choice.
  • Force a new admin password with the --forceAdminPassword <passowrd> command-line argument where <password> is the new admin password you desire. You only need to do this once.


My karaokes list is empty or incomplete.

It can be a normal thing, either it's your first launch of the software, either you've incorrectly modified an option.

If it's your first launch, it will display the existings karas in the samples folder.

Alternatively, if you have followed the starting guide, and that you get the existing base, it should display the existings karas into the app/data folder.

If you have a different folder to store your karaokes, so verify the content of the config.yml file. You should find all paths under the System and Path categories.

Verify that this line shows a path to the right folder containing your videos or audio files. Do it again with the Karas and Lyrics, Series and Tags variables.

You can also modify those paths from the system interface.

.kara.json and .ass files are in place but still nothing happens

Make sure that you restarted Karaoke Mugen, it should take into account the new files. You can restart a generation by going to the system panel from the home page, in the menu System then Database and finally by clicking on the button Regenerate your database.


I have everything set up, but the video window is black/blue.

Your graphics card does not support OpenGL. There's an option in the config file to switch to Direct3D under Windows.

In the system panel, in the configuration menu, find mpvVideoOutputin the Player section and set it to direct3d.

How much space is needed for Karaoke Mugen?

The software should take abotu 200 Mb of disk space, but the karaoke database can take several hundred gigabytes.

Can I download only part of the base?

Yes, a Download manager is available in the System Panel.


Errors during database generation


This means you have two .kara files sharing the same KID in your base. KIDs are supposed to be unique, so make sure you don't have a dupe .kara file or a .kara.json file copied from an existing one where the KID line hasn't been removed.

Media file not found

Make sure you have all videos and other media, and verify that it isn't misspelled in the .kara file or on your filesystem.