Mp4 Video Combiner
Python script that assist in concatenating mp4 video files into a single larger file and automatically create named chapter marks at each join making it really easy to skip forward and backwards within the video file.
All video files created by this tool are fully compatible and play without errors on Xbox 360/One, PS4 and all major video players on desktop or mobile.
Currently this script has only been developed for use on Windows but I welcome any and all pull requests. So if you feel you can improve the OS compatability I'd appreciate your help.
This script solves long outstanding feature requests for the GPAC toolkit such as #325
Details and discussions can also be found on my blog.
- Simple usage
- Advanced usage
Before first use make sure you install all requirements using
pip install -r requirements.txt
Assuming you have a bunch of videos named "clipXX.mp4" in a folder called videos then this is how you feed all of them into script and have it automagically combine all the files and place nice chapter marks at the seams.
python combine.py --match "D:\videos\clip*" -o "D:\videos\all_clips.mp4"
For all options supported by this tool run
python combine.py -h
Assuming you have a large 16GB list of Barbie Mp4 video files in a folder. Now you'd like to burn them all to a DVD to play on your XBox or Playstation computer. However the list of files is much greater than what can fit on a single DVD disk.
The script can automatically segment the output files according to known DVD and BluRay disk sizes using the
--disk command line argument
python combine.py --match "D:\barbie\*.mp4" -o "D:\toburn\Barbie.mp4" --disk dvd8
This will create the original output file and then also split files based on your maximum size
D:\toburn\Barbie.mp4 D:\toburn\Barbie_001.mp4 D:\toburn\Barbie_002.mp4 D:\toburn\Barbie_003.mp4
Now you can burn each individual split file to a dvd.
The disk settings supported are
You can also specify a custom file size using the
--size argument. The example below limits the output file size to 800MB.
python combine.py -m "D:\barbie\*.mp4" -o "D:\toburn\Barbie.mp4" --size 800MB
--size argument supports multiple format endings such as 'MB' for megabytes and 'GB' for gigabytes. If nothing is specified then 'MB' is assumed. You can also specify fractional sizes such as '15.5GB'.
If you intend to play the files on your Xbox console then you need to limit the file size to be no more than
4GB. This file limit is imposed by the FAT32 file system (see Q12).
Handling input videos of different sizes
If the input videos are not of the same width or height then the script will automatically attempt to scale all of the source material to
1024x576 resolution. This scaling size can be configured using the
Below is a command that forces a
1280 x 720 HD resolution for all input files. Files with smaller resolution will be upscaled and those with larger resolutions will be downscaled.
python combine.py -m "D:\barbie\*.mp4" -o "D:\toburn\Barbie.mp4" --videosize "1280:720"
Ensure you separate the dimensions with the colon character
Overwriting existing files
If the output file exists the script will by default print an error and terminate without doing anything. To silently overwrite existing files with the same file name you can use the
python combine.py -m "D:\barbie\*.mp4" -o "D:\toburn\Barbie.mp4" --disk dvd8 --overwrite
Shuffling the list of files
By default the files are concatinated in order by their filename. In case you want to randomize their order (e.g. if you're creating a shuffled playlist type of file) you can use the
python combine.py -m "D:\videos\*.mp4" -o "D:\toburn\Shuffle.mp4" --disk dvd4 --shuffle
Providing a cut point file as an input
The script can cut beginning and endings of files automatically if a cut point file is provided using the
The file format is simple comma separated file on the form
FILE_NAME_WITH_EXTENSION, START_TIME_CODE, END_TIME_CODE
Example cuts file (cutinfo.txt)
Barbie1.mp4, 00:33, 01:01 Barbie2.mp4, 00:50, 1:45
Then to perform the cuts, run the following command
python combine.py -m "D:\barbie\*.mp4" -o "D:\toburn\Barbie.mp4" --cuts "D:\toburn\cutinfo.txt"
Will produce an output file (Barbie.mp4) of total 1:23 duration where the first 28 seconds are from Barbie1.mp4 and the remaining 55 seconds are from Barbie2.
Merging videos containing soft subtitles
When merging videos containing subtitle tracks then the
--burnsubs option can be specified so that the resulting combined file will have the default subtitle track embedded in the video.
It is not currently possible to merge soft subtitles (subtitles on separate tracks).
Disabling audio in output video
By default the script will attempt to merge both video and audio tracks from the source videos. If one or more of the source videos have no audio tracks then the script will fail with an error similar to
Stream specifier ':a' in filtergraph description .... matches no streams.
You can use the
--noaudio switch to force the script to skip all audio tracks from the source videos and only produce an output video of the merged video tracks.
The below example will produce a completely silent video file
python combine.py --match "D:\barbie\*.mp4" -o "D:\toburn\Barbie_silent.mp4" --noaudio
I welcome any and all suggestions and fixes either through the issue system above or through pull-requests.
Although this project is small it has a code of conduct that I hope everyone will do their best to follow when contributing to any aspects of this project. Be it discussions, issue reporting, documentation or programming.
If you don't want to open issues here on Github, send me your feedback by email at email@example.com.
"Be excellent to each other"