Media Downloader

🎬 Media Downloader

Smart media downloader - Automatically search and download images/video clips based on your description, with auto-trimming support.

[🇨🇳 中文文档](./README_CN.md)

---

🚀 What Can I Do?

You say...	I will...
"Download some cute cat pictures"	Search and download 5 cat images
"Find a 15-second ocean wave video"	Download a 15s ocean wave clip
"Get me a 30-second cooking video"	Download a trimmed cooking clip
"Download this YouTube video from 1:30 to 2:00"	Download and auto-trim the specified segment

---

✨ Features

• 🖼️ Image Download - Search HD images from professional stock libraries
• 🎬 Video Clips - Get free commercial-use video footage
• 📺 YouTube Download - Download and trim support
• ✂️ Smart Trimming - Auto-crop to your desired length
• 🌍 Bilingual - Supports both Chinese and English commands

---

⚡ One-Line Install

In Claude Code, just say:

**"Help me install https://github.com/yizhiyanhua-ai/media-downloader.git and all its dependencies, and configure yt-dlp to use browser cookies"**

Claude will automatically:

• Download the skill to the correct location
• Install yt-dlp, ffmpeg and other dependencies
• Configure browser cookies (fixes YouTube "confirm you're not a bot" issue)
• Check installation status

Just click "Allow" when Claude asks for permission!

---

🔑 About API Keys

💡 **On-Demand Configuration**: No API Key needed during installation!

• YouTube Videos: No API Key required, works right after installation
• Image Downloads: Claude will guide you to configure Pexels API Key on first use

What Happens When You First Download Images?

When you first say "Download some cat pictures", Claude will:

1. Detect that you haven't configured a stock photo API Key yet
2. Guide you to register at https://www.pexels.com (Google/Apple quick signup supported)
3. Help you get the API Key and automatically save it