Frame-Slice

Frame-Slice is a Python utility for extracting frames from video files based on two different methods: scene change detection and fixed frame intervals. It leverages the OpenCV library to process video files and export frames as images.

Features

Scene Change Detection: Extract frames when a significant change in the scene is detected, using a configurable threshold.
Fixed Frame Intervals: Extract frames at regular intervals, specified by a frame interval value.

Installation

Clone the repository:

git clone https://github.com/montoulieu/frame-slice.git

Change to the frame-slice directory:
```
cd frame-slice
```
Install the required dependencies:
```
pip install -r requirements.txt
```
Note: It is recommended to use a virtual environment to prevent conflicts with other installed Python packages.

Usage

Run the frame_slice.py script with the desired mode, video path, output folder, and threshold or frame interval:

For scene change mode:

python frame_slice.py scene <video_path> <output_folder> <threshold>

For interval mode:

python frame_slice.py interval <video_path> <output_folder> <frame_interval>

Replace <video_path> with the path to the video file, <output_folder> with the path to the folder where the extracted frames will be saved, <threshold> with the scene change detection threshold, and <frame_interval> with the number of frames between extracted frames in interval mode.

Examples

Using the provided test.mp4 video in the /video folder, you can test the utility by extracting frames to the /output/test folder: