Quick Start

cargo install dialog_detective

Available on crates.io

Download from GitHub Releases

Pre-built binaries for macOS, Linux, and Windows

macOS: Metal GPU acceleration • Linux/Windows: CPU-only (build from source for GPU support)

git clone https://github.com/jakobwesthoff/DialogDetective.git
cd DialogDetective
cargo build --release

FFmpeg

Required for audio extraction. ffmpeg.org

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

# Windows: Download from https://ffmpeg.org/download.html

AI CLI (install one)

Gemini CLI (recommended) or Claude Code

Whisper Models

Downloaded automatically on first run from HuggingFace.

Requirements

DialogDetective requires external tools to function:

FFmpeg - for audio extraction from video files
Gemini CLI or Claude Code - for AI-powered episode matching

See the Prerequisites tab above for installation instructions.

Basic Usage

# Dry run - preview what would happen
dialog_detective ./videos "Breaking Bad" -s 1

# Rename files in place
dialog_detective ./videos "Breaking Bad" --mode rename -s 1

# Copy to organized directory
dialog_detective ./videos "Breaking Bad" --mode copy -o ./organized -s 1

# List available Whisper models
dialog_detective --list-models