Metadata-Version: 2.4
Name: happy-horse-1.0-video-converter-py
Version: 0.1.0
Summary: CLI and Python helpers for video format conversion with ffmpeg.
Project-URL: Homepage, https://tryhappyhorse.com/
Author: Happyhorse
License-Expression: MIT
License-File: LICENSE
Keywords: cli,converter,ffmpeg,happyhorse,video
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Video :: Conversion
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

# happy-horse-1.0-video-converter-py

CLI and Python helpers for converting videos with local `ffmpeg`.

Part of the Happyhorse toolset: [tryhappyhorse.com](https://tryhappyhorse.com/)

## Install

```bash
pip install happy-horse-1.0-video-converter-py
```

## Requirements

This package requires `ffmpeg` to be installed and available on `PATH`.

If `ffmpeg` is installed but not on `PATH`, you can point the package to it
with the `FFMPEG_PATH` environment variable.

Example:

```bash
ffmpeg -version
```

## CLI Usage

```bash
hh-video convert input.mp4 --to webm
hh-video convert demo.mov --to mp4 --output ./dist/demo.mp4
hh-video batch ./videos --to gif
hh-video batch ./videos --to mp4 --output-dir ./dist --recursive
```

## Python API

```python
from happyhorse_video_converter import batch_convert, convert_video

result = convert_video('input.mp4', 'webm')
summary = batch_convert('./videos', 'gif', recursive=True)
```

## Features

- Convert a single file to `webm`, `mp4`, or `gif`
- Batch convert a directory
- Continue batch processing even if one file fails
- Expose the same workflow through CLI and Python API

## Website

- [Happyhorse](https://tryhappyhorse.com/)

## License

MIT
