metadata

title: Video Splitter
emoji: 📚
colorFrom: pink
colorTo: pink
sdk: gradio
sdk_version: 5.3.0
app_file: app.py
pinned: false
license: mit
short_description: 'Split videos into 5s or 10s chunks for usage with AI models '

AI Video Editor CLI Tool

A CLI tool for simple video editing tasks: splitting videos, combining videos, replacing audio, and generating thumbnails. Very useful for working with video-to-video AI models like Runway

Getting Started

Prerequisites

Python 3.8 or higher
Poetry (for dependency management)
ffmpeg (for video processing), e.g. on MacOS use brew install ffmpeg

Installation

Clone this repository:

git clone https://github.com/marcusschiesser/ai-video-cli.git
cd ai-video-cli

Install dependencies using Poetry:
```
poetry install
```
Open shell:
```
poetry shell
```

Run the tool:

cd <directory_with_videos>
ai-video [command] [arguments]

Commands

The AI Video Editor CLI tool supports the following commands:

1. Split Video

Splits a video into chunks.

ai-video split <input_file> [--chunk_size {5,10}]

<input_file>: Path to the input video file
--chunk_size: Chunk size in seconds (default: 10)

Example:

ai-video split my_long_video.mp4 --chunk_size 5

This command will split my_long_video.mp4 into 5-second chunks. The output files will be named my_long_video_part1.mp4, my_long_video_part2.mp4, and so on.

2. Combine Videos

Combines multiple videos into one.

ai-video combine <output_file> <input_files>... [--codec CODEC]

<output_file>: Path to the output video file
<input_files>: One or more input video files to combine
--codec: Optional codec to use for the output video (e.g., 'libx264')

Example:

ai-video combine final_video.mp4 part1.mp4 part2.mp4 part3.mp4

This command will combine part1.mp4, part2.mp4, and part3.mp4 into a single video file named final_video.mp4. The videos will be concatenated in the order they are specified.

3. Replace Audio

Replaces the audio of a video with the audio from another video.

ai-video replace_audio <input_video> <audio_video> [output_file]

<input_video>: Path to the input video file whose audio will be replaced
<audio_video>: Path to the video file from which the audio will be extracted
[output_file]: Optional path for the output video file with replaced audio

Example:

ai-video replace_audio original_video.mp4 audio_source.mp4 final_video.mp4

This command will take the video from original_video.mp4, replace its audio with the audio from audio_source.mp4, and save the result as final_video.mp4.

If you don't specify an output file, the tool will automatically generate one.

4. Generate Thumbnail

Generates a thumbnail image from the first frame of a video.

ai-video thumbnail <input_file> [--output_file <output_file>]

<input_file>: Path to the input video file
--output_file: Optional path for the output thumbnail file (default: _thumbnail.jpg)

Example:

ai-video thumbnail my_video.mp4

This command will generate a thumbnail from the first frame of my_video.mp4 and save it as my_video_thumbnail.jpg.

5. Convert Video

Converts a video to specific video and audio codecs, with optional cropping.

ai-video convert <input_file> [output_file] [--video_codec VIDEO_CODEC] [--audio_codec AUDIO_CODEC] [--crop_width CROP_WIDTH] [--crop_height CROP_HEIGHT]

<input_file>: Path to the input video file
[output_file]: Optional path for the output video file (default: _converted.)
--video_codec: Video codec to use (default: libx264)
--audio_codec: Audio codec to use (default: aac)
--crop_width: Width to crop the video (default: 1280)
--crop_height: Height to crop the video (default: 768)

Example:

ai-video convert input_video.mp4 output_video.mp4 --video_codec libx265 --audio_codec mp3 --crop_width 1920 --crop_height 1080

This command will convert input_video.mp4 to output_video.mp4, using the libx265 video codec and mp3 audio codec. It will also resize and crop the video to 1920x1080 pixels. If the input video's aspect ratio doesn't match 1920x1080, the video will be scaled to fit within these dimensions and centered.

If you don't specify an output file, the tool will automatically generate one with the suffix "_converted" added to the input filename.

6. AI Segment Video

Segments people in a video using AI models (YOLO and SAM2) and replaces the background with green.

ai-segment <input_file> <output_file>

<input_file>: Path to the input video file
<output_file>: Path for the output segmented video file

Example:

ai-segment input_video.mp4 segmented_output.mp4

This command will process input_video.mp4 using YOLO for person detection and SAM2 for segmentation. It will create a new video segmented_output.mp4 where all detected people are segmented, and the background is replaced with green.

Note: This command requires additional AI models (YOLO and SAM2) which will be downloaded automatically on first use. The process may take some time depending on the length of the video and your hardware capabilities.

7. Extract Audio

Extracts the audio from a video file.

ai-video extract_audio <input_file> [output_file]

<input_file>: Path to the input video file
[output_file]: Optional path for the output audio file (default: _audio.mp3)

Example:

ai-video extract_audio my_video.mp4

This command will extract the audio from my_video.mp4 and save it as my_video_audio.mp3. If you don't specify an output file, the tool will automatically generate one with the suffix "_audio.mp3" added to the input filename.