Automatic Description Generator

A Python CLI tool that automatically generates YouTube video titles, descriptions, and tags using AI (DeepSeek) and audio transcription (Whisper).

Features

• 🎤 Audio transcription with Whisper
• 🤖 AI-generated titles and descriptions (DeepSeek)
• 🏷️ SEO-optimized tag generation
• 📊 Tag popularity checking (YouTube API)
• ⏱️ Automatic timestamp extraction
• 📹 Support for YouTube Shorts

Requirements

• Python 3.8+
• FFmpeg
• API keys for DeepSeek and YouTube Data API

Installation

pip install -r requirements.txt

# Install FFmpeg (macOS)
brew install ffmpeg

Setup

Create an api_keys.txt file:

DEEPSEEK_API_KEY=your_deepseek_api_key
YOUTUBE_API_KEY=your_youtube_api_key

Usage

# From YouTube URL
python adg.py "https://youtube.com/watch?v=..."

# From local video file
python adg.py -l video.mp4

# Transcription only
python adg.py "https://youtube.com/watch?v=..." -to

# YouTube Short format
python adg.py "https://youtube.com/shorts/..." -s

# Custom summary length
python adg.py "https://youtube.com/watch?v=..." --summary_length 3

# Save to file
python adg.py "https://youtube.com/watch?v=..." -o description.txt

Arguments

Argument	Description
url	YouTube video URL
-l, --local-file	Local video file path
-o, --output	Output file path
-s, --short	YouTube Short format
-to, --transcribeonly	Output transcription only
--summary_length	Summary sentences (1-3)
--ai_api_key	Override DeepSeek API key
--youtube_api_key	Override YouTube API key

Output

Generated description includes:

• AI-generated title
• SEO-optimized summary
• Timestamps (for regular videos)
• Popularity-ranked tags

License

MIT License - see LICENSE for details.