YouTube Transcript Extraction CLI

A command-line tool for extracting transcripts from YouTube videos, playlists, and channels.

Features

• Extract transcripts from single YouTube videos
• Process entire playlists and channels
• Support for multiple languages
• Multiple output formats (TXT, JSON, SRT, XML)
• Configurable output options

Installation

Prerequisites

• Go 1.16 or higher
• YouTube Data API key (for playlist and channel processing)

Building from source

```bash

Clone the repository

git clone https://github.com/copyleftdev/yt-pull.git cd yt-pull

Build the binary

go build -o ytcli ./cmd/ytcli

Install the binary (optional)

go install ./cmd/ytcli ```

Configuration

Create a configuration file at ~/.ytcli/config.yaml or in the current directory:

```yaml

YouTube Data API key

apikey: "YOURAPIKEYHERE"

Default language for transcripts

default_language: "en"

Output formatting options

output: # Output format: txt, json, srt, or xml format: "txt" # Include timestamps in output timestamps: false # Include speaker identification if available speakers: true

Log verbosity (0-3, where 0 is silent and 3 is debug)

verbosity: 1 ```

Usage

Fetching a transcript from a single video

bash ytcli fetch --url "https://www.youtube.com/watch?v=VIDEO_ID" --lang "en"

Fetching transcripts from a playlist

bash ytcli fetch --url "https://www.youtube.com/playlist?list=PLAYLIST_ID" --output-dir "./transcripts"

Command-line options

• --url: YouTube URL (video, playlist, or channel)
• --lang: Language code (e.g., 'en', 'fr')
• --output-dir: Directory to save transcripts
• --format: Output format (txt, json, srt, xml)
• --timestamps: Include timestamps in output
• --verbose, -v: Enable verbose output
• --version: Display version information

Development

This project follows the GitFlow branching model. To contribute:

1. Set up the development environment: bash git clone https://github.com/copyleftdev/yt-pull.git cd yt-pull ./scripts/install-hooks.sh # Install Git hooks

2. Create a feature branch: ```bash ./scripts/git-flow-setup.sh --feature your-feature-name

   Make your changes...

   ```

3. Commit using conventional commit messages: bash git commit -m "feat(component): add new feature"

4. Create a pull request to the develop branch

See CONTRIBUTING.md for detailed guidelines.

License

MIT