Getting Started

Launching kbp2video

If you installed kbp2video from the Windows installer, you can run it from the start menu shortcut. If you are troubleshooting an isssue and want extra debug output, use the debug mode shortcut, which will launch it with a console window.

If you installed manually, activate your venv if applicable and run

python3 -m kbp2video

User Interface Overview

After you launched kbp2video, the UI should look something like this:

If you have dark mode enabled for your apps, it may look more like this

The left pane is the list of projects queued for conversion. The first column shows the filename of the project, the second shows the audio file used, and the third shows the background color, image file, or video file used. When files are loaded in via Add Files or drag and drop, they will display just the file name in this view, but you can see the full path if needed by hovering over the field.

The buttons below the pane are for managing the projects. “Remove selected” removes a row, “Add empty row” adds a new row if you want to manually fill in filenames instead of using the Add functionality. “Edit files…” opens the selected project files in their default editor. This means, e.g. if you convert a .kbp file, then want to change something and try again, you can use that as an easy way to open it in KBS. You can also use this to edit the .ass file if you run a “subtitle only” conversion. “Set Intro/Outro…” opens the intro/outro editing window for the selected projects. That feature is covered in Using Background Image/Videos.

The status bar initially shows versions detected of components (also available in Help ‣ About). It later is updated to show conversion progress. Note that if ffmpeg is not able to launch quick enough in the background to check the version, that may show unknown.

The File and Edit menus currently only duplicate some of the functionality in the buttons and indicate some keyboard shortcuts, but may later add additional functionality. In addition to About, the Help menu has a “Check for Updates…” which will look for and link you to a new release if available.

The right pane has numerous options for customizing the .kbp processing and the video output. See Subtitle Options, Video Output Options, and kbp2video Options for more details.

Finally the two conversion buttons allow you to convert just to a subtitle (.ass) file or also convert to a video. See Running the Conversion.