motionkit-video-converter 0.1.1

CLI and Python helpers for converting videos into social-ready publishing profiles.

motionkit-video-converter

motionkit-video-converter is a Python CLI and library for converting videos into social-ready aspect-ratio profiles with local ffmpeg.

Part of the HappyHorse toolset: https://happyhorseai.im/

Install

pip install motionkit-video-converter

ffmpeg must already be available on your system PATH.

Requirements

• local ffmpeg
• Python 3.10+

CLI

Single conversion:

motionkit-video convert input.mp4 --profile reel --format mp4
motionkit-video convert clip.mov --profile square --mode pad --format webm

Batch conversion:

motionkit-video batch ./videos --profile story --format mp4 --output-dir ./dist
motionkit-video batch ./videos --profile landscape --recursive --mode crop

Python API

from motionkit_video_converter import batch_convert, convert_video

result = convert_video("input.mp4", profile="reel", output_format="mp4")

Profiles

• reel: 1080x1920
• story: 1080x1920
• square: 1080x1080
• landscape: 1920x1080

Rendering Modes

• crop: fill frame and center-crop
• pad: fit video inside frame and pad the rest

Website

• HappyHorse: https://happyhorseai.im/