kbp2video Options
=================

These settings control the behavior of kbp2video itself.

.. image:: images/kbp2video_options.png
   :alt: kbp2video options section of the kbp2video UI

Output Folder
-------------

The Output Folder option allows you to specify where to place the generated subtitle and video files.

Relative Path
^^^^^^^^^^^^^

If "Use relative path from project file" is checked, the location is based on where each project is located. For example, say you have this option set, path is set to "kbp2video", and your video container (see :ref:`video_options:Output File Type`) is set to mp4. These example projects would place files as follows:

.. list-table::
   :header-rows: 1

   * - Project File
     - Outputs
   * - C:\\Users\\Somebody\\i_used_to.kbp
     - C:\\Users\\Somebody\\kbp2video\\i_used_to.ass

       C:\\Users\\Somebody\\kbp2video\\i_used_to.mp4
   * - C:\\Users\\Somewhere\\over\\the_rainbow.kbp
     - C:\\Users\\Somewhere\\over\\kbp2video\\the_rainbow.ass

       C:\\Users\\Somewhere\\over\\kbp2video\\the_rainbow.mp4

It will create *one* level of folders if missing, so in this case would create the kbp2video folder.

The video file is *always* placed in the same place as the subtitle if relative path is turned on, so you get the slightly unintuitive behavior of:

.. list-table::
   :header-rows: 1

   * - Project File
     - Outputs
   * - C:\\Users\\Somebody\\i_used_to.ass
     - C:\\Users\\Somebody\\i_used_to.mp4

The reason for this is the most common use case for converting directly from a .ass file is that you converted from a .kbp and it's already in the output folder, so the typical case would look more like this:

.. list-table::
   :header-rows: 1

   * - Project File
     - Outputs
   * - C:\\Users\\Somebody\\kbp2video\\i_used_to.ass
     - C:\\Users\\Somebody\\kbp2video\\i_used_to.mp4

Usually you would not want to create a kbp2video folder inside the kbp2video folder.

Absolute Path
^^^^^^^^^^^^^

If relative path is not checked, the path is expected to be an absolute one. You can use the Browse button to select one. E.g. if you set your absolute path to Z:\\karaoke\\My Outputs, you'd get the following behavior:

.. list-table::
   :header-rows: 1

   * - Project File
     - Outputs
   * - C:\\Users\\Somebody\\i_used_to.kbp
     - Z:\\karaoke\\My Outputs\\i_used_to.ass

       Z:\\karaoke\\My Outputs\\i_used_to.mp4
   * - C:\\Users\\Somewhere\\over\\the_rainbow.kbp
     - Z:\\karaoke\\My Outputs\\the_rainbow.ass

       Z:\\karaoke\\My Outputs\\the_rainbow.mp4
   * - C:\\Users\\Im\\justa\\bill.ass
     - Z:\\karaoke\\My Outputs\\bill.mp4

Ignore BG files in drag/drop
----------------------------

This impacts the behavior of drag and drop. It will only permit it only to recognize kbp and audio files. See :ref:`add_files:Options` for more detail.

Reset Settings...
-----------------

This will change all your settings to kbp2video defaults. It will prompt to make sure you're sure.