🚀 Quick Install

Recommended: Via Marketplace

# Add the marketplace
/plugin marketplace add kanopi/claude-toolbox

# Install Training Video Generator
/plugins install training-video-generator@claude-toolbox

💡 Quick Example

# 1. Analyze your project for video topics
/video-topics

# 2. Generate a beat-by-beat script
/video-script "Getting Started with Installation"

# 3. Generate automation scripts for recording
/video-automate scripts/video-scripts/installation-beat-sheet.md

# 4. Record video (run generated AppleScript)
# (Execute the generated automation script)

# 5. Generate TTS narration
/video-narrate scripts/video-scripts/installation-beat-sheet.md

# 6. Merge video + audio
/video-merge installation

# Output: output/installation-final.mp4

🎯 Commands Overview

🛠 What Gets Generated

Beat-by-Beat Script

## Beat 1: Introduction
**Duration**: 10 seconds
**Visual**: Terminal - iTerm2
**Narration**: "Welcome to Project Name..."
**Terminal Commands**:
```bash
cd ~/Projects/example

Browser Actions: Navigate to localhost:3000

### Automation Scripts
- **AppleScript** for iTerm2 terminal automation
- **Bash scripts** for command orchestration
- **Browser automation** for Safari/Chrome
- **Recording control** scripts

### TTS Audio
- Individual audio clips per beat
- Master audio file with proper timing
- Support for multiple TTS providers

### Final Video
- Professional MP4 with h264 encoding
- Synced audio and video
- Optional intro/outro branding
- Optimized for web playback

---

## 📋 Requirements

### Required

- **Claude Code CLI** - To run the plugin commands
- **Git** - For version control
- **FFmpeg** - For video/audio processing
  - macOS: `brew install ffmpeg`
  - Linux: `sudo apt-get install ffmpeg`

### Optional

- **iTerm2** - For better terminal automation (macOS)
- **ElevenLabs API Key** - For premium TTS (recommended)
- **OpenAI API Key** - For OpenAI TTS
- **ScreenFlow** - For advanced screen recording features
- **Python 3.x & MkDocs** - For building/contributing to documentation

---

## 🎬 Use Cases

- **Open Source Projects** - Tutorial videos for contributors
- **Product Documentation** - Feature demo videos
- **API Documentation** - Code walkthrough videos
- **Internal Tools** - Team training videos
- **Workshops & Training** - Educational content
- **Client Deliverables** - Professional demo videos

---

## 🔧 TTS Providers

Training Video Generator supports multiple TTS providers:

### ElevenLabs (Recommended)
- **Quality**: Exceptional natural voices
- **Setup**: Requires API key
- **Cost**: Pay-per-use
- **Best for**: Professional videos

### OpenAI TTS
- **Quality**: Very good natural voices
- **Setup**: Requires API key
- **Cost**: Pay-per-use
- **Best for**: High-quality at scale

### macOS `say` Command
- **Quality**: Good built-in voices
- **Setup**: No configuration needed
- **Cost**: Free
- **Best for**: Testing and quick videos

---

## 📖 Learn More

Visit the **[complete documentation](https://kanopi.github.io/training-video-generator/)** for:

- Detailed command reference
- Step-by-step workflows
- Beat sheet writing guide
- Customization options
- Troubleshooting tips
- Example videos

---

## 🤝 Contributing

Contributions welcome! See [Contributing Guide](https://kanopi.github.io/training-video-generator/contributing/) for details.

---

## 📄 License

GPL-2.0-or-later - see [LICENSE.md](LICENSE.md) file for details.

---

## 💬 Support

- **Issues**: [GitHub Issues](https://github.com/kanopi/training-video-generator/issues)
- **Documentation**: [https://kanopi.github.io/training-video-generator/](https://kanopi.github.io/training-video-generator/)