catframes 1.0.1

It concatenates a directory with images into a video via FFmpeg.

Features

1. Fixing unstable frame size

Some software for some reason may save a part of frames with negligible cropping (about 8 pixels).

Feature 1, cropping

Feature 1, extending

Even if this is not your case (it scales the image, for instance), if a resolution was changed to very close one, it’s still better to use cropping/extending on video, than scaling, to prevent further quality loss.

The script aligns the frames to the left-top corner. You can use --color1 argument to adjust the background color.

2. Fixing the case, one changes camera settings during a day

A video file has a static resolution, but a camera resolution may be changed. If the change is small, this case will be indistinguishable from the previous one. But the considerable changes can be processed another way.

Aspect ratio difference < 0.45

In this case, the program will ignore aspect ratio and distort the frames.

To disable this, please use [-A|--never-change-aspect-ratio] argument. You can combine this with --color2 argument.

Aspect ratio difference >= 0.45

In this case, the program will add margins. You can use --color2 argument to adjust their color.

Requirements

1. Python 3

2. pip

3. ImageMagick

4. FFmpeg

Installation

On Ubuntu 18.10 and most of Linux distributions:

sudo python3 -m pip install --prefix /usr/local --upgrade catframes

On Windows/ReactOS:

pip install catframes

Usage

This script scans JPEG and PNG files in a folder based on the file name extensions, not their signatures.

You can also run the internal subtasks separately:

1. catframes_fix_resolution ensures, that all images in the current directory have the same resolution.

   1. Finds out, what resolution is most common in this directory.

      1. Renames corrupted images to {original_filename}_corrupted.

   2. Converts all the pictures in place to this resolution.

2. catframes_to_video [--delete-images] [-o pathToFile.mp4] compresses them all to a single video file with 1 frame per second. Please, use catframes_to_video [--help] for more information.

You can also use Catframes to detect common resolution in a folder. This is a subtask of catframes_fix_resolution.

$ catframes_most_common_image_resolution_in_the_folder [--statistics|-s]

1280x720 => 3
800x800 => 2
-------------
Completed in 0.11370372772216797 seconds.

                   Method | Result
 ------------------------ | ---------------
                       mf | 1280x720
                    gtewa | 1280x800

$ var1=`catframes_most_common_image_resolution_in_the_folder`
$ echo $var1
1280x720

Disclaimer

I make no representations or warranties of any kind concerning the software, express, implied, statutory or otherwise, including without limitation warranties of title, merchantability, fitness for a particular purpose, non infringement, or the absence of latent or other defects, accuracy, or the present or absence of errors, whether or not discoverable, all to the greatest extent permissible under applicable law.