Skip to content

Manual Video Creation Addition

Jump to bottom
Alunacoz edited this page Mar 11, 2026 · 3 revisions

I HIGHLY suggest using the built in package creation in the manager to streamline this process.

To manually add custom video content or create new packages, follow these steps:

1. Create Video Folder

Create a new folder in /videos/.

2. Update Manifest

Add a new entry in manifest.json with the exact name of your folder, following the existing pattern format.

3. Add Required Files

Inside your video folder, include the following files:

File Description Notes
meta.json Metadata file Fill in according to the provided examples
video.mp4 Video file Can use any filename, but must be .mp4 format
path.bx Path data file Can use any filename, must be .bx format
thumb.jpg Thumbnail image .jpg or .png accepted; placeholder shown if missing

⚠️ Important: Create and configure meta.json first before adding other files.

4. Some Notes:

  • You can add multiple .bx files to one video under the bxFiles section if you add additional entries.
  • For highlighted tags, I like to do 3: Difficulty, Type of video, and then video creator. Do what you like, but that's how I prefer it.
  • Duration is calculated in FRAMES, not seconds.

5. Special Tags & Naming Conventions:

The following are SUGGESTIONS and NOT NECESSARY, but a recommendation for keeping things organized.

The original inspiration for this project was so I could split BounceX compilations into their individual parts/songs, so if a video only has 1 song, then use that as the title. If there are multiple songs, just name it whatever (when I convert regular PMV/HMVs, I just use the video title).

There are a handful of "special" tags which make it easy to filter. You can see all of the "special" tags in the videos tab. The categories are:

Video Type

  • BounceX
  • Dildo Hero (You can use the funscript converter in the DH Discord Server to convert some of these to be compatible!)
  • Other

Difficulty

  • Easy
  • Medium
  • Hard
  • Extreme
  • Multi-Difficulty (Use this when you use more than 1 path, otherwise indicate how hard on average the path is.)

Song Quantity

  • Single Song
  • Compilation (If there are multiple MAIN songs in the video, use this)
  • No Song

All other tags

Anything else you feel is relevant. Here are some suggestions:

  • Content descriptors/tags
  • Song name(s) (if not provided in the title or elsewhere)

6. Additional Tools

In the Tools folder, there are 2 files:

  • offset.sh allows you to add or remove frames from the start of a video using ffmpeg
  • splitbx.py allows you to split a .bx file into multiple parts. This is helpful if you have a long video with 3 songs but just 1 path and want to split them up into paths for individual songs. You can find their usage in their source code.

7. Packaging for sharing

When creating a package to share, ONLY include a videos and/or playlists folder in the root directory of the .zip. Omit any files other than the ones needed, so do NOT include manifest.json.

Clone this wiki locally