camelDownloader 2.0.0__py3-none-any.whl

camel_downloader/main.py

@@ -0,0 +1,464 @@
+#!/usr/bin/env python3
+"""
+camelDownloader 🐫
+Production-Ready YouTube Downloader (2026)
+
+✔ Handles ALL video types and lengths
+✔ Smart format selection (MP4/MKV auto-switching)
+✔ No forced conversions (preserves quality)
+✔ Proper audio merging
+✔ Real resolutions (360p to 4K)
+✔ Works with: short videos, long videos, livestreams, age-restricted
+✔ Ubuntu + Termux + macOS compatible
+"""
+
+import os
+import sys
+import time
+import yt_dlp
+
+
+def get_format(choice):
+    """
+    Format selection strategy:
+    
+    WHY we use this approach:
+    - YouTube stores video/audio separately for HD quality
+    - We must download BOTH and let yt-dlp merge them
+    - The '+bestaudio' ensures we always get sound
+    - The '/best' is a fallback for legacy formats
+    
+    NO FORCED CONVERSIONS:
+    - We let yt-dlp choose MP4 or MKV naturally
+    - AV1/VP9 codecs stay intact (no re-encoding)
+    - This prevents quality loss and saves time
+    """
+    formats = {
+        # 360p - Standard Definition (smallest file, fastest download)
+        # Good for: slow internet, quick previews, mobile data saving
+        '1': 'bestvideo[height<=360]+bestaudio/best[height<=360]',
+        
+        # 720p - HD (balanced quality and size)
+        # Good for: most users, good quality without huge files
+        '2': 'bestvideo[height<=720]+bestaudio/best[height<=720]',
+        
+        # 1080p - Full HD (standard high quality)
+        # Good for: desktop viewing, archiving, sharing
+        '3': 'bestvideo[height<=1080]+bestaudio/best[height<=1080]',
+        
+        # 1440p - 2K (very high quality)
+        # Good for: large screens, professional use
+        '4': 'bestvideo[height<=1440]+bestaudio/best[height<=1440]',
+        
+        # 2160p - 4K (maximum quality)
+        # Good for: 4K displays, archiving, editing
+        # Note: May use AV1/VP9 codec (will save as MKV if MP4 not possible)
+        '5': 'bestvideo[height<=2160]+bestaudio/best[height<=2160]',
+        
+        # Best available - Let YouTube decide
+        # Downloads the absolute best quality available (video+audio)
+        '6': 'bestvideo+bestaudio/best',
+        
+        # Audio only - Extract just the sound
+        # Downloads best audio stream (usually 128-192kbps)
+        '7': 'bestaudio/best'
+    }
+    return formats.get(choice, 'bestvideo+bestaudio/best')
+
+
+def format_duration(seconds):
+    """
+    Convert seconds to human-readable time format
+    
+    Examples:
+    - 125 seconds → "2:05"
+    - 3725 seconds → "1:02:05"
+    - Handles videos from 1 second to 100+ hours
+    """
+    if not seconds:
+        return "Unknown"
+    
+    # Convert to hours, minutes, seconds
+    hours = int(seconds // 3600)
+    minutes = int((seconds % 3600) // 60)
+    secs = int(seconds % 60)
+    
+    # Format based on length
+    if hours > 0:
+        return f"{hours}:{minutes:02d}:{secs:02d}"
+    else:
+        return f"{minutes}:{secs:02d}"
+
+
+def format_filesize(bytes_size):
+    """
+    Convert bytes to human-readable file size
+    
+    Examples:
+    - 1024 → "1.0 KB"
+    - 1048576 → "1.0 MB"
+    - 1073741824 → "1.0 GB"
+    """
+    if not bytes_size:
+        return "Unknown"
+    
+    for unit in ['B', 'KB', 'MB', 'GB', 'TB']:
+        if bytes_size < 1024.0:
+            return f"{bytes_size:.1f} {unit}"
+        bytes_size /= 1024.0
+    return f"{bytes_size:.1f} PB"
+
+
+def progress_hook(d):
+    """
+    Real-time download progress display
+    
+    This function is called repeatedly by yt-dlp during download
+    Shows: percentage, speed, time remaining, downloaded size
+    
+    Status types:
+    - 'downloading': Currently downloading
+    - 'finished': Download complete, starting merge
+    - 'error': Something went wrong
+    """
+    if d['status'] == 'downloading':
+        # Extract progress information
+        percent = d.get('_percent_str', 'N/A').strip()
+        speed = d.get('_speed_str', 'N/A').strip()
+        eta = d.get('_eta_str', 'N/A').strip()
+        downloaded = d.get('downloaded_bytes', 0)
+        total = d.get('total_bytes') or d.get('total_bytes_estimate', 0)
+        
+        # Build progress line
+        if total:
+            size_info = f"{format_filesize(downloaded)}/{format_filesize(total)}"
+        else:
+            size_info = f"{format_filesize(downloaded)}"
+        
+        # Display with carriage return (overwrites same line)
+        print(f"\r⬇️  {percent} | {size_info} | Speed: {speed} | ETA: {eta}   ", 
+              end='', flush=True)
+    
+    elif d['status'] == 'finished':
+        # Download complete, now merging video and audio
+        print("\n🔄 Merging video and audio streams (this may take a moment)...")
+    
+    elif d['status'] == 'error':
+        print("\n❌ Download error occurred")
+
+
+def download_video(url, choice):
+    """
+    Main download function - production-ready with all safeguards
+    
+    Process:
+    1. Create download directory
+    2. Configure yt-dlp options (NO forced conversions)
+    3. Fetch video information
+    4. Download video and audio streams
+    5. Merge streams (yt-dlp + ffmpeg)
+    6. Save final file
+    """
+    
+    # ─────────────────────────────────────────────────────────
+    # STEP 1: Setup download directory
+    # ─────────────────────────────────────────────────────────
+    download_dir = os.path.expanduser("~/Downloads/camelDownloader")
+    
+    try:
+        os.makedirs(download_dir, exist_ok=True)
+    except PermissionError:
+        print(f"❌ Cannot create directory: {download_dir}")
+        print("💡 Try running with appropriate permissions or change download location")
+        return
+    
+    # ─────────────────────────────────────────────────────────
+    # STEP 2: Configure yt-dlp options
+    # ─────────────────────────────────────────────────────────
+    ydl_opts = {
+        # FORMAT: Which quality to download
+        'format': get_format(choice),
+
+        # OUTPUT: Where and how to save
+        # Sanitize filename to remove special characters
+        'outtmpl': os.path.join(download_dir, '%(title)s.%(ext)s'),
+        'restrictfilenames': False,  # Allow Unicode characters in filenames
+        'windowsfilenames': False,   # Don't restrict to Windows-safe names on Linux
+
+        # MERGING: Combine video+audio WITHOUT re-encoding
+        # CRITICAL: This does NOT force conversion, just sets container preference
+        # yt-dlp will use MKV automatically if MP4 is impossible
+        'merge_output_format': 'mp4',  # Prefer MP4, fallback to MKV
+
+        # NO POSTPROCESSORS FOR VIDEO
+        # We removed FFmpegVideoConvertor to avoid forced re-encoding
+        # This preserves AV1/VP9 codecs and saves time
+        
+        # NETWORK: Stability and bypass settings
+        'geo_bypass': True,              # Try to bypass geographic restrictions
+        'nocheckcertificate': True,      # Ignore SSL certificate errors
+        
+        # RETRY: Handle temporary failures
+        'retries': 10,                   # Retry failed fragments up to 10 times
+        'fragment_retries': 10,          # Retry individual fragments
+        'socket_timeout': 30,            # 30 second timeout per connection
+        
+        # CLIENT: Use web client (most stable in 2025)
+        # CLIENT: Use default clients (improved in 2025/2026)
+        # 'extractor_args': {
+        #     'youtube': {
+        #         'player_client': ['web'],
+        #         'skip': ['hls', 'dash'],
+        #     }
+        # },
+
+        # LOGGING: Show what's happening
+        'quiet': False,                  # Show progress
+        'no_warnings': False,            # Show warnings
+        'verbose': False,                # Don't spam technical details
+        'progress_hooks': [progress_hook],  # Our custom progress display
+        
+        # AGE-RESTRICTED: Handle age-gated content
+        'age_limit': None,               # Download age-restricted videos
+        
+        # COOKIES: Support for logged-in content (optional)
+        # Uncomment if you need to download members-only content:
+        # 'cookiefile': 'cookies.txt',
+    }
+
+    # ─────────────────────────────────────────────────────────
+    # STEP 3: Special handling for audio-only downloads
+    # ─────────────────────────────────────────────────────────
+    if choice == '7':
+        # For audio, we WANT conversion (to MP3)
+        # This is different from video (where we avoid conversion)
+        ydl_opts['postprocessors'] = [{
+            'key': 'FFmpegExtractAudio',    # Extract audio stream
+            'preferredcodec': 'mp3',         # Convert to MP3
+            'preferredquality': '192',       # 192kbps (good quality)
+        }]
+        # Remove video merge settings (not needed for audio)
+        ydl_opts.pop('merge_output_format', None)
+
+    # ─────────────────────────────────────────────────────────
+    # STEP 4: Execute download
+    # ─────────────────────────────────────────────────────────
+    try:
+        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+            # First, fetch video metadata WITHOUT downloading
+            print("\n🔍 Fetching video information...")
+            print("─" * 60)
+            
+            try:
+                info = ydl.extract_info(url, download=False)
+            except yt_dlp.utils.DownloadError as e:
+                print(f"❌ Cannot access video: {e}")
+                print("\n💡 Possible reasons:")
+                print("   • Video is private or deleted")
+                print("   • Geographic restriction")
+                print("   • Age-restricted (try with cookies)")
+                print("   • Invalid URL")
+                return
+            
+            # Display video information
+            title = info.get('title', 'Unknown Title')
+            duration = info.get('duration', 0)
+            uploader = info.get('uploader', 'Unknown')
+            view_count = info.get('view_count', 0)
+            
+            print(f"📹 Title: {title}")
+            print(f"👤 Uploader: {uploader}")
+            print(f"⏱️  Duration: {format_duration(duration)}")
+            
+            if view_count:
+                print(f"👁️  Views: {view_count:,}")
+            
+            # Show available formats (optional debug info)
+            if info.get('formats'):
+                available_heights = set()
+                for fmt in info['formats']:
+                    if fmt.get('height'):
+                        available_heights.add(fmt['height'])
+                
+                if available_heights:
+                    heights_sorted = sorted(available_heights, reverse=True)
+                    print(f"📊 Available resolutions: {', '.join(f'{h}p' for h in heights_sorted)}")
+            
+            print("─" * 60)
+            
+            # Start actual download
+            print("\n⬇️  Starting download...")
+            ydl.download([url])
+
+        # Success message
+        print("\n" + "═" * 60)
+        print("✅ DOWNLOAD COMPLETE!")
+        print("═" * 60)
+        print(f"📁 Location: {download_dir}")
+        print(f"📄 Filename: {title[:50]}..." if len(title) > 50 else f"📄 Filename: {title}")
+        print("═" * 60)
+
+    # ─────────────────────────────────────────────────────────
+    # ERROR HANDLING: Graceful failures with helpful messages
+    # ─────────────────────────────────────────────────────────
+    except KeyboardInterrupt:
+        print("\n\n⚠️  Download cancelled by user (Ctrl+C)")
+        print("Partial files may remain in download folder.")
+
+    except yt_dlp.utils.DownloadError as e:
+        print(f"\n❌ Download Error: {e}")
+        print("\n💡 Troubleshooting:")
+        print("   1. Check if video is available in your region")
+        print("   2. Update yt-dlp: pip install -U yt-dlp")
+        print("   3. Check internet connection")
+        print("   4. Try a different quality option")
+        print("   5. If age-restricted, the video may need authentication")
+
+    except PermissionError:
+        print(f"\n❌ Permission denied writing to: {download_dir}")
+        print("💡 Fix: Check folder permissions or choose different location")
+
+    except OSError as e:
+        print(f"\n❌ System Error: {e}")
+        print("💡 Possible causes:")
+        print("   • Disk full")
+        print("   • Filename too long")
+        print("   • Invalid characters in filename")
+
+    except Exception as e:
+        print(f"\n❌ Unexpected Error: {e}")
+        print("💡 Please report this error with the video URL")
+        print(f"Error type: {type(e).__name__}")
+
+
+def check_dependencies():
+    """
+    Check if required tools are installed
+    
+    Requirements:
+    - yt-dlp (the downloader)
+    - ffmpeg (for merging video+audio)
+    """
+    # Check yt-dlp
+    try:
+        import yt_dlp
+    except ImportError:
+        print("❌ yt-dlp not installed")
+        print("📦 Install: pip install -U yt-dlp")
+        return False
+    
+    # Check ffmpeg (required for merging)
+    import subprocess
+    try:
+        subprocess.run(['ffmpeg', '-version'], 
+                      stdout=subprocess.DEVNULL, 
+                      stderr=subprocess.DEVNULL,
+                      check=True)
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        print("❌ ffmpeg not installed")
+        print("📦 Install:")
+        print("   Ubuntu/Debian: sudo apt install ffmpeg")
+        print("   Termux: pkg install ffmpeg")
+        print("   macOS: brew install ffmpeg")
+        return False
+    
+    return True
+
+
+def main():
+    """
+    Main program entry point
+    
+    Flow:
+    1. Show banner
+    2. Check dependencies
+    3. Get video URL
+    4. Show quality options
+    5. Start download
+    """
+    
+    # ═══════════════════════════════════════════════════════
+    # BANNER
+    # ═══════════════════════════════════════════════════════
+    print("\n" + "═" * 60)
+    print("                 camelDownloader 🐫")
+    print("           Production YouTube Downloader")
+    print("     Handles ANY video type, length, and quality")
+    print("═" * 60)
+    
+    # ═══════════════════════════════════════════════════════
+    # DEPENDENCY CHECK
+    # ═══════════════════════════════════════════════════════
+    if not check_dependencies():
+        print("\n⚠️  Please install missing dependencies first")
+        return
+    
+    # ═══════════════════════════════════════════════════════
+    # GET VIDEO URL
+    # ═══════════════════════════════════════════════════════
+    print("\n")
+    url = input("🔗 Enter YouTube URL: ").strip()
+    
+    # Validate URL
+    if not url:
+        print("❌ No URL provided")
+        return
+    
+    if not ('youtube.com' in url or 'youtu.be' in url):
+        print("⚠️  Warning: This doesn't look like a YouTube URL")
+        confirm = input("Continue anyway? (y/n): ").strip().lower()
+        if confirm != 'y':
+            return
+    
+    # ═══════════════════════════════════════════════════════
+    # SHOW QUALITY OPTIONS
+    # ═══════════════════════════════════════════════════════
+    print("\n" + "─" * 60)
+    print("📊 SELECT QUALITY:")
+    print("─" * 60)
+    print("1) 360p  - SD       (Small file, fast download)")
+    print("2) 720p  - HD       (Balanced quality and size)")
+    print("3) 1080p - Full HD  (High quality, larger file)")
+    print("4) 1440p - 2K       (Very high quality)")
+    print("5) 2160p - 4K       (Maximum quality, huge file)")
+    print("6) Best  - Auto     (Let YouTube decide best quality)")
+    print("7) Audio - MP3      (Sound only, ~3MB per minute)")
+    print("─" * 60)
+    
+    # ═══════════════════════════════════════════════════════
+    # GET USER CHOICE
+    # ═══════════════════════════════════════════════════════
+    choice = input("\n👉 Your choice (1-7): ").strip()
+    
+    # Validate choice
+    if choice not in ('1', '2', '3', '4', '5', '6', '7'):
+        print("❌ Invalid choice - Please select 1-7")
+        return
+    
+    # Confirmation message
+    quality_map = {
+        '1': '360p (SD)',
+        '2': '720p (HD)',
+        '3': '1080p (Full HD)',
+        '4': '1440p (2K)',
+        '5': '2160p (4K)',
+        '6': 'Best Available',
+        '7': 'Audio Only (MP3)'
+    }
+    print(f"\n✅ Selected: {quality_map[choice]}")
+    
+    # ═══════════════════════════════════════════════════════
+    # START DOWNLOAD
+    # ═══════════════════════════════════════════════════════
+    download_video(url, choice)
+
+
+# ═══════════════════════════════════════════════════════════
+# PROGRAM ENTRY POINT
+# ═══════════════════════════════════════════════════════════
+if __name__ == "__main__":
+    try:
+        main()
+    except KeyboardInterrupt:
+        print("\n\n👋 Goodbye!")
+        sys.exit(0)

cameldownloader-2.0.0.dist-info/METADATA

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: camelDownloader
+Version: 2.0.0
+Summary: Production-Ready YouTube Downloader
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: yt-dlp>=2025.01.01
+
+# Camel Downloader 🐫
+
+Production YouTube Downloader.
+
+## Installation
+
+```bash
+pip install .
+```
+
+## Usage
+
+```bash
+camel
+```

cameldownloader-2.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+camel_downloader/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+camel_downloader/main.py,sha256=H1LidQTNDZe1V_rTPExRcjmIyyzfDZ-D3isn3Pp-VB0,19374
+cameldownloader-2.0.0.dist-info/METADATA,sha256=DdUB_fvK8RLAPV4EArvu90qppLiuNor4-44o79SIOZM,426
+cameldownloader-2.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cameldownloader-2.0.0.dist-info/entry_points.txt,sha256=jVCsTsFS-YB9Wc4tz6lCHeaAnzjfW3RSSRpanoR_rtY,53
+cameldownloader-2.0.0.dist-info/top_level.txt,sha256=w7mSCzUfy2T3L14BPQo4Sf6L9N4u1yDlQkxoLV50AhA,17
+cameldownloader-2.0.0.dist-info/RECORD,,

cameldownloader-2.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

cameldownloader-2.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+camel = camel_downloader.main:main

cameldownloader-2.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+camel_downloader