Skip to content
Typography and StyleColor and EffectsPositioning and MarginsText TransformationBorders and Shadow
font_name : The name of the font to use for the subtitles. font_size : The size(px) of the fontspacing : Spacing(px) between charactersbold : Set to True for bold textitalic : Set to True for italic textunderline : Set to True for underlined textstrike_out : Set to True for strike-through text
primary_colour : The color of the main subtitle text. secondary_colour : The color used for karaoke or secondary effects. outline_colour : The color of the outline of the text.back_colour : The color of the subtitle background.
alignment : Alignment of subtitle. Accepts a value a type SubtitleAlignment margin_l : Sets margin area on left side of Subtitle box margin_r : Sets margin area on right side of Subtitle boxmargin_v : Sets margin area of top and bottom of Subtitle box
scale_x : Factor for scaling of the font horizontally scale_y : Factor for scaling of the font verticallyangle : Rotation angle(degress) of the text
border_style : Border style of subtitle. Accepts a value a type SubtitleBorderStyle outline : The width(px) of the outline around the text.shadow : The depth(px) of the shadow behind the text
VideoDB Documentation
- Pages
Guide: Subtitles
Adding Subtitles
This guide gives you an introduction to adding Subtitle Styles by showing you visual outputs of the configurations available for the SubtitleStyle class, such as
🛠️ Setup
📦 Installing packages
%pip install videodb
🔑 API Keys
import os
os.environ["VIDEO_DB_API_KEY"] = ""
🌐 Connect to VideoDB
from videodb import connect
conn = connect()
coll = conn.get_collection()
🎥 Upload Video
Upload a base video to add subtitle. For this guide, we’ll use following video
video = coll.upload(url="https://www.youtube.com/watch?v=il39Ks4mV9g")
video.play()
You can upload from your local file system too by passing file_path in upload()
🔊 Index Spoken Words
First, we need to index the video using () function.This ensures the availability of the transcript. Without this step VideoDB wouldn’t be able to add captions to any video.
video.index_spoken_words()
📝 Default Subtitles
To add subtitles to your video you can use () .
from videodb import play_stream
# Add Subtitle to Video
stream_url = video.add_subtitle()
# Play stream
play_stream(stream_url)
💅 Custom Styled Subtitles
To customise the style of subtitle, pass SubtitleStytle() with configured styles to ()
View API Reference for SubtitleStyle class 💅
1. Typography and Style
Configure Typography of the Subtitle by passing following parameters to SubtitleStyle() class
from videodb import SubtitleStyle, play_stream
stream_url = video.add_subtitle(
SubtitleStyle(
font_name = "Roboto",
font_size = 12,
spacing = 0,
bold = False,
italic = False,
underline = False,
strike_out = False
)
)
play_stream(stream_url)
2. Color and Effects
Configure color of Subtitle by passing following parameters to SubtitleStyle() class
Format of Color
SubtitleStyle accepts colors in the RR hexadecimal format, where the sequence represents the blue, green, and red components,
&H prefix is required in this color format.
And when transparency is needed, an alpha value is placed at the beginning, yielding BBGGRR.
from videodb import SubtitleStyle
stream_url = video.add_subtitle(
SubtitleStyle(
primary_colour = "&H00A5CFFF",
secondary_colour = "&H00FFFF00",
outline_colour = "&H000341C1",
back_colour = "&H803B3B3B",
)
)
play_stream(stream_url)
3. Position and Margins
Configure alignment and position of Subtitle by passing following parameters to SubtitleStyle() class
View API Reference to know more about SubtitleAlignment
from videodb import SubtitleStyle, SubtitleAlignment
stream_url = video.add_subtitle(
SubtitleStyle(
alignment = SubtitleAlignment.middle_center,
margin_l = 10,
margin_r = 10,
margin_v = 20,
)
)
play_stream(stream_url)
4. Text Transformation
Transform the text size and spacing by passing following parameters to SubtitleStyle() class
from videodb import SubtitleStyle
stream_url = video.add_subtitle(
SubtitleStyle(
scale_x = 1.5,
scale_y = 3,
angle = 0,
)
)
play_stream(stream_url)
5. Borders and Shadow
Add border style, outline and shadow by passing following parameters to SubtitleStyle() class
View API Reference to know more about SubtitleBorderStyle
from videodb import SubtitleStyle, SubtitleBorderStyle
stream_url = video.add_subtitle(
style=SubtitleStyle(
shadow=2,
back_colour="&H00000000",
border_style=SubtitleBorderStyle.no_border,
)
)
play_stream(stream_url)
👨💻 Next Steps
Check out the other resources and tutorials using Subtitle and Subtitle Styling 💅.
If you have any questions or feedback. Feel free to reach out to us 🙌🏼
Want to print your doc?
This is not the way.
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.