Command Line Video Splitter
Simple command line Python script that splits video into multi chunks. Under the hood script uses FFMpeg so you will need to have that installed. No transcoding or modification of video happens, it just get's split properly.
Run python ffmpeg-split.py -h
to see the options. Here are few samples of how it could be used:
Spliting video into equal chunks
python ffmpeg-split.py -f big_video_file.mp4 -s 10
This splits big_video_file.mp4
into chunks, and the size of chunk is 10 seconds. Each chunk will be suffixed with numeric index, for example big_video_file-0.mp4
, big_video_file-1.mp4
, etc.
Spliting video into equal chunks with some extra options
python ffmpeg-split.py -f input.mp4 -s 600 -v libx264 -e '-vf "scale=320:240" -threads 8'
This splits input.mp4
into chunks, and the size of chunk is 600 seconds. With extra option to scale output to 320:240
and use 8 threads to speed up.
Splitting videos into unequal chunks
In order to create unequal chunks of a video, you'll need to create manifest.json.
manifest.json
[
{
"start_time": 0,
"length": 34,
"rename_to": "video1"
},
{
"start_time": 35,
"length": 22,
"rename_to": "video2.mp4"
}
]
Afterwards run:
python ffmpeg-split.py -f big_video_file.mp4 -m manifest.json
This splits big_video_file.mp4
into 2 video files, video1.mp4 and video2.mp4. The video1.mp4 is a 34 seconds
clip, starting from 0:00 to 0:34 of the big_video_file.mp4
.
Alternatively, you can use a manifest.csv file to accomplish the task above.
manifest.csv:
start_time,length,rename_to
0,34,video1
35,22,video2
Manifest Options
- start_time - number of seconds into the video or start time
- length - length of the video in seconds. The end time of the video is calculated by the start_time plus the length of the video.
- rename_to - name of the video clip to be saved
- end_time - end time of the video
Additional Arguments
- -v or --vcodec ffmpeg video codec to be used.
- -a or --acodec ffmpeg audio codec to be used.
- -m or --manifest manifest file to control the splitting of videos.
- -f or --file video file to split.
- -s or --split-size seconds to evenly split the videos
- -e or --extra extra optional options for ffmpeg, e.g. '-e -threads 8' to use 8 threads to speed up.
- -S or --split-filesize Split or chunk size in bytes (approximate). e.g -S 1048576 will split into files under 1 Megabyte
Notes:
The -s and -m options should not be used together. If they are, -m option takes precedent over the -s option
Known Issues with ffmpeg
- There might be some videos that aren't showing properly after splitting the source video with ffmpeg. To resolve
this, use the -v option and pass in the associated video codec for the source video or video format. For example, mp4 videos
use h264 video codec. Therefore, running the command
python ffmpeg-split.py -f example.mp4 -s -v h264
, may resolve this issue.
Installing ffmpeg
See FFmpeg installation guide for details.