Skip to content

SubtitleGuideHandlingMultiPartVideos

Zalunda edited this page Sep 17, 2025 · 5 revisions

Handling Multi-Part Videos

Many video releases are split into multiple files (e.g., my-video-part-a.mp4, my-video-part-b.mp4). Processing each part individually creates a significant problem for AI-driven translation and analysis: loss of context. AI models produce far better results when they can analyze the entire narrative from beginning to end.

To solve this, FunscriptToolbox has a built-in feature that allows it to treat a sequence of video files as a single, continuous virtual video. This is achieved through a simple text file with the extension .vseq (Video Sequence).

This is the strongly recommended method for handling multi-part videos.

The Recommended Workflow: Using a .vseq File

This workflow is simpler and more powerful than manually merging files, as the tool handles both the virtual merging and the final splitting of outputs automatically.

Step 1: Create the .vseq File

A .vseq file is a plain text file that lists the filenames of all the video parts in the correct order, one file per line. It doesn't support full or relative path; it needs to be filenames only.

  1. Create a new text file and name it after your scene, with the .vseq extension (e.g., EBVR-004.vseq).

  2. List your video files inside it, in the exact playback order.

    Example EBVR-004.vseq content:

    EBVR-004-A.mp4
    EBVR-004-B.mp4
    EBVR-004-C.mp4
    
Power User Tip: Generate the .vseq file from the Command Line
If you have many parts, you can create this file instantly using a single command. Open a command prompt (`cmd.exe`) in the folder containing your video files and run:
dir /B /ON EBVR-004-*.mp4 > EBVR-004.vseq
This command finds all files matching the pattern `EBVR-004-*.mp4`, lists them alphabetically (which is usually the correct order), and saves that list directly into your `.vseq` file.

Step 2: How the Tool Handles Outputs

This is the best part: the tool automatically splits all output files for you.

When you use a .vseq file as your input, the tool understands that it's a sequence. While it processes everything internally as one long video, any file it saves will be automatically split and named to match your original parts.

For example, at the end of the workflow, instead of getting one large EBVR-004.srt file, you will get:

  • EBVR-004-A.srt
  • EBVR-004-B.srt
  • EBVR-004-C.srt

Alternative Method: Manual FFmpeg Merging

If you prefer to work with a single, physically merged video file, the original manual workflow is still available. This may be useful if you've already merged your files.

Step 1: Merge the Video Files

Use a tool like FFmpeg to combine your video parts into a single file.

ffmpeg -f concat -safe 0 -i mylist.txt -c copy my-video-merged.mp4

Step 2: Process the Merged Video

Use the resulting my-video-merged.mp4 as the input for the entire Subtitle Creation Workflow.

Step 3: Manually Split the Final Subtitle File

Unlike the .vseq method, the tool will only output a single .srt file for the merged video. You must then manually split it using the as.cfs command:

FunscriptToolbox.exe as.cfs -i my-video-merged.mp4 -o "my-video-part-*.mp4"

This command will generate the correctly timed .srt files for each of your original parts.

Clone this wiki locally