Simple Python script to split video into equal length chunks
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
examples Added csv support. Sep 20, 2015
.gitignore Added csv support. Sep 20, 2015
LICENSE Initial commit Nov 20, 2014 add extra option for ffmpeg Mar 5, 2017 add extra option for ffmpeg Mar 5, 2017

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 -h to see the options. Here are few samples of how it could be used:

Spliting video into equal chunks

python -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 euqal chunks with some extra options

python -f -i 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.


        "start_time": 0,
        "length": 34,
        "rename_to": "video1"
        "start_time": 35,
        "length": 22,
        "rename_to": "video2.mp4"

Afterwards run:

python -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 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.


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 -f example.mp4 -s -v h264, may resolve this issue.

Installing ffmpeg

See FFmpeg installation guide for details.