Subtitles Generator

Simple module written in Javascript with ECMAScript module format.

Exports one function that uses FFmpeg and AI to generate a subtitle file for a video.

FFmpeg must be installed.

Three models are available

• Gemini 2.5 Flash-Lite, requires a Gemini API key
• OpenAI Whisper, requires an OpenAI API key
• OpenAI Whisper installed locally, requires Python 3.9.9 and the package openai-whisper installed

  $ py -3.9 -m pip install openai-whisper

Input:

• The path of the video file
• Model: openai, gemini or whisper (default)
• If OpenAI model: A valid OpenAI API key

Output:

• A subtitle file in the desired language, created in the same folder as the video folder.

Installation

$ npm install @lordofmax/subtitle-generator

Example

import { generateSubtitles } from "@lordofmax/subtitle-generator";

const videoFilePath = "./movie.mp4";
const openaiApiKey = "YOUR_OPENAI_API_KEY";

await generateSubtitles(videoFilePath);
await generateSubtitles(videoFilePath, { translateTo: "en" });
await generateSubtitles(videoFilePath, { openaiApiKey: openaiApiKey, model: "openai" });

Command Line Interface

This package can also be used as a command line

$ npm install -g @lordofmax/subtitle-generator
$ sub -file path/to/video/file
$ sub -file path/to/video/file --translate en
$ sub -file path/to/video/file --key YOUR_OPENAI_API_KEY --model openai