cinegraph 0.1.1

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
  • 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

The current run script can be invoked using:

$ poetry run exec 

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 exec
    cinegraph

SYNOPSIS
    poetry run exec <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

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
• 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.