Metadata-Version: 2.1
Name: videotoframes
Version: 1.1.4
Summary: A simple Python script to break videos into frames.
Home-page: https://github.com/brandonschabell/videotoframes
Author: Brandon Schabell
Author-email: brandonschabell@gmail.com
License: MIT
Download-URL: https://github.com/brandonschabell/videotoframes/archive/v1.1.4.tar.gz
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Multimedia :: Video :: Conversion
Classifier: Topic :: Utilities
Requires-Python: ~=3.4
Description-Content-Type: text/markdown
Requires-Dist: opencv-python
Requires-Dist: tqdm
Provides-Extra: tests
Requires-Dist: pytest ; extra == 'tests'

# VideoToFrames

[![PyPI version](https://badge.fury.io/py/videotoframes.svg)](https://badge.fury.io/py/videotoframes)
[![PyPI pyversions](https://img.shields.io/pypi/pyversions/videotoframes.svg)](https://pypi.python.org/pypi/videotoframes/)
[![Build Status](https://travis-ci.com/brandonschabell/videotoframes.svg?branch=master)](https://travis-ci.com/brandonschabell/videotoframes)
[![codecov](https://codecov.io/gh/brandonschabell/videotoframes/branch/master/graph/badge.svg)](https://codecov.io/gh/brandonschabell/videotoframes)
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/526793a7c9a24f4282cd97c1655dca86)](https://app.codacy.com/app/brandonschabell/videotoframes?utm_source=github.com&utm_medium=referral&utm_content=brandonschabell/videotoframes&utm_campaign=Badge_Grade_Dashboard)

A simple Python script to break videos into frames. This package does 
**_NOT_ require ffmpeg**.

## Installation
VideoToFrames requires Python 3.4+

```bash
pip install videotoframes
```

## Example Usage:
VideoToFrames can be run from any command prompt or imported into a Python 
project.

Assuming there is a video at `./videos/example.mp4` and you want to create 
frames in `./frames`:

```bash
videotoframes -i ./vidoes/example.mp4 -o ./frames
```

If you want to create a limited number of frames that are evenly distributed:

```bash
videotoframes -i ./videos/example.mp4 -o ./frames --max-frames=20 --even
```

You can also use VideoToFrames with many videos at once:

```bash
videotoframes -i ./videos -o ./frames
```

Using VideoToFrames in a Python project:
```python
from videotoframes import convert

video_base_64 = '...'
frames = convert(video_base_64=video_base_64, max_frames=10, frame_rate=1)
```

## GitHub Project
https://github.com/brandonschabell/videotoframes

## PyPi Project
https://pypi.org/project/videotoframes/

### Contact

Please feel free to email me at brandonschabell@gmail.com with any questions or feedback.


