Metadata-Version: 2.4
Name: motionkit-video-converter
Version: 0.1.1
Summary: CLI and Python helpers for converting videos into social-ready publishing profiles.
Project-URL: Homepage, https://happyhorseai.im/
Author: Shippo
License-Expression: MIT
Keywords: cli,converter,ffmpeg,happyhorse,social-video,video
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Multimedia :: Video :: Conversion
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: typer<1.0,>=0.12
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# 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

```bash
pip install motionkit-video-converter
```

`ffmpeg` must already be available on your system `PATH`.

## Requirements

- local `ffmpeg`
- Python 3.10+

## CLI

Single conversion:

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

Batch conversion:

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

## Python API

```python
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/
