This page describes how karaokes are handled in Karaoke Mugen, how to add, delete or edit them, etc.
First things first
To work, Karaoke Mugen needs karaokes. We'll call that a karaoke base. This is the set of video, lyrics and metadata files you own.
Don't confuse it with the Karaoke Mugen databases which are files generated by the software and store all the important data it needs to run.
What is a karaoke base
To import data and create its databases, Karaoke Mugen needs to know where to find your media, lyrics, and metadata files.
A karaoke base folder has three subfolders which are named by default :
karas: All the
.karafiles, which are metadata about your karaoke songs.
lyrics: All the
.assfiles, which are subtitles and the actual karaoke files.
medias: All the medias (
.mkv/avi/webm/mp4/mp3/ogg...) used for karaoke.
series: All the
.series.jsonfiles, which are metadata about your series
Typically, you'll get a foledr structure like this :
app - data - karas - lyrics - medias - series
These folders are configurable in the
config.yml file. See the configuration section for more details. You can, for example, have videos on an external hard drive or network share to save space.
This file stores metadata about your karaoke, it is mandatory : it tells Karaoke Mugen where your subtitle and video files are, as well as other information it needs to generate its database.
.kara files can be generated from Karaoke Mugen's control panel.
This database is created from your
.kara and media files.
Karaoke Mugen uses it to hold data from your karaoke base to make it searchable.
Once the base is generated, the software only needs to read
.ass and media files during runtime.
Generate a database
You can launch Karaoke Mugen with the
--generate command line flag or go to the control panel to start a database generation.
This will take a few minutes depending on your computer's speed.
Editing/creating new karaoke files
You can go to Karaoke Mugen's control panel to create a new karaoke file. In the
karas dropdown menu, select "New karaoke" and fill the form.
A faw things to keep in mind :
- Uploaded files will be renamed to fit the Karaoke Mugen naming convention. You don't have to rename them yourself (but you can if you enjoy wasting your time)
- Files will be placed in your primary
mediasfolders. If you have several of those in your
config.ymlonly the first one of each will be used to place files.
- Adding a new karaoke song adds it to your database without you needing to regenerate it, allowing you to test it out at once.
series menu you can manage series. Add, edit, or remove them.
A few things to keep in mind :
- Editing a series will modify it inside all
.karafiles that contain it.
- Removing a series will remove it from all
.karafiles that contain it.