add joining video files tutorial

Author: x4nth055

README.md

@@ -96,6 +96,7 @@ This is a repository of all the tutorials of [The Python Code](https://www.thepy
     - [How to Create a Watchdog in Python](https://www.thepythoncode.com/article/create-a-watchdog-in-python). ([code](general/directory-watcher))
     - [How to Extract Audio from Video in Python](https://www.thepythoncode.com/article/extract-audio-from-video-in-python). ([code](general/video-to-audio-converter))
     - [How to Combine a Static Image with Audio in Python](https://www.thepythoncode.com/article/add-static-image-to-audio-in-python). ([code](python-for-multimedia/add-photo-to-audio))
+    - [How to Concatenate Video Files in Python](https://www.thepythoncode.com/article/concatenate-video-files-in-python). ([code](python-for-multimedia/combine-video))
 
 
 - ### [Web Scraping](https://www.thepythoncode.com/topic/web-scraping)

python-for-multimedia/combine-video/README.md

@@ -0,0 +1,26 @@
+# [How to Concatenate Video Files in Python](https://www.thepythoncode.com/article/concatenate-video-files-in-python)
+To run this:
+- `pip3 install -r requirements.txt`
+- 
+```
+    $ python concatenate_video.py --help
+```
+**Output**:
+```
+    usage: concatenate_video.py [-h] [-c CLIPS [CLIPS ...]] [-r REDUCE] [-o OUTPUT]
+
+    Simple Video Concatenation script in Python with MoviePy Library
+
+    optional arguments:
+    -h, --help            show this help message and exit
+    -c CLIPS [CLIPS ...], --clips CLIPS [CLIPS ...]
+                            List of audio or video clip paths
+    -r REDUCE, --reduce REDUCE
+                            Whether to use the `reduce` method to reduce to the lowest quality on the resulting clip
+    -o OUTPUT, --output OUTPUT
+                            Output file name
+```
+- To combine `zoo.mp4` and `directed-by-robert.mp4` to produce `output.mp4`:
+```
+    $ python concatenate_video.py -c zoo.mp4 directed-by-robert.mp4 -o output.mp4
+```

python-for-multimedia/combine-video/concatenate_video.py

@@ -0,0 +1,41 @@
+from moviepy.editor import concatenate_videoclips, VideoFileClip
+
+
+def concatenate(video_clip_paths, output_path, method="compose"):
+    """Concatenates several video files into one video file
+    and save it to `output_path`. Note that extension (mp4, etc.) must be added to `output_path`
+    `method` can be either 'compose' or 'reduce':
+        `reduce`: Reduce the quality of the video to the lowest quality on the list of `video_clip_paths`.
+        `compose`: type help(concatenate_videoclips) for the info"""
+    # create VideoFileClip object for each video file
+    clips = [VideoFileClip(c) for c in video_clip_paths]
+    if method == "reduce":
+        # calculate minimum width & height across all clips
+        min_height = min([c.h for c in clips])
+        min_width = min([c.w for c in clips])
+        # resize the videos to the minimum
+        clips = [c.resize(newsize=(min_width, min_height)) for c in clips]
+        # concatenate the final video
+        final_clip = concatenate_videoclips(clips)
+    elif method == "compose":
+        # concatenate the final video with the compose method provided by moviepy
+        final_clip = concatenate_videoclips(clips, method="compose")
+    # write the output video file
+    final_clip.write_videofile(output_path)
+
+
+if __name__ == "__main__":
+    import argparse
+    parser = argparse.ArgumentParser(
+        description="Simple Video Concatenation script in Python with MoviePy Library")
+    parser.add_argument("-c", "--clips", nargs="+",
+                        help="List of audio or video clip paths")
+    parser.add_argument("-r", "--reduce", action="store_true", 
+                        help="Whether to use the `reduce` method to reduce to the lowest quality on the resulting clip")
+    parser.add_argument("-o", "--output", help="Output file name")
+    args = parser.parse_args()
+    clips = args.clips
+    output_path = args.output
+    reduce = args.reduce
+    method = "reduce" if reduce else "compose"
+    concatenate(clips, output_path, method)

python-for-multimedia/combine-video/directed-by-robert.mp4

@@ -0,0 +1 @@
+moviepy