Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

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 hashes
Filename, size viraloverlay-0.178.tar.gz (7.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page