A smart media downloader that automates the search and download of images and video clips based on user descriptions. It targets users needing quick access to visual assets, offering features like auto-trimming and integration with stock media libraries and YouTube, all managed through a conversational AI interface.

How It Works

The project employs natural language processing to interpret user requests, translating them into searches across professional stock photo libraries (Pexels, Pixabay, Unsplash) and YouTube. It supports downloading specific video segments and automatically trimming clips to a desired length. A key design choice is its deep integration with Claude, enabling conversational installation, dependency management, and API key configuration, simplifying the setup process significantly.

Quick Start & Requirements

• Primary install / run command: Installation is designed to be performed within Claude by issuing the command: "Help me install https://github.com/yizhiyanhua-ai/media-downloader.git and all its dependencies, and configure yt-dlp to use browser cookies".
• Non-default prerequisites and dependencies: yt-dlp and ffmpeg are required. ffmpeg is essential for video trimming functionality. For image downloads, a Pexels API Key is needed on first use, with Claude guiding users through registration and configuration. Optional API keys for Pixabay and Unsplash can also be configured.
• Estimated setup time or resource footprint: The initial setup process via Claude is described as taking "just a few minutes."
• Links: GitHub repository: https://github.com/yizhiyanhua-ai/media-downloader.git. Pexels: https://www.pexels.com.

Highlighted Details

• Conversational Installation: Seamless setup and dependency management directly within the Claude AI environment.
• On-Demand API Configuration: Guided setup for stock photo API keys (Pexels, Pixabay, Unsplash) upon first use.
• YouTube Bot Bypass: Automatic configuration of yt-dlp with browser cookies to resolve YouTube's "confirm you're not a bot" issue.
• Commercial Use: Media assets from Pexels, Pixabay, and Unsplash are licensed for free commercial use without attribution.

Maintenance & Community

No specific details regarding maintainers, sponsorships, partnerships, or community channels (like Discord/Slack) are provided in the README. Interaction appears primarily facilitated through the Claude AI platform.

Licensing & Compatibility

• License type: MIT License.
• Compatibility notes: The MIT license is highly permissive, allowing for commercial use, modification, and distribution, making it compatible with closed-source projects.

Limitations & Caveats

The project's primary interface relies on the Claude AI environment, which may limit accessibility for users not utilizing this platform. Image search functionality is contingent on the correct configuration of API keys. Video trimming requires the ffmpeg executable to be installed and accessible.