Skip to content

DenDmitriev/GrabShot

Repository files navigation

🇬🇧 🇷🇺

Cover

GrabShot

An application for capturing frames from videos and extracting colors.

Get it

Download on the Mac App Store

Content

Overview

OverviewEnGitHub.mov

Features

GrabQueue

Control panel. There are workspaces in the application

To select a workspace, use the tab navigation bar

ControlPanelOverview

To change the application settings, click on the gear

SettingsOverview

Video import

To get started with the video, import the files. There are several options for this:

Drag and drop files to the Grab queue tab

DropVideoOverview

Import files via the application menu

ImportVideoOverview

Image grabbing

After importing the video, you are taken to the capture queue tab

GrabQueueWork

The window consists of a table of imported videos. The first step is to select the export folder. Next, decide on the assortment, you can choose an excerpt or the whole.

GrabControlPanel

Specify the frame capture interval in seconds.

GrabPeriodOverview

Finally, click the Start button and manage the process.

ControlPanel

Result

Output

Shots

The resulting frames in the process are saved to disk at the specified path by the user in an automatically created folder with the same name as the video file. The name of the frames is the name of the video file with the timecode suffix. If the barcode saving switch is enabled in the settings, it will be saved in the same directory. At the end, a file explorer will open with the capture results folder.

Barcode

The resulting color barcode can be viewed by clicking on its field. The file is also saved to the frames folder.

StripView

Below are a few barcodes from different movies.

Import images

To automatically import captured frames, you can click on the context menu on the video

ImportFrames

Individual frames can be imported by dragging and dropping into the "Image Colors" tab:

DropImageOverview

Or through the application menu:

ImportImageOverview

Image Barcode

ImageStripOverview

Functionality to create a color barcode on an image. Going to the second tab with the photo icon, you need to import images by dragging them into the window. A side navigation bar with images will open. Once you select the one you want, you can see a preview of the barcode that was generated automatically. By clicking on a color cell of the barcode, you can manually select a color with an eyedropper and so on with each segment. To save the result, you must click the “Export” button for a single image or the “Export All” button for the entire queue.

The application offers several algorithms to extract colors.

  • Area Average. Finds the dominant colors of an image by using using a area average algorithm.
  • Dominant Color. Finds the dominant colors of an image by iterating, grouping and sorting pixels using a color difference formula.
  • Means Clustering. Finds the dominant colors of an image by using using a k-means clustering algorithm.
Algorithm

It is also possible to exclude white and black colors.

Flags

Result image barcode

Blade Runner 2049 00 45 00 Strip

Guardians of the Galaxy Vol  3 00 40 00 Strip

photo_2023-09-20 11 01 59 Strip

Settings

The operation of the application can be configured. The launch of the window for this lies in an intuitive place - in the upper panel of the system by clicking on the name of the program or by command ⌘ + ,.

settings

Or button on toolbar

SettingButton

The settings window is divided into two tabs.

Capture Settings

There is a slider to select the compression ratio of JPG images. And the switch for opening the folder with the resulting images at the end of the capture process.

GrabSettings

Barcode Settings

The barcode is needed for different tasks and what it should be should be determined by the user. The average color or colors are determined on each frame, their number can be selected. The resolution of the final image may need to be large or small, so there are margins for the size in pixels. The barcode settings for an image consist of the height of the resulting pattern and the number of middle pattern colors.

StripSettings Colors

Contributing

Contributions to GrabShot are always welcome. To see what is currently being worked on, you can go to the task manager. To report bugs and feature requests, open an issue. To contribute to the codebase, look at the backlog in the task manager and submit a feature request pull request. Join the development team.

Support

The support by email – dv.denstr@gmail.com.

License

This software uses code of FFmpeg licensed under the LGPLv2.1, compiled with a wrapper FFmpegKit.