Metadata-Version: 2.4
Name: motionkit-video-converter
Version: 0.1.0
Summary: CLI and Python helpers for converting videos into social-ready publishing profiles.
Project-URL: Homepage, https://github.com/shippomiru
Project-URL: Repository, https://github.com/shippomiru
Author: Shippo
License-Expression: MIT
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`.

## Install

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

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

## 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
