ComfyUI  >  Nodes  >  ComfyUI Whisper >  Add Subtitles To Background

ComfyUI Node: Add Subtitles To Background

Class Name

Add Subtitles To Background

yuvraj108c (Account age: 2153 days)
ComfyUI Whisper
Latest Updated
Github Stars

How to Install ComfyUI Whisper

Install this extension via the ComfyUI Manager by searching for  ComfyUI Whisper
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI Whisper in the search bar
After installation, click the  Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • High-speed GPU machines
  • 200+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 50+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

Add Subtitles To Background Description

Overlay subtitles on background images for seamless integration in videos, with automated placement and font adjustments.

Add Subtitles To Background:

The Add Subtitles To Background node is designed to overlay subtitles onto a series of background images, ensuring that the text is clearly visible and aesthetically pleasing. This node is particularly useful for creating videos or animations where subtitles need to be integrated seamlessly into the visual content. By leveraging this node, you can automate the process of adding subtitles, saving time and ensuring consistency across frames. The node intelligently places text to avoid overlap and adjusts font sizes to fit within specified boundaries, enhancing the overall visual appeal of the subtitles.

Add Subtitles To Background Input Parameters:


This parameter takes a list of background images onto which the subtitles will be added. Each image should be in a format compatible with the PIL library, such as JPEG or PNG. The quality and resolution of these images will directly impact the final output.


This parameter is a list of dictionaries, where each dictionary contains the start and end times (in seconds) and the text value for each subtitle. The alignment data ensures that subtitles appear at the correct time and for the appropriate duration in the video.


This parameter specifies the font family to be used for the subtitles. The font should be available in the system's font directory. Using a clear and legible font is crucial for readability.


This parameter determines the amount of displacement applied to the text position to avoid overlap. It is an integer value that adjusts the x and y coordinates of the text. The default value is typically set to ensure minimal overlap while maintaining readability.


This parameter controls the variation in font size to fit the text within the image boundaries. It is an integer value that adds or subtracts from the base font size. The default value ensures that the text remains legible without being too large or too small.


This parameter specifies the number of words to be displayed per subtitle. It helps in breaking down longer sentences into manageable chunks, enhancing readability and viewer comprehension.


This parameter sets the minimum font size for the subtitles. It ensures that the text remains legible even when space is limited. The default value is typically set to a size that is easily readable on most screens.


This parameter sets the maximum font size for the subtitles. It ensures that the text does not become too large, which could lead to overlap or exceed the image boundaries. The default value is chosen to balance readability and aesthetics.


This parameter specifies the frames per second (FPS) of the video. It is used to calculate the start and end frames for each subtitle based on the alignment data. Accurate FPS ensures that subtitles appear at the correct time.

Add Subtitles To Background Output Parameters:


This output parameter is a list of images with the subtitles added. Each image corresponds to a frame in the video, with the subtitles placed according to the alignment data and adjusted for readability and aesthetics.

Add Subtitles To Background Usage Tips:

  • Ensure that the background images are of high quality and have sufficient contrast with the subtitle text color to enhance readability.
  • Use a clear and legible font family to ensure that the subtitles are easy to read.
  • Adjust the text displacement and font size displacement parameters to avoid overlap and ensure that the text fits well within the image boundaries.
  • Break down longer sentences into shorter phrases using the num_words parameter to improve readability and viewer comprehension.

Add Subtitles To Background Common Errors and Solutions:

"Font not found"

  • Explanation: The specified font family is not available in the system's font directory.
  • Solution: Ensure that the font file is present in the system's font directory and that the font_family parameter is correctly specified.

"Image format not supported"

  • Explanation: The input images are in a format that is not compatible with the PIL library.
  • Solution: Convert the images to a supported format such as JPEG or PNG before using them as input.

"Text overlap detected"

  • Explanation: The subtitles are overlapping due to insufficient text displacement or inappropriate font size.
  • Solution: Increase the text_displacement and adjust the font_size_displacement parameters to ensure that the text does not overlap.

"Invalid alignment data"

  • Explanation: The alignment data is not in the correct format or contains invalid values.
  • Solution: Verify that the alignment data is a list of dictionaries with valid start, end, and value keys, and that the values are correctly specified.

Add Subtitles To Background Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI Whisper

© Copyright 2024 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals.