---
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](https://runwayml.com/)

## 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

1. Clone this repository:

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

2. Install dependencies using Poetry:

   ```
   poetry install
   ```

3. Open shell:

   ```
   poetry shell
   ```

4. 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: <input_file>\_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: <input_file>\_converted.<ext>)
- `--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: <input_file>\_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.