Skip to main content

A CLI to create videos overlaid with text.

Project description


Add styled, timed text to videos 'n GIFs! Kinda like this:




OVERLAY_DATA: a JSON file path OR a JSON-formatted string containing an
array of overlays, each containing key-value pairs of at least "text",
"start", and "stop". optional keys: "font_size", "font_color",
"text_position_x", and "text_position_y"

  -g, --gif             output to GIF instead of MP4
  -f, --font-path TEXT  path to the font you'd like to use.
  --help                Show this message and exit.


$ vo <path_to_video> <json_transcript_filepath_or_string> [--gif --font]

(lots of ffmpeg output...)
Okay, I overlaid your text on <path_to_video_overlaid>.

JSON Transcript Format

The json_transcript string or file should look like this:

        "start": 1.03,
        "stop": 1.21,
        "text": "I"
        "start": 1.21,
        "stop": 1.44,
        "text": "am"
        "start": 1.45,
        "stop": 1.84,
        "text": "saying"
        "start": 1.85,
        "stop": 2.25,
        "text": "some"
        "start": 2.25,
        "stop": 2.97,
        "text": "words"

See sibling projects Transcribe all the Things and tpro for easy, automatic generation of such transcripts.


pip install viraloverlay
brew install ffmpeg  # (if you don't have ffmpeg already)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for viraloverlay, version 0.178
Filename, size File type Python version Upload date Hashes
Filename, size viraloverlay-0.178-py3-none-any.whl (9.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size viraloverlay-0.178.tar.gz (7.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page