cinegraph 0.1.2

A CLI tool that creates a kaleidescope-esque gradient image of your favorite movie.

A CLI tool that creates a kaleidescope-esque gradient image of your favorite movie.

· Installation ·

📝 Table of Contents

• 📝 Table of Contents
• 🧐 About
• 🖥️ Screenshots
• 💨 Quickstart
  • Flags
• 💾 Installation
  • From PyPi
    • Install steps
  • From GitHub Repo Clone
    • Prerequsites
    • Install steps
• ⛏️ Tech Stack
• ✍️ Authors
• 🎉 Acknowledgements

🧐 About

A CLI tool that creates a kaleidescope-esque gradient image of your favorite movie.

🖥️ Screenshots

Total Recall

Elysium

Pacific Rim

Star Trek Into Darkness

Edge of Tomorrow

Example Write Frames

💨 Quickstart

If you are running from the repository Cinegraph can be invoked using:

$ poetry run cinegraph 

or if you are running from a pip installation you should have the CLI command available:

$ cinegraph

If you do not provide any positional arguments to specify input files it will automatically open a Tkinter file picker, you need to have a capable display window provider (if using WSL Xserver is a great option.)

Additionally you can run it with the following flags:

Flags

NAME
    poetry run cinegraph
    cinegraph

SYNOPSIS
    poetry run cinegraph <flags> [FILES]...
    cinegraph <flags> [FILES]...
POSITIONAL ARGUMENTS
    FILES
        The files that you want to be processed.

FLAGS
    -c,--colors=COLORS
        Number of colors in the Cinegraph
        Example Input:
            100
    -b,--blur=BLUR
        Blur amount for the Cinegraph
        Example Input:
            5
    -r,--resolution=RESOLUTION
        Resolution for the Cinegraph
        Example Input:
            1000,1200
    -n,--no_frame=NO_FRAME
        Remove the white border + frame for the Cinegraph
    -m,--margin=MARGIN
        Set the margin (in pixels) for the border around the Cinegraph
        e.g. 25
    -w,--write_frames=WRITE_FRAMES
        Output the frames with a center square that denotes the dominant color.

💾 Installation

From PyPi

Install steps

1. Install using pip: pip install cinegraph
2. You will then have the CLI command available to you:

$ cinegraph

From GitHub Repo Clone

Prerequsites

1. Python and Python Poetry is installed

Install steps

1. poetry install (To install in the top level directory always: poetry config virtualenvs.in-project true)

⛏️ Tech Stack

• Python - Software Development
• Poetry - Package Management
• OpenCV - Image Processing
• Fire - CLI Framework

✍️ Authors

🎉 Acknowledgements

• @FFMPEG for providing amazing open source video solutions.
• The Colors of Motion for being the inspiriation and the idea that I tried my best to mimic.