Simplify Playwright downloader to use YouTube Studio interface

Co-authored-by: sgbaird <45469701+sgbaird@users.noreply.github.com>

Author: Copilot

src/ac_training_lab/video_editing/README_playwright.md

@@ -1,16 +1,15 @@
 # Playwright YouTube Downloader
 
-This module provides an alternative method for downloading YouTube videos using Playwright browser automation. This is particularly useful for downloading private or unlisted videos from owned channels that may not be accessible via traditional methods like yt-dlp.
+This module provides a lean method for downloading YouTube videos using Playwright browser automation and YouTube Studio interface. This is particularly useful for downloading private or unlisted videos from owned channels that may not be accessible via traditional methods like yt-dlp.
 
 ## Features
 
 - **Browser Automation**: Uses Playwright to automate a real browser session
 - **Google Account Login**: Automatically logs into a Google account to access owned videos
-- **Native YouTube Interface**: Uses YouTube's built-in download functionality
-- **Quality Selection**: Supports selecting video quality (720p, 1080p, etc.)
+- **YouTube Studio Interface**: Uses the three-dot ellipses menu in YouTube Studio for downloads
+- **Simple Configuration**: Minimal environment variables needed
 - **Multiple Videos**: Can download multiple videos in sequence
 - **Integration**: Integrates with existing yt-dlp functionality
-- **Flexible Configuration**: Environment variable based configuration
 
 ## Installation
 
@@ -23,16 +22,14 @@ playwright install chromium
 
 ## Configuration
 
-Set up your credentials and preferences using environment variables:
+Set up your credentials using environment variables:
 
 ```bash
 # Required credentials
 export GOOGLE_EMAIL="your-email@gmail.com"
 export GOOGLE_PASSWORD="your-app-password"
 
 # Optional settings
-export YT_DOWNLOAD_DIR="./downloads"
-export YT_DEFAULT_QUALITY="720p"
 export YT_HEADLESS="true"
 export YT_PAGE_TIMEOUT="30000"
 export YT_DOWNLOAD_TIMEOUT="300"
@@ -52,13 +49,12 @@ export YT_CHANNEL_ID="UCHBzCfYpGwoqygH9YNh9A6g"
 ```python
 from ac_training_lab.video_editing.playwright_yt_downloader import download_youtube_video_with_playwright
 
-# Download a single video
+# Download a video from YouTube Studio
 downloaded_file = download_youtube_video_with_playwright(
-    video_id="dQw4w9WgXcQ",
+    video_id="cIQkfIUeuSM",  # Example video ID from ac-hardware-streams
     email="your-email@gmail.com",
     password="your-app-password",
-    download_dir="./downloads",
-    quality="720p",
+    channel_id="UCHBzCfYpGwoqygH9YNh9A6g",  # ac-hardware-streams channel
     headless=True
 )
 
@@ -75,7 +71,6 @@ from ac_training_lab.video_editing.playwright_yt_downloader import YouTubePlaywr
 with YouTubePlaywrightDownloader(
     email="your-email@gmail.com",
     password="your-app-password",
-    download_dir="./downloads",
     headless=False  # Show browser for debugging
 ) as downloader:
 
@@ -84,12 +79,13 @@ with YouTubePlaywrightDownloader(
         downloader.navigate_to_youtube()
 
         # Download multiple videos
-        video_ids = ["video1", "video2", "video3"]
-        results = downloader.download_videos_from_list(video_ids, quality="1080p")
+        video_ids = ["cIQkfIUeuSM", "another_video_id"]
+        channel_id = "UCHBzCfYpGwoqygH9YNh9A6g"  # ac-hardware-streams
 
-        for video_id, file_path in results.items():
-            if file_path:
-                print(f"✓ {video_id}: {file_path}")
+        for video_id in video_ids:
+            result = downloader.download_video(video_id, channel_id)
+            if result:
+                print(f"✓ {video_id}: {result}")
             else:
                 print(f"✗ {video_id}: Failed")
 ```
@@ -108,8 +104,7 @@ manager = YouTubeDownloadManager(use_playwright=True)
 result = manager.download_latest_from_channel(
     channel_id="UCHBzCfYpGwoqygH9YNh9A6g",
     device_name="Opentrons OT-2",
-    method="playwright",  # or "ytdlp"
-    quality="720p"
+    method="playwright"  # or "ytdlp"
 )
 
 if result['success']:
@@ -123,9 +118,9 @@ else:
 ```bash
 # Download specific video with Playwright
 python -m ac_training_lab.video_editing.integrated_downloader \
-    --video-id dQw4w9WgXcQ \
-    --method playwright \
-    --quality 720p
+    --video-id cIQkfIUeuSM \
+    --channel-id UCHBzCfYpGwoqygH9YNh9A6g \
+    --method playwright
 
 # Download latest from channel with yt-dlp
 python -m ac_training_lab.video_editing.integrated_downloader \
@@ -143,26 +138,25 @@ python -m ac_training_lab.video_editing.integrated_downloader \
 
 1. **Browser Launch**: Starts a Chromium browser instance with download settings
 2. **Google Login**: Navigates to Google sign-in and enters credentials
-3. **YouTube Navigation**: Goes to YouTube and verifies login status
-4. **Video Access**: Navigates to specific video pages
-5. **Download Trigger**: Finds and clicks the download button in YouTube's interface
-6. **Quality Selection**: Chooses the preferred video quality
-7. **Download Monitoring**: Waits for download completion and returns file path
+3. **YouTube Studio Navigation**: Goes to YouTube Studio for the specific video
+4. **Three-Dot Menu**: Finds and clicks the three vertical ellipses (⋮) button
+5. **Download Option**: Selects the "Download" option from the dropdown menu
+6. **Download Monitoring**: Waits for download completion and returns file path
 
 ## Browser Selectors
 
-The downloader uses multiple fallback selectors to find YouTube's download interface elements, as these can change over time:
+The downloader uses multiple fallback selectors to find YouTube Studio's interface elements, as these can change over time:
 
-- Download buttons: `button[aria-label*="Download"]`, `button:has-text("Download")`, etc.
-- Three-dot menus: `button[aria-label*="More actions"]`, `yt-icon-button[aria-label*="More"]`, etc.
-- Quality options: Text-based and aria-label selectors
+- **Three-dot ellipses menus**: `button[aria-label*="More"]`, `button:has-text("⋮")`, etc.
+- **Download options**: `text="Download"`, `button:has-text("Download")`, etc.
+- **Studio pages**: `[data-testid="video-editor"]` for page load verification
 
 ## Error Handling
 
 The system includes comprehensive error handling for:
 
 - **Authentication failures**: Invalid credentials, 2FA requirements
-- **Network timeouts**: Configurable timeout values
+- **Network timeouts**: Configurable timeout values  
 - **Element not found**: Multiple selector fallbacks
 - **Download failures**: File system and browser download issues
 
@@ -175,15 +169,15 @@ The system includes comprehensive error handling for:
    - Use App Password for 2FA accounts
    - Verify account access to target videos
 
-2. **Download Button Not Found**
+2. **Three-Dot Menu Not Found**
    - Video may not have download option
-   - Account may not have permission
-   - YouTube interface may have changed
+   - Account may not have permission to video
+   - YouTube Studio interface may have changed
 
 3. **Download Timeout**
    - Increase `YT_DOWNLOAD_TIMEOUT`
    - Check network connection
-   - Try lower quality setting
+   - Ensure sufficient disk space
 
 4. **Browser Issues**
    - Run `playwright install chromium`

src/ac_training_lab/video_editing/integrated_downloader.py

@@ -88,26 +88,23 @@ def download_video_ytdlp(self, video_id: str) -> bool:
 
     def download_video_playwright(self, 
                                 video_id: str,
-                                quality: Optional[str] = None) -> Optional[str]:
+                                channel_id: Optional[str] = None) -> Optional[str]:
         """
-        Download video using Playwright method.
+        Download video using Playwright method with YouTube Studio.
         
         Args:
             video_id: YouTube video ID
-            quality: Video quality preference
+            channel_id: YouTube channel ID (optional, helps with navigation)
             
         Returns:
             Optional[str]: Path to downloaded file or None if failed
         """
-        try:
-            quality = quality or self.config.default_quality
-            
+        try:            
             return download_youtube_video_with_playwright(
                 video_id=video_id,
                 email=self.config.google_email,
                 password=self.config.google_password,
-                download_dir=self.config.download_dir,
-                quality=quality,
+                channel_id=channel_id,
                 headless=self.config.headless
             )
         except Exception as e:
@@ -117,14 +114,14 @@ def download_video_playwright(self,
     def download_video(self, 
                       video_id: str,
                       method: Optional[str] = None,
-                      quality: Optional[str] = None) -> Dict[str, Any]:
+                      channel_id: Optional[str] = None) -> Dict[str, Any]:
         """
         Download video using specified or default method.
         
         Args:
             video_id: YouTube video ID
             method: Download method ('ytdlp' or 'playwright'), uses default if None
-            quality: Video quality preference (only for Playwright)
+            channel_id: YouTube channel ID (only for Playwright method)
             
         Returns:
             Dict[str, Any]: Download result with status and file path
@@ -142,7 +139,7 @@ def download_video(self,
 
         try:
             if use_playwright:
-                file_path = self.download_video_playwright(video_id, quality)
+                file_path = self.download_video_playwright(video_id, channel_id)
                 if file_path:
                     result['success'] = True
                     result['file_path'] = file_path
@@ -164,8 +161,7 @@ def download_latest_from_channel(self,
                                    channel_id: Optional[str] = None,
                                    device_name: Optional[str] = None,
                                    playlist_id: Optional[str] = None,
-                                   method: Optional[str] = None,
-                                   quality: Optional[str] = None) -> Dict[str, Any]:
+                                   method: Optional[str] = None) -> Dict[str, Any]:
         """
         Download the latest video from a channel.
         
@@ -174,7 +170,6 @@ def download_latest_from_channel(self,
             device_name: Device name to filter playlists
             playlist_id: Specific playlist ID
             method: Download method ('ytdlp' or 'playwright')
-            quality: Video quality preference
             
         Returns:
             Dict[str, Any]: Download result
@@ -194,19 +189,19 @@ def download_latest_from_channel(self,
             }
 
         # Download the video
-        return self.download_video(video_id, method, quality)
+        return self.download_video(video_id, method, channel_id)
 
     def download_multiple_videos(self, 
                                video_ids: List[str],
                                method: Optional[str] = None,
-                               quality: Optional[str] = None) -> Dict[str, Dict[str, Any]]:
+                               channel_id: Optional[str] = None) -> Dict[str, Dict[str, Any]]:
         """
         Download multiple videos.
         
         Args:
             video_ids: List of YouTube video IDs
             method: Download method ('ytdlp' or 'playwright')
-            quality: Video quality preference
+            channel_id: YouTube channel ID (for Playwright method)
             
         Returns:
             Dict[str, Dict[str, Any]]: Results for each video
@@ -215,7 +210,7 @@ def download_multiple_videos(self,
 
         for video_id in video_ids:
             logger.info(f"Downloading video {video_id} ({len(results)+1}/{len(video_ids)})")
-            results[video_id] = self.download_video(video_id, method, quality)
+            results[video_id] = self.download_video(video_id, method, channel_id)
 
         return results
 
@@ -231,7 +226,6 @@ def main():
     parser.add_argument('--playlist-id', help='Specific playlist ID')
     parser.add_argument('--method', choices=['ytdlp', 'playwright'], 
                        help='Download method (default: ytdlp)')
-    parser.add_argument('--quality', default='720p', help='Video quality for Playwright (default: 720p)')
     parser.add_argument('--use-playwright', action='store_true', 
                        help='Use Playwright by default')
 
@@ -251,16 +245,15 @@ def main():
         result = manager.download_video(
             video_id=args.video_id,
             method=args.method,
-            quality=args.quality
+            channel_id=args.channel_id
         )
     else:
         # Download latest from channel
         result = manager.download_latest_from_channel(
             channel_id=args.channel_id,
             device_name=args.device_name,
             playlist_id=args.playlist_id,
-            method=args.method,
-            quality=args.quality
+            method=args.method
         )
 
     # Print result

src/ac_training_lab/video_editing/playwright_config.py

@@ -1,7 +1,7 @@
 """
 Configuration for Playwright YouTube downloader.
 
-This file contains example configuration and credential management
+This file contains lean configuration and credential management
 for the Playwright YouTube downloader.
 """
 
@@ -10,7 +10,7 @@
 
 
 class PlaywrightYTConfig:
-    """Configuration class for Playwright YouTube downloader."""
+    """Simplified configuration class for Playwright YouTube downloader."""
 
     def __init__(self):
         """Initialize configuration with environment variables and defaults."""
@@ -19,19 +19,17 @@ def __init__(self):
         self.google_email = os.getenv("GOOGLE_EMAIL")
         self.google_password = os.getenv("GOOGLE_PASSWORD")
 
-        # Download settings
-        self.download_dir = os.getenv("YT_DOWNLOAD_DIR", "./downloads")
-        self.default_quality = os.getenv("YT_DEFAULT_QUALITY", "720p")
+        # Browser settings
         self.headless = os.getenv("YT_HEADLESS", "true").lower() == "true"
 
         # Timeout settings (in milliseconds)
         self.page_timeout = int(os.getenv("YT_PAGE_TIMEOUT", "30000"))
         self.download_timeout = int(os.getenv("YT_DOWNLOAD_TIMEOUT", "300"))  # seconds
 
-        # Channel and playlist settings
+        # Channel settings
         self.default_channel_id = os.getenv("YT_CHANNEL_ID", "UCHBzCfYpGwoqygH9YNh9A6g")
 
-        # Browser settings
+        # Browser user agent
         self.user_agent = os.getenv("YT_USER_AGENT", 
             "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
             "(KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"
@@ -62,8 +60,6 @@ def to_dict(self) -> Dict[str, Any]:
             Dict[str, Any]: Configuration as dictionary (excluding sensitive data)
         """
         return {
-            "download_dir": self.download_dir,
-            "default_quality": self.default_quality,
             "headless": self.headless,
             "page_timeout": self.page_timeout,
             "download_timeout": self.download_timeout,
@@ -73,7 +69,7 @@ def to_dict(self) -> Dict[str, Any]:
         }
 
 
-# Example environment variables setup
+# Example environment variables setup (simplified)
 EXAMPLE_ENV_VARS = """
 # Copy these to your .env file or set as environment variables
 
@@ -82,8 +78,6 @@ def to_dict(self) -> Dict[str, Any]:
 GOOGLE_PASSWORD=your-app-password
 
 # Optional settings
-YT_DOWNLOAD_DIR=./downloads
-YT_DEFAULT_QUALITY=720p
 YT_HEADLESS=true
 YT_PAGE_TIMEOUT=30000
 YT_DOWNLOAD_TIMEOUT=300