Vibedit - Conversational AI Video Editor

AI-powered video editing through natural language conversation

Vibedit is a command-line tool that transforms video editing into a natural conversation. Describe what you want to do with your video in plain English, and let AI handle the complex FFmpeg commands behind the scenes.

🎉 Successfully Published: Available as an NPM package for global installation and use.

Links

• 📦 NPM Package Page: npmjs.com/package/vibedit
• ⬇️ Direct Download: vibedit-1.0.0.tgz
• 🐙 GitHub Repository: github.com/AryanSaxenaa/Vibe-Editor
• 🐛 Issues & Support: GitHub Issues

Features

Conversational Interface

• Natural Language Processing - Describe video editing tasks in plain English
• Smart Context Detection - Automatically finds video files mentioned in your requests
• Intelligent Clarification - Only asks follow-up questions when necessary
• Continuous Workflow - Handle multiple videos and operations in one session

AI-Powered Processing

• Groq AI Integration - Fast natural language understanding and command generation
• FFmpeg Backend - Access to professional video processing capabilities
• Automatic File Management - Smart output naming and conflict resolution
• Error Recovery - Graceful handling of processing errors with retry options

Supported Operations

• Format Conversion - Convert between MP4, AVI, MOV, WebM, and more
• Video Effects - Apply filters like black & white, speed adjustments
• Clip Extraction - Extract specific time ranges or durations
• Audio Extraction - Extract audio tracks to MP3 or other formats
• Video Resizing - Change resolution and aspect ratios
• Compression - Optimize file sizes for different platforms

Quick Start

Installation

npm install -g vibedit

Prerequisites

• Node.js 18+ - Download
• FFmpeg - Required for video processing (installation guidance provided during setup)
• Groq API Key - Get free key

Setup & Usage

vibedit

Automatic Setup Assistance:

• On installation, the postinstall script checks for FFmpeg and provides platform-specific installation instructions
• On first run, you'll be prompted to enter your Groq API key
• The tool guides you through the complete setup process

FFmpeg Installation (if needed):

• Windows: winget install ffmpeg or download from ffmpeg.org
• macOS: brew install ffmpeg
• Linux: sudo apt install ffmpeg

Examples

Basic Operations

# Convert video format
What would you like to do with your video?
> Convert my-video.avi to MP4 format

# Apply effects  
What would you like to do with your video?
> Make vacation.mov black and white and speed up by 2x

# Extract clips
What would you like to do with your video?
> Extract 30 seconds starting at 1:15 from presentation.mp4

# Extract audio
What would you like to do with your video?
> Extract audio from concert.mp4

Interactive Session Example

$ vibedit

Vibedit 1.0.0 - AI-Powered Video Editor
Just tell me what you want to do - I'll figure it out!

What would you like to do with your video?
> Make my vacation video black and white and speed up by 2x

[SUCCESS] Found vacation.mp4 (45.2MB)
[THINKING] Understanding your request...
[PROCESSING] Processing your video...
..................
[SUCCESS] Video processed successfully!
[COMPLETE] Done! Saved as: vacation_edited.mp4

What would you like to do with your video?
> quit

[DONE] Thanks for using Vibedit! Happy editing!

API Reference

Supported Commands

Format Conversion

• "Convert [file] to MP4/AVI/WebM format"
• "Change [file] to any video format"

Video Effects

• "Make [file] black and white"
• "Speed up [file] by [factor]x"
• "Slow down [file] by [factor]x"

Clip Extraction

• "Extract [duration] starting at [time] from [file]"
• "Trim [file] from [start] to [end]"
• "Extract the first/last [duration] from [file]"

Audio Operations

• "Extract audio from [file]"
• "Remove audio from [file]"

Resizing

• "Resize [file] to [width]x[height]"
• "Scale [file] to [resolution]"

Time Format Support

• Seconds: 30, 90
• MM:SS: 1:30, 2:45
• HH:MM:SS: 1:15:30, 0:02:15

Configuration

Automatic Setup (Post-Install)

When you install vibedit, the postinstall script automatically:

• Checks for FFmpeg - Detects if FFmpeg is already installed on your system
• Provides Installation Guidance - Shows platform-specific commands to install FFmpeg if needed
• Setup Instructions - Displays next steps to get started with Vibedit

API Key Setup

On first run, Vibedit will prompt you to enter your Groq API key:

1. Visit console.groq.com
2. Create a free account
3. Generate an API key
4. Paste it when prompted

The key is securely stored in ~/.vibedit-config.json.

Reset Configuration

vibedit
# Then type: "reset api key"

Troubleshooting

Common Issues

FFmpeg not found

# Install FFmpeg first:
# Windows: Download from https://ffmpeg.org/
# macOS: brew install ffmpeg  
# Linux: sudo apt install ffmpeg

API Key Issues

# Get a new key from https://console.groq.com/
# Use "reset api key" command in vibedit

File Not Found

• Use full file paths
• Ensure the file exists and isn't in use
• Check file permissions

Contributing

Development

git clone https://github.com/AryanSaxenaa/Vibe-Editor.git
cd Vibe-Editor
npm install
node vibedit.js

Issues and Feature Requests

Please report issues and request features at: https://github.com/AryanSaxenaa/Vibe-Editor/issues

License

MIT License - see LICENSE file for details.

Acknowledgments

• Groq - For providing fast AI language processing
• FFmpeg - For powerful video processing capabilities
• Node.js Community - For excellent tooling and ecosystem