captametropolis 1.0.6

Add Automatic Captions to YouTube Shorts with AI

Captametropolis

INFO: This is forked from Captacity.

Just like Captacity but BIGGER!

Add automatic captions to YouTube Shorts (and other videos) using Whisper and MoviePy!

Requirements

• Install the latest verion of FFmpeg (make sure it's in your PATH)

• Install the latest version of ImageMagick. Make sure to tick both boxes during installation:

  • Install legacy utilities (e.g. convert)
  • Add application directory to your system PATH

Quick start

After installing the requirements, enter your terminal and run the following commands:

$ pip install captametropolis -U
$ captametropolis <video_file> <output_file>

INFO: You need to run register_font in administrator mode to be able to use custom fonts because it has to inject your fonts into the ImageMagick font directory. See the below example for more information.

Run this command in administrator mode once to register your font (you can also run it normally, but you will be prompted to run it in administrator mode):

$ captametropolis register_font "path/to/your/font.ttf" -qr

or programmatically:

from captametropolis.utils import register_font

register_font("path/to/your/font.ttf", quiet_run=True) # Will also ask for admin rights (UAC panel)

Programmatic use

import captametropolis

captametropolis.add_captions(
    video_file="my_short.mp4",
    output_file="my_short_with_captions.mp4",
    font_path="path/to/your/font.ttf", # Now you can use your custom font here
    ...
)

Custom configuration

import captametropolis

captametropolis.add_captions(
    video_file="my_short.mp4",
    output_file="my_short_with_captions.mp4",

    font_path = "/path/to/your/font.ttf",
    font_size = 130,
    font_color = "yellow",

    stroke_width = 3,
    stroke_color = "black",

    shadow_strength = 1.0,
    shadow_blur = 0.1,

    highlight_current_word = True,
    highlight_color = "red",

    line_count=1,

    rel_width = 0.8,
)

Using Whisper locally

By default, OpenAI Whisper is used locally if the openai-whisper package is installed. Otherwise, the OpenAI Whisper API is used. If you want to force the use of the API, you can specify use_local_whisper=False in the arguments to captametropolis.add_captions:

import captametropolis

captametropolis.add_captions(
    video_file="my_short.mp4",
    output_file="my_short_with_captions.mp4",
    use_local_whisper=False,
)

You can install Captametropolis with pip install captametropolis[local] to install Whisper locally as well.