name: yt2txt description: "CLI tool for transcribing YouTube videos to text. Use when: you need a transcript of a YouTube video. Requires: OPENROUTER_API_KEY env var, yt-dlp installed." homepage: https://github.com/kakkoii1337/gai-cli-yt2txt

yt2txt

CLI tool for transcribing YouTube videos to text. Downloads audio via yt-dlp and transcribes using OpenRouter API with a multimodal model.

Requirements

• Node.js >= 18.0.0
• Python
• yt-dlp (pip install yt-dlp)
• OpenRouter API key

Installation

npm install -g gai-cli-yt2txt

Or run directly:

npx gai-cli-yt2txt "https://youtu.be/..."

Configuration

Set your OpenRouter API key:

export OPENROUTER_API_KEY=your-api-key-here

Or in a .env file in the working directory:

OPENROUTER_API_KEY=your-api-key-here

Usage

yt2txt <youtube-url> [options]

Arguments

• youtube-url - YouTube video URL (required)

Options

• --model=<model> - OpenRouter model to use (default: openrouter/healer-alpha)
• --quality=<0-5> - Audio quality (0 = best, 5 = worst, default: 0)
• --output=<file> - Save transcription to file instead of stdout
• --keep-mp3 - Keep the downloaded MP3 after transcription
• --help, -h - Show help message

Examples

# Transcribe to stdout
yt2txt "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

# Save to file
yt2txt "https://youtu.be/dQw4w9WgXcQ" --output=transcript.txt

# Keep MP3 and use lower quality for faster download
yt2txt "https://youtu.be/dQw4w9WgXcQ" --keep-mp3 --quality=2

# Use a specific transcription model
yt2txt "https://youtu.be/dQw4w9WgXcQ" --model=openrouter/healer-alpha

Output Format

Transcription is printed to stdout (or saved to --output file):

Hello, welcome to this video. Today we'll be talking about...

Environment Variables

• OPENROUTER_API_KEY - Required. Your OpenRouter API key.
• YT_DLP_PATH - Optional. Custom path to yt-dlp executable.