📖 About

Stream Clipper is a desktop application that automatically detects highlight moments in streaming videos (Twitch, YouTube, etc.) using audio analysis and chat activity detection. Perfect for content creators, streamers, and video editors who want to quickly find and export the best moments from long streams.

Why Stream Clipper?

• ⏱️ Save Hours of Editing - No more scrubbing through hours of footage
• 🎯 Smart Detection - Uses audio spikes and chat activity to find highlights
• 🚀 Fast Processing - Analyzes videos 10-50x faster than realtime
• 💻 Offline & Private - All processing happens locally on your machine
• 🎨 Modern UI - Clean, intuitive interface built with Svelte

✨ Features

Core Features

Detection Methods

🎵 Audio Analysis

• RMS Volume Detection - Detects loud moments (cheering, reactions)
• Voice Activity Detection - Uses WebRTC VAD to detect speech patterns
• Configurable Sensitivity - Adjust threshold to find more or fewer highlights

💬 Chat Analysis (Pro)

• Twitch JSON - Parse chat logs from TwitchDownloader
• YouTube JSON - Parse chat logs from yt-dlp
• Generic TXT - Support for [HH:MM:SS] user: message format
• Keyword Detection - Custom keywords like "POG", "CLIP IT", "OMG"
• Activity Spikes - Detect moments when chat goes crazy

🎯 Highlight Scoring

• Combo Detection - Audio + Chat overlap = higher score
• Weighted Scoring - Customize importance of audio vs chat
• Smart Merging - Combine adjacent highlights automatically

📥 Installation

Windows

1. Download the latest release from Releases
2. Run Stream Clipper_x.x.x_x64-setup.exe (NSIS installer) or Stream Clipper_x.x.x_x64_en-US.msi
3. Follow the installation wizard
4. Launch Stream Clipper from Start Menu

macOS

Coming soon! Build from source for now.

Linux

Coming soon! Build from source for now.

Build from Source

Prerequisites

• Node.js 18+
• Rust 1.70+
• Tauri CLI

Steps

# Clone the repository
git clone https://github.com/nirvagold/stream-clipper.git
cd stream-clipper

# Install dependencies
npm install

# Run in development mode
npm run tauri dev

# Build for production
npm run tauri build

🚀 Usage

Quick Start

1. Import Video - Drag & drop or click to browse for your video file
2. Import Chat (Optional, Pro) - Add chat log for better detection
3. Adjust Settings - Configure audio sensitivity and other options
4. Analyze - Click "Analyze Video" to detect highlights
5. Review - Preview detected clips in the timeline
6. Export - Select clips and export to your desired format

Supported Formats

Video Input

• MP4, MKV, MOV, AVI, WebM, FLV, TS

Chat Input (Pro)

• Twitch JSON (from TwitchDownloader)
• YouTube JSON (from yt-dlp)
• Generic TXT ([HH:MM:SS] username: message)

Export Output

• MP4 (H.264 + AAC)
• WebM (VP9 + Opus) - Pro only

Tips for Best Results

1. Lower sensitivity = More highlights detected
2. Use chat logs when available for better accuracy
3. Adjust padding to include context before/after highlights
4. Preview clips before exporting to verify quality

🛠️ Tech Stack

Stream Clipper is built with modern, performant technologies:

Architecture

┌─────────────────────────────────────────────────────────────┐
│                    STREAM CLIPPER APP                       │
├─────────────────────────────────────────────────────────────┤
│  FRONTEND (Svelte + TypeScript)                             │
│  - Reactive UI Components                                   │
│  - State Management (Svelte stores)                         │
│  - Tauri IPC calls                                          │
├─────────────────────────────────────────────────────────────┤
│  BACKEND (Rust + Tauri)                                     │
│  - Audio Analysis (RMS + VAD)                               │
│  - Chat Parsing (Twitch/YouTube/TXT)                        │
│  - Highlight Scoring & Merging                              │
│  - Video Clipping (FFmpeg wrapper)                          │
│  - License Validation                                       │
├─────────────────────────────────────────────────────────────┤
│  EXTERNAL                                                   │
│  - FFmpeg (bundled)                                         │
└─────────────────────────────────────────────────────────────┘

🤝 Contributing

We welcome contributions from the community! Here's how you can help:

Ways to Contribute

• 🐛 Report Bugs - Open an issue with detailed reproduction steps
• 💡 Suggest Features - Share your ideas in discussions
• 📝 Improve Docs - Help make documentation clearer
• 🔧 Submit PRs - Fix bugs or implement features

Development Setup

1. Fork the repository
2. Clone your fork:

   git clone https://github.com/YOUR_USERNAME/stream-clipper.git
   

3. Create a feature branch:

   git checkout -b feature/amazing-feature
   

4. Make your changes
5. Run tests and linting:

   npm run check
   cd src-tauri && cargo clippy
   

6. Commit your changes:

   git commit -m "feat: add amazing feature"
   

7. Push to your fork:

   git push origin feature/amazing-feature
   

8. Open a Pull Request

Commit Convention

We use Conventional Commits:

• feat: - New feature
• fix: - Bug fix
• docs: - Documentation changes
• style: - Code style changes (formatting, etc.)
• refactor: - Code refactoring
• perf: - Performance improvements
• test: - Adding or updating tests
• chore: - Maintenance tasks

Code Style

• Rust: Follow rustfmt and clippy recommendations
• TypeScript/Svelte: Follow ESLint and Prettier configurations
• Commits: Use conventional commit messages

📋 Roadmap

v0.2.0 (Planned)

• macOS and Linux builds
• Batch processing multiple videos
• Custom export presets
• Keyboard shortcuts

v0.3.0 (Future)

• Auto-caption with Whisper
• Direct upload to YouTube/TikTok
• Game-specific detection (kill feed OCR)
• Smart vertical crop with face detection

❓ FAQ

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Tauri - For the amazing desktop framework
• Svelte - For the reactive UI framework
• FFmpeg - For video processing capabilities
• WebRTC VAD - For voice activity detection