Adding Files
Overview
Files can be added via the “Add Files…” button, (Ctrl-I), or drag and drop. They mostly function the same except that drag and drop allows you to add folders instead of just files, which behaves as if you selected all the files in the folders. For simplicity, assume anything referring only to drag and drop below also applies to Add Files.
To keep the UI efficient, it provides several ways to add files associated with projects:
Operation Modes
Single .kbp file
If you just drop one .kbp file, kbp2video will add that file, along with the audio file and background color that were configured for it in KBS.
Multiple .kbp files
This works just like with the single file. Note that if multiple .kbp files with the same name are imported at once, only one is used.
Single project set
If you drop a .kbp file along with an audio file and/or background file (image or video), it will use those instead of the ones configured in KBS. E.g. if you used the original audio in KBS and you want to swap it for the karaoke audio, you can drag the .kbp and replacement audio file in together. Or if your background color was set to black in KBS, but instead you want a video background, you can drop that video in with the .kbp.
Multiple project sets
This is where things start getting a little tricky. The way it currently works if you drop multiple project and media files in at once is as follows:
Audio files are matched up with projects based on filenames. If all your audio files are named distinctly from each other and similarly to the project they are associated with, they should work well. If not, you may be prompted to resolve some conflicts.
Background files work the same as audio with the exception that if you drop multiple .kbp files and a single background, it will apply that one backgound to all the .kbp files.
.ass files
You can always drop in .ass files instead of .kbp, and the same rules apply except that it has no way of auto-detecting the audio and background (as in the first two modes), so you need to drop those in as a project set. Also, if a .kbp and .ass file with the same name are dropped together, only the .kbp file is used (it’s assumed that the .ass file was an output of another run and you want to restart the conversion).
Only media files
If you drop media files without project files, it’s assumed those are associated with the project files dropped in earlier. If there were no files dropped in earlier, it does nothing. Otherwise it tries to match them up like with multiple project sets, prompting if there’s an ambiguity. It does not currently treat a single background file specially, because it’s more common to replace one background than everything.
Note that if the media file dropped matches a project that already has a file of that type associated, it will prompt you in the UI if you want to replace it.
Options
If you select Ignore BG files in drag/drop, any background files included in a drop are not processed. This option does not apply to Add Files. The reason this exists is if you import a whole folder and happen to have video or image files there you don’t want to be considered. I’ll likely update this option in the future to be able to exclude audio too, so you can drag in whole folders and have it only use the audio and background configured in the .kbp files.