A CLI to create videos overlaid with text.
Project description
ViralOverlay™
Add styled, timed text to videos 'n GIFs! Kinda like this:
Usage
vo [OPTIONS] FILEPATH OVERLAY_DATA
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"
Options:
-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.
Example
$ 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.
Installation
pip install viraloverlay
brew install ffmpeg # (if you don't have ffmpeg already)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
viraloverlay-0.178.tar.gz
(7.6 kB
view hashes)
Built Distribution
Close
Hashes for viraloverlay-0.178-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9a7be8898d7a7928a9f805e9f03497b8faa434ed22dfb47ca8c595c7ce24d0f1 |
|
MD5 | 75cf112210a436376cb4d0ebce260f11 |
|
BLAKE2b-256 | 45bb5107aada89e61400fbee38a9d1fdff23bf3b91ef8e552062473bae769ee3 |