video-grid-merge

This project allows you to use FFmpeg to arrange video files stored in a specified folder in a grid layout of NxN and generate the output.

Pytest Coverage Comment

pytest-html

pytest-cov

Screenshot

input video files

sample1.mov, sample2.mov, sample3.mov, sample4.mov

Note

• This project supports Mac, Linux, and WSL2 as operating systems, but not Windows.
• The video file generation process depends on the number of input videos (square root is an integer and must be greater than or equal to 2).
• For example, 4 videos will be placed in a 2x2 layout, and 9 videos will be placed in a 3x3 layout.
• Input videos should be stored in the input folder.
• The output video is created by looping and merging according to the longest video among the input videos, and stored in the output folder.
• The videos are arranged alphabetically from top left to top right and from bottom left to bottom right.
• To specify the placement, prefix it with a number.
• Target input and output video file formats are MP4 and MOV.

Usage

Installing FFmpeg

In order to execute the code, FFmpeg must be installed and accessible via the $PATH environment variable.

There are a variety of ways to install FFmpeg, such as the official download links, or using your package manager of choice (e.g. sudo apt install ffmpeg on Debian/Ubuntu, brew install ffmpeg on OS X, etc.).

Regardless of how FFmpeg is installed, you can check if your environment path is set correctly by running the ffmpeg command from the terminal, in which case the version information should appear, as in the following example (truncated for brevity):

$ ffmpeg
ffmpeg version 4.2.7-0ubuntu0.1 Copyright (c) 2000-2022 the FFmpeg developers
  built with gcc 9 (Ubuntu 9.4.0-1ubuntu1~20.04.1)

Note
The actual version information displayed here may vary from one system to another; but if a message such as ffmpeg: command not found appears instead of the version information, FFmpeg is not properly installed.

Environment building

Standard Version

• If you are using poetry, please execute the following command

git clone --filter=blob:none --no-checkout https://github.com/7rikazhexde/video-grid-merge.git && cd video-grid-merge && git sparse-checkout init --cone && git sparse-checkout set video_grid_merge && git checkout
poetry install --only main

Development version

• It includes a static analysis tool and test data that performs the following

git clone https://github.com/7rikazhexde/video-grid-merge.git
cd video-grid-merge
poetry install

Settings

• Input videos should be stored in the Input folder.
• Specify the resolution of the output video.
• The following two patterns are available for specifying the resolution. (Default is 1)
  1. Expand the number of Input Video: match_input_resolution_flag = True e.g. 4 Videos Input (640x360) -> 1 Video Output (1280x720)
  2. Resize based on Input Video: match_input_resolution_flag = False e.g. 4 Videos Input (640x360) -> 1 Video Output (640x360)

Choosing between v1 and v2

This tool provides two versions of the ffmpeg command generation function: create_ffmpeg_command (v1) and create_ffmpeg_command_v2 (v2). You should choose the version that best suits your needs:

1. create_ffmpeg_command_v1 - Default

• Uses the ultrafast preset for very rapid encoding
• Applies volume normalization to each input audio stream
• Uses sophisticated audio mixing with dropout transition and volume adjustment
• Best for quick processing where encoding speed is the top priority, while maintaining good audio quality

2. create_ffmpeg_command_v2

• Uses the medium preset with CRF 23 for a balance of speed, quality, and file size
• Applies volume normalization and sophisticated audio mixing (same as v1)
• Recommended for cases where file size and quality are important, but processing time is not critical

All versions now include:

• Effective mixing of audio from all input videos
• Volume normalization for consistent audio levels
• Enhanced audio clarity and reduced distortion in the final output

To select a version, use the corresponding function in your code. If you're unsure:

• Use v1 for the fastest processing with good audio quality
• Use v2 when file size and overall quality are priorities

Example

• Command Execution Result Example

$ python video_grid_merge
Enter the name of the output file (default is 'combined_video.mov'): test
Input Video Time List: [63.96, 62.43, 48.31, 77.83]
Video Grid Merge Start
Video Grid Merge End And Output Success
File Output Complete: ./video_grid_merge/media/output/test.mov
Processing Time(s): 16.33857367

Other

Delete temporary data

if you delete temporary data files in the specified folder

• poetry

poetry run task vgmrm

• Not poetry

python video_grid_merge/delete_files.py