https://github.com/607011/flippy

Generate flip-books from videos and animated GIFs
https://github.com/607011/flippy

animated-gifs flip-books flipbook fpdf frame python python3

Last synced: about 5 hours ago
JSON representation

Generate flip-books from videos and animated GIFs

• Host: GitHub
• URL: https://github.com/607011/flippy
• Owner: 607011
• License: gpl-3.0
• Created: 2016-02-03T18:30:45.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2022-12-25T11:59:36.000Z (almost 2 years ago)
• Last Synced: 2023-03-19T13:25:03.970Z (over 1 year ago)
• Topics: animated-gifs, flip-books, flipbook, fpdf, frame, python, python3
• Language: Python
• Size: 1.35 MB
• Stars: 3
• Watchers: 2
• Forks: 4
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# flippy

Generate flip-books from videos and animated GIFs

## Prerequisites

 - Python 3 or later

 - Pillow 3.x

 - FPDF 1.7.x or later

 

## Download code

[Download flippy.py](https://raw.githubusercontent.com/ola-ct/flippy/master/flippy.py) from the

[flippy repository](https://github.com/ola-ct/flippy), or do

```

git clone https://github.com/ola-ct/flippy.git

```

to clone the repository into a local folder.

## Installation

### macOS

You want to install [Brew](https://brew.sh) package manager first:

```

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

```

Then install pipenv to host a virtual environment:

```

brew install pipenv

```

Enter the project's directory and install the required modules into Pipenv's virtual environment:

```

cd flippy

pipenv install

```

You can now run flippy as shown below from inside the Pipenv shell (`pipenv shell`).

### Linux

Install [Pipenv](https://github.com/pypa/pipenv) with your distribution specific package manager.

Enter the project's directory and install the required modules into Pipenv's virtual environment:

```

cd flippy

pipenv install

```

You can now run flippy as shown below from inside the Pipenv shell (`pipenv shell`).

## Usage

### General usage

```

flippy.py 

  [-h] [--help]

  --input INPUT

  --output OUTPUT

  --height HEIGHT

  --paper {a2,a3,a4,a5,letter,legal}

  --offset

  --dpi DPI

  --fps FPS

```

`INPUT`: filename of video or GIF image to be converted

`OUTPUT`: name of file to write PDF to

`HEIGHT`: Height of flip-book (default: 30.0 mm)

`PAPER`: paper format (default: a3); only valid for PDF output

`OFFSET`: Margin left to each frame (default: 15.0 mm)

 

`DPI`: convert video/GIF to the given resolution in dots per inch (default: 200 dpi)

 

`FPS`: convert video/GIF to this many frames per second before PDF generation (default: 10 fps)