Metadata-Version: 2.1
Name: flippy
Version: 0.1.1
Summary: Build videos from image directories
Home-page: https://github.com/ecrows/flippy
Author: ecrows
License: MIT
Keywords: opencv video flipbook overlay python3 timelapse lapse flip flipy
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Video
Description-Content-Type: text/markdown
Requires-Dist: numpy
Requires-Dist: opencv-python

# flippy
Python script for generating videos by rapidly flipping through or overlaying images.

![Preview Example](https://i.imgur.com/LLKZpr5.gif)

## Requirements
* [OpenCV](https://opencv.org/)
* numpy

## Usage

Simple example:
```
flippy /some/image/path

INFO:root:Auto-detected image dimensions as 64x64...
INFO:root:Building fading timelapse of 24247 images in /some/path/faces...
INFO:root:Output settings: 64x64 @ 20.0 FPS
INFO:root:Successfully wrote video.avi
```

Slightly more complicated example:
```
flippy /some/image/path -o ~/output.avi -f 60.0 -c XVID -t blend

INFO:root:Auto-detected image dimensions as 64x64...
INFO:root:Building fading timelapse of 24247 images in /some/path/faces...
INFO:root:Output settings: 64x64 @ 60.0 FPS
INFO:root:Successfully wrote /home/user/output.avi
```

Console help:
```
usage: lapse.py [-h] [-v] [-f FPS] [-o OUTPUT] [-c CODEC] [-t TYPE] [-r REGEX]
                path [path ...]

Build a fading timelapse of overlayed images.

positional arguments:
  path                  path to read image files from

optional arguments:
  -h, --help            show this help message and exit
  -v, --verbose         verbose logging
  -f FPS, --fps FPS     frames per second
  -o OUTPUT, --output OUTPUT
                        output file
  -c CODEC, --codec CODEC
                        fourcc codec (DIVX, XVID, MJPG, X264, WMV1, WMV2)
  -t TYPE, --type TYPE  type of video (blend, flipbook, split)
  -r REGEX, --regex REGEX
                        file regex for images in path, default matches common
                        lowercase image extensions
```


