FPV Video Editor CLI

A simple TypeScript-based CLI tool to process and join AVI files for YouTube upload. Designed for low-quality FPV footage where small file size is preferred.

Features

1. Join Videos: Combine all .avi files in a directory into a single MP4.
2. Convert for YouTube: Convert AVI files to YouTube-optimized MP4 (H.264/AAC).
3. Audio Management: Strip audio from a video or replace it with background music.

Prerequisites

• Node.js: v14 or later.
• FFmpeg: Must be installed on your system.
  • Mac: brew install ffmpeg
  • Linux: sudo apt install ffmpeg

Installation

git clone https://github.com/bit-shift-io/fpv-video-editor.git
cd fpv-video-editor
npm install

Usage

You can run the tool using npx ts-node src/index.ts.

1. Join AVI files in a directory

npx ts-node src/index.ts join ./data -o ./full_session.mp4

2. Convert to YouTube format

npx ts-node src/index.ts convert ./full_session.mp4

3. Strip audio (not needed, just use step 4)

npx ts-node src/index.ts audio ./full_session.mp4

4. Replace audio with music

npx ts-node src/index.ts audio ./full_session.mp4 -r ./music/music.mp3

Developer notes

• Built with commander, fluent-ffmpeg, ora, and chalk.
• Uses TypeScript for safety and speed.