RingVideo

Transform videos into engaging social media content with circular overlays and automatic captions.

Features

• Circular video masking with dynamic backgrounds
• Automatic captions with word highlighting
• Animated speaker and customized information (e.g. logo)

Quick Start

1. Install dependencies:

pip install -r requirements.txt

2. Configure your project:

   • Edit file paths and settings in config.py
   • Update speaker info, colors, and positioning
   • Set input video, background video, and logo paths

3. Run

python main.py                    # High quality output (default)
python main.py --edit-captions    # Edit captions interactively
python main.py --config my_config.py
python main.py --dev              # Low quality for faster development builds

Development

TODO:

• Align both NAME_POSITION and TITLE_POSITION automatically.

License

MIT License. Copyright (c) 2025 Tiago Vignatti.