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 :

Online account

  • Use the "Reset your password" button. Beware, it will not work if you haven't put an email address in your profile
    • if you haven't filled in your email, contact us so we can help you

Local account

  • Use the "Reset my password" button on the connection page and enter the security code. You'll find it in the "Security Code" application menu, or in the logs if you're running a headless version like on a Raspberry Pi.


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.