A Plex metadata agent plugin for fetching metadata of movies and TV series from downloaded YouTube videos. It works by looking up metadata using YouTube video IDs, supporting both local .info.json files and online API lookups.
One-Minute Overview#
YouTube-Agent.bundle is a Plex metadata agent plugin specifically designed to organize and manage videos downloaded from YouTube. Whether you're looking to整理 game playthroughs, tutorial videos, or collected series, this tool automatically adds accurate titles, descriptions, posters, and other information to make them look like professional movies in Plex. It's perfect for gamers, collectors, or anyone who wants to organize YouTube videos into a structured media library.
Core Value: Converts scattered YouTube videos into a structured professional media library with automatically fetched official metadata
Quick Start#
Installation Difficulty: Medium - Requires manual plugin installation and API key setup
# 1. Download the Zip file
wget https://github.com/ZeroQI/YouTube-Agent.bundle/archive/refs/heads/master.zip
# 2. Unpack and rename
unzip YouTube-Agent.bundle-master.zip
mv YouTube-Agent.bundle-master Youtube-Agent.bundle
# 3. Place in plugin directory
cp -r Youtube-Agent.bundle /path/to/Plex\ Media\ Server/Plug-ins/
# 4. Restart Plex Media Server
Is this suitable for my use case?
- ✅ Game playthrough collection: Automatically fetch game information, covers and descriptions
- ✅ Tutorial video organization: Categorize technical tutorials with proper metadata
- ❌ Large-scale commercial use: May be limited by YouTube API quotas
- ❌ "Out-of-the-box" simplicity: Requires manual API key configuration
Core Capabilities#
1. Multiple ID Format Support - Recognizing various YouTube video IDs#
Supports multiple naming formats including [xxxxxxxx], [youtube-xxx], etc., and can automatically identify YouTube video IDs in filenames.
Real Value: No need to rename大量已下载的视频 files, just ensure the ID is included in the filename
2. Dual Metadata Sources - Combining local and cloud data#
Prioritizes metadata from .info.json files to reduce YouTube API calls, while also supporting online API for the latest information.
Real Value: Reduces API quota consumption, speeds up loading, while maintaining metadata freshness
3. Movie & Series Support - Full media format support#
Supports both movie and TV series media types with dedicated agents for each library type (YoutubeMovie and YouTubeSeries). Real Value: One installation meets all YouTube video organization needs, no additional plugins required
Technical Stack & Integration#
Development Language: Python (common for Plex agents) Main Dependencies: YouTube Data API Integration Method: Plex plugin system
Maintenance Status#
- Development Activity: Actively maintained with regular updates to support YouTube API changes
- Recent Updates: Continuous bug fixes and feature additions
- Community Response: Provides technical support through GitHub and Plex forums
Commercial & Licensing#
License: Open source
- ✅ Commercial use: Permitted
- ✅ Modifications: Permitted
- ⚠️ Restrictions: Must comply with YouTube Terms of Service
Documentation & Learning Resources#
- Documentation Quality: Comprehensive
- Official Documentation: Built-in README
- Example Code: Provides file naming conventions and directory structure examples