Skip to main content

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

Project description

GitHub code size in bytes License: CC0-1.0 Python versions: 3.3 and above PyPI

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, cropping

Feature 1, extending

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 catframes_fix_resolution aligns the frames to the left-top corner.

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.

A change to approximately the same aspect ratio

Feature 2.1

Feature 2.1

A change to a very different aspect ratio

Feature 2.2

Feature 2.2

Requirements

  1. Python 3

  2. ImageMagick

  3. FFmpeg

Installation

On Unix-like systems:

sudo python3 -m pip install --prefix /usr/local --force-reinstall catframes

Usage

All these scripts scan JPEG and PNG files in a folder based on the file name extensions, not their signatures.

  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.

$ catframes_most_common_image_resolution_in_the_folder [--statistics|-s]

1280x720 => 3
800x800 => 2
-------------
Completed in 0.023589134216308594 seconds.
$ var1=`catframes_most_common_image_resolution_in_the_folder`
$ echo $var1
1280x720

But this script renames corrupted images as well.

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

catframes-0.3.1.tar.gz (6.5 kB view hashes)

Uploaded Source

Built Distribution

catframes-0.3.1-py3-none-any.whl (10.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page