Karaoke Mugen is a karaoke management software.
Its main purpose is to provide to you and your guests a way to create a playlist and sing on top of it.
How it works
To sum it up
- The app builds a database with the karaoke files present in its data folder (
- A webserver is started on your computer: it allows your users to connect to it with their device and search through your karaoke database. It also allows them to add those they want to sing on. Two modes are available, private or public. Your users have to be on your Wifi network.
- The admin, or DJ depending on how you want to call it, can manage the video player, pause, play, modify the playlist or change the karaoke configuration from another interface only available through its login/password
- The world is saved!
Let's see how you can setup your first karaoke session.
Before everything else, you'll need a karaoke database. You have several choices :
Create your own base
You can create your own karaoke base, go to manage your karaoke database, if you already have videos and .ass files of your own.
Use the samples
A group of 6 karaokes (actually 3 different ones) is bundled with the app in the
samples folder. It is also automatically copied in the
app/data folder if no karaoke is found.
Get an existing database
You can install the complete base in different ways :
Through the control panel
Go to the control panel and login with your admin user. (the one you created during the first run)
In the Database tab you can click on Update to download the last version of the base and its videos. Les messages s'affichent dans la console de Karaoke Mugen
WARNING : Video files take a lot of space (about 190Gb), make sure you have enough disk space before launching the update.
You can quit Karaoke Mugen anytime and continue the update at a later time.
Through a manual download
git clone command to get the latest version through git and stay up to date. The zip archive cannot update itself.
Read more about the karaoke database git repository through its README file, namely how to download the video files.
Update the karaoke database
Read above on how to get the database, as it is roughly the same thing. You can also start Karaoke Mugen via the command-line with the
Double-click on the Karaoke Mugen executable file on Windows or macOS and voilà!
You can start Karaoke Mugen through the command line / terminal. Go to the Karaoke Mugen folder and start the app with :
Here's roughly what you should see in a window :
This is the console window. This is your friend and it will tell you everything that happens in Karaoke Mugen, even stuff you didn't want to know.
You can minimize it if it's bothering you of course.
-------------------------------------------------------------------- Karaoke Mugen v2.2.0 (Haruhi Hagiographique) -------------------------------------------------------------------- 11:36:44 - info: [Gen] Starting database generation 11:36:44 - info: [Gen] GENERATING DATABASE CAN TAKE A WHILE, PLEASE WAIT. 11:36:45 - info: [Gen] Running user database integrity checks 11:36:45 - info: [Gen] Integrity checks complete! Please wait a little bit more... 11:36:45 - info: Karaoke count : 6 11:36:45 - info: Total duration : 5 minutes, 38 seconds 11:36:45 - info: Series count : 3 11:36:45 - info: Languages count : 2 11:36:45 - info: Artists count : 0 11:36:45 - info: Playlists count : 0 11:36:46 - info: [User] Created user admin 11:36:46 - info: [PLC] Dummy Plug : Adding 5 karas into current playlist 11:36:46 - info: [Engine] Initial public playlist created 11:36:50 - info: [PLC] Dummy Plug : Activation complete. The current playlist has now 5 sample songs in it. 11:36:50 - info: [Engine] Initialization complete "Smile! Sweet! Sister! Sadistic! Surprise! SING!" --The Karaoke Mugen Dev Team
We can see the software initializes its components. In this example, as it doesn't find any karaoke database, it will create one from your
app/data folder and what it contains.
Database generation can be real quick if you don't have many songs, but with the full database (about 5000 karaokes), it can take a few minutes, but that's not something you'll do very often. Depending on where the files are (SSD, HDD, or network share) it can take more or less time.
Guests users are automatically created on first startup, but you can add/delete some through the control panel.
On first launch, Karaoke Mugen will also open a web browser on the admin interface.
Karaoke Mugen stores its data in two SQLite3 databases in the
app/db folder :
karas.sqlite3stores all the karaokes you have. This database is created from scratch everytime you regenerate it. Don't worry if you lose or delete it!
userdata.sqlite3is the file containing all your playlists, users, stats, and blacklists! If you have to save one file it has to be this one, so be careful!
When updating Karaoke Mugen, databases are updated as well without you having to worry about it.
What should I do when updating my karaokes
If you add/remove/modify karaokes, you must regenerate your database. There are several ways to do it :
- You can delete the
karas.sqlite3file in the
app/dbfolder and restart Karaoke Mugen.
- You can regenerate the database from the control panel with an admin account.
- You can start Karaoke Mugen with the command line option
--generatewhich will create a new database.
If generation was successful, the console window should display correct stats :
23:51:36 - info: [DBI] Karaoke count : 4828 23:51:36 - info: [DBI] Total duration : 7 day(s), 12 hour(s), 50 minute(s), 54 second(s) 23:51:36 - info: [DBI] Total series : 2502 23:51:36 - info: [DBI] Total languages : 15 23:51:36 - info: [DBI] Total artists : 443 23:51:36 - info: [DBI] Total playlists : 22
Another window should also appear in the lower left corner of your screen with a wallpaper, connection info and a QR Code.
The QR Code and the URL at the bottom will allow your users to connect to the karaoke selection interface. This is your local network address. This is not your internet IP. Only people on your Wifi network can participate.
By default, Karaoke Mugen is configured in PIP (Picture in Picture) mode. The video player will play your karaokes in a small window so you can test things out. To get it to go full screen, you'll have to buy the license key... wait, no. You'll need to configure the app.
This PIP mode is perfect for tests or to have some background music while you work on something else.
Exiting the app
You can do it from the admin panel by clicking the button in the top right corner.
Force Karaoke Mugen to exit
CTRL+C in the console window to close the app (or close its window).
The video player used is mpv, which you can find on its website, mpv.io.
Here are some useful key shortcuts :
ESC: Leave fullscreen
Q: Exit player (this does not exit Karaok Mugen!)
Left/Right arrow: Forward/Rewind in a video
Up/Down arrow: Forward/Rewind faster in a video
F: Switch between fullscreen and windowed mode. Karaoke Mugen keeps the player open between two songs, this setting will thus stay as long as you don't quit the app. The player will in windowed mode again on next startup unless you go change the setting itself.
Mouse wheel up/down: Change volume (Mouse cursor must be over the window)
These keys only work if you have "focus" on the video player. Click inside the window to get focus.
You can also move the window around on your screen. By default it is always on top, but this can be changed.
Go to the URL displayed on the video player's wallpaper! You'll get to see this :
You can of course add songs from there and check out the current playlist, but you can't start the player, as only the admin can!
You can reach it using the following URL from your machine or another one :
http://<your_ip>:1337/admin. Check out the player's wallpaper to get your IP address.
You can easily manage the player from the admin panel and your various playlists. You can see here that we have a list of all the available songs on the left, and our current playlist on the right.
Try to add karaokes in the current playlist and click on Play !
For more information on, check out the web interfaces section!
You can create as many playlists as you want. these lists can be useful to prepare for karaoke sessions and parties, or listen to various songs depending on your mood.
A playlist can have as many songs as you want, but a song can only be present once in a list.
Two playlists are mandatory :
The public playlist is a suggestions list. It's mainly used in the public karaoke mode (see below). If you use the private mode (default) you don't need to bother with it.
This is the main playlist! It contains the songs Karaoke Mugen is going to read and play.
In a private mode karaoke (default), songs chosen by your users are added to this list.
Karaoke Mugen has a blacklist system with criterias.
Songs in the blacklist won't appear anymore in the karaoke list users can see. Admins can still see them though.
You can add songs directly to the blacklist, but you can also define criterias to automatically add a set of songs. Once they are defined, Karaoke Mugen will generate a new blacklist for you.ous.
Criterias are :
- Karaoke : Adds a unique song
- Titre contains : Title contains the specified word (example "Gundam").
- Longer/shorter than : All songs longer or shorter than the specified value (in seconds) will be blacklisted. Useful for AMVs or long songs.
- Tags : Ban by specific tag (as opposed to ban if tag contains a word).
- Type : Ban by type (Opening, Ending, Clip, AMV, etc.).
- Kara author : Ban by the name of the karaoke author
- Language : Ban by language
- Misc : Ban by misc tag (Concert, Video game, R18, etc.).
- Songwriter : Ban by songwriter
All songs present in the whitelist are ignored when generated the blacklist.
You can add songs to this list. These won't be taken into account when generating the blacklist. For example you might want to ban all mecha anime but keep King Gainer.
Every user has a favorites list in which the admin can pick songs they'd like to add to the current playlist if needed.
Admins can create special playlists called AutoMix. These are made from all favorites from logged in users.
Two modes are available depending on what kind of users you have. The mode can be changed anytime.
This is the default mode.
In private, you're there, sitting with your friends, and you'd like to enjoy some karaoke : you know who you're singing with. Every song added through the public interface goes to the current playlist and will be played one after the other without the admin having to do anything.
This is the simplest way to enjoy karaoke.
You're facing a crowd, with people you might not know very well, or you don't want everyone to just add any song they wish to the playlist.
This is what the public is for!
In this mode, instead of going into the current playlist, songs added by your users go to the public playlist. See it as a suggestions list : it's up to you to add songs that you think are best to the current playlist.
The public mode has a few interesting features :
Want to let the public choose their songs? Public vote can be enabled in the admin interface and allows users to vote for songs they wish to be added next. The public interface will display a window asking users to vote for the song they'd like. Songs are selected from the public playlist.
If no song is the clear winner, a random song will be chosen amonog the ones with the most votes.
This is an ideal mode if you don't want to bother with choosing songs.
When checking out the public playlist, users can like a particular song to tell the admin they'd like to see it play soon. This allows the admin to get a better idea of which songs are more popular.
As every user has a limited number of songs they can add during a karaoke session, if the song it requested (the first Naruto opening for example) gets liked enough, it won't count anymore in the user's quota. The user who requested the song can then request another song freely without having to wait for the opening to be played on screen. This free song mechanic can be entirely configured.
Admins can free songs manually so users can regain quota.
Every user can now have an account in the app. This account is local and bound to your karaoke instance. It contains a profile and the list of your favorite songs.
You only need a username and password to create an account.
Your username cannot be changed once created, but your display name can.
If you don't wish to create an account, you can click on "Continue as guest" so Karaoke Mugen can assign a guest account to you.
Guests cannot change their names and don't have a favorites list. They also can't like songs.