@tushar-br/desktop 1.0.282 → 1.0.283

package/staging_area/micro projects/SD -Advanced Media Processing Toolkit Automated Downloader, Segmenter & Neural Dubber/.venv/share/zsh/site-functions/_yt-dlp

@@ -0,0 +1,30 @@
+#compdef yt-dlp
+
+__yt_dlp() {
+    local curcontext="$curcontext" fileopts diropts cur prev
+    typeset -A opt_args
+    fileopts="--download-archive|-a|--batch-file|--load-info-json|--load-info|--cookies|--no-cookies"
+    diropts="--cache-dir"
+    cur=$words[CURRENT]
+    case $cur in
+        :)
+            _arguments '*: :(::ytfavorites ::ytrecommended ::ytsubscriptions ::ytwatchlater ::ythistory)'
+        ;;
+        *)
+            prev=$words[CURRENT-1]
+            if [[ ${prev} =~ ${fileopts} ]]; then
+                _path_files
+            elif [[ ${prev} =~ ${diropts} ]]; then
+                _path_files -/
+            elif [[ ${prev} == "--remux-video" ]]; then
+                _arguments '*: :(mp4 mkv)'
+            elif [[ ${prev} == "--recode-video" ]]; then
+                _arguments '*: :(mp4 flv ogg webm mkv)'
+            else
+                _arguments '*: :(--help --version --update --no-update --update-to --ignore-errors --no-abort-on-error --abort-on-error --dump-user-agent --list-extractors --extractor-descriptions --use-extractors --force-generic-extractor --default-search --ignore-config --no-config-locations --config-locations --flat-playlist --no-flat-playlist --live-from-start --no-live-from-start --wait-for-video --no-wait-for-video --mark-watched --no-mark-watched --no-colors --color --compat-options --alias --proxy --socket-timeout --source-address --force-ipv4 --force-ipv6 --enable-file-urls --geo-verification-proxy --cn-verification-proxy --xff --geo-bypass --no-geo-bypass --geo-bypass-country --geo-bypass-ip-block --playlist-start --playlist-end --playlist-items --match-title --reject-title --min-filesize --max-filesize --date --datebefore --dateafter --min-views --max-views --match-filters --no-match-filters --break-match-filters --no-break-match-filters --no-playlist --yes-playlist --age-limit --download-archive --no-download-archive --max-downloads --break-on-existing --break-on-reject --break-per-input --no-break-per-input --skip-playlist-after-errors --include-ads --no-include-ads --concurrent-fragments --limit-rate --throttled-rate --retries --file-access-retries --fragment-retries --retry-sleep --skip-unavailable-fragments --abort-on-unavailable-fragments --keep-fragments --no-keep-fragments --buffer-size --resize-buffer --no-resize-buffer --http-chunk-size --test --playlist-reverse --no-playlist-reverse --playlist-random --lazy-playlist --no-lazy-playlist --xattr-set-filesize --hls-prefer-native --hls-prefer-ffmpeg --hls-use-mpegts --no-hls-use-mpegts --download-sections --downloader --downloader-args --batch-file --no-batch-file --id --paths --output --output-na-placeholder --autonumber-size --autonumber-start --restrict-filenames --no-restrict-filenames --windows-filenames --no-windows-filenames --trim-filenames --no-overwrites --force-overwrites --no-force-overwrites --continue --no-continue --part --no-part --mtime --no-mtime --write-description --no-write-description --write-info-json --no-write-info-json --write-annotations --no-write-annotations --write-playlist-metafiles --no-write-playlist-metafiles --clean-info-json --no-clean-info-json --write-comments --no-write-comments --load-info-json --cookies --no-cookies --cookies-from-browser --no-cookies-from-browser --cache-dir --no-cache-dir --rm-cache-dir --write-thumbnail --no-write-thumbnail --write-all-thumbnails --list-thumbnails --write-link --write-url-link --write-webloc-link --write-desktop-link --quiet --no-quiet --no-warnings --simulate --no-simulate --ignore-no-formats-error --no-ignore-no-formats-error --skip-download --print --print-to-file --get-url --get-title --get-id --get-thumbnail --get-description --get-duration --get-filename --get-format --dump-json --dump-single-json --print-json --force-write-archive --newline --no-progress --progress --console-title --progress-template --verbose --dump-pages --write-pages --load-pages --youtube-print-sig-code --print-traffic --call-home --no-call-home --encoding --legacy-server-connect --no-check-certificates --prefer-insecure --user-agent --referer --add-headers --bidi-workaround --sleep-requests --sleep-interval --max-sleep-interval --sleep-subtitles --format --format-sort --format-sort-force --no-format-sort-force --video-multistreams --no-video-multistreams --audio-multistreams --no-audio-multistreams --all-formats --prefer-free-formats --no-prefer-free-formats --check-formats --check-all-formats --no-check-formats --list-formats --list-formats-as-table --list-formats-old --merge-output-format --allow-unplayable-formats --no-allow-unplayable-formats --write-subs --no-write-subs --write-auto-subs --no-write-auto-subs --all-subs --list-subs --sub-format --sub-langs --username --password --twofactor --netrc --netrc-location --netrc-cmd --video-password --ap-mso --ap-username --ap-password --ap-list-mso --client-certificate --client-certificate-key --client-certificate-password --extract-audio --audio-format --audio-quality --remux-video --recode-video --postprocessor-args --keep-video --no-keep-video --post-overwrites --no-post-overwrites --embed-subs --no-embed-subs --embed-thumbnail --no-embed-thumbnail --embed-metadata --no-embed-metadata --embed-chapters --no-embed-chapters --embed-info-json --no-embed-info-json --metadata-from-title --parse-metadata --replace-in-metadata --xattrs --concat-playlist --fixup --prefer-avconv --prefer-ffmpeg --ffmpeg-location --exec --no-exec --exec-before-download --no-exec-before-download --convert-subs --convert-thumbnails --split-chapters --no-split-chapters --remove-chapters --no-remove-chapters --force-keyframes-at-cuts --no-force-keyframes-at-cuts --use-postprocessor --sponsorblock-mark --sponsorblock-remove --sponsorblock-chapter-title --no-sponsorblock --sponsorblock-api --sponskrub --no-sponskrub --sponskrub-cut --no-sponskrub-cut --sponskrub-force --no-sponskrub-force --sponskrub-location --sponskrub-args --extractor-retries --allow-dynamic-mpd --ignore-dynamic-mpd --hls-split-discontinuity --no-hls-split-discontinuity --extractor-args --youtube-include-dash-manifest --youtube-skip-dash-manifest --youtube-include-hls-manifest --youtube-skip-hls-manifest)'
+            fi
+        ;;
+    esac
+}
+
+__yt_dlp

package/staging_area/micro projects/SD -Advanced Media Processing Toolkit Automated Downloader, Segmenter & Neural Dubber/PROJECT_REPORT.md

@@ -0,0 +1,123 @@
+# 🎬 Advanced Media Processing Toolkit
+## Automated Downloader, Segmenter & Neural Dubber
+**Subject:** Software Development (Micro-Project)  
+**Type:** Full Stack Web Application (React + Python)
+
+---
+
+## 📌 1. PROJECT OVERVIEW
+This project is an advanced **Automated Media Pipeline** designed to simplify the process of acquiring, editing, and enhancing web video content. Unlike standard downloaders, this toolkit integrates **Artificial Intelligence (Neural Dubbing)** and **Video Processing (Segmentation)** directly into the download workflow.
+
+It features a **Zero-Config** architecture, meaning it runs instantly on any Windows machine without complex installation steps, leveraging a bundled Python backend and a React-based frontend.
+
+---
+
+## 🛠️ 2. TECHNOLOGY STACK
+The project is built using a **Hybrid Architecture**:
+
+| Component | Technology | Role |
+| :--- | :--- | :--- |
+| **Frontend** | **React.js (v18)** | Dynamic User Interface (Single Page App), State Management. |
+| **Backend** | **Python (Flask)** | REST API Server, Orchestration of processing tasks. |
+| **Core Engine** | **yt-dlp** | Robust media extraction, bypassing YouTube bot detection. |
+| **Processing** | **MoviePy + FFmpeg** | Video editing, Audio merging, Segmentation. |
+| **AI Voice** | **gTTS (Google TTS)** | Neural Text-to-Speech generation for dubbing. |
+| **Deployment** | **Batch Script (.bat)** | One-click local deployment & dependency management. |
+
+---
+
+## ⚙️ 3. KEY FEATURES & FUNCTIONS
+
+### A. Intelligent Media Extraction (`video_info`)
+*   **Android Client Spoofing:** Mimics a mobile device to bypass YouTube's strict anti-bot blocking.
+*   **Smart Quality Sorting:** Automatically identifies and ranks video resolutions (1080p, 720p, etc.) based on bitrate and height.
+*   **Metadata Extraction:** Retrieves Thumbnail, Title, Duration, and Uploader details.
+
+### B. Robust Download Engine (`process`)
+*   **Audio-Video Merge:** Unlike standard tools that separate streams, our engine uses **FFmpeg** to merge the Best Video Stream (MP4) with the High-Fidelity Audio Stream (M4A) ensuring no quality loss.
+*   **Auto-Retry Mechanism:** Includes socket timeouts and retry logic to handle unstable network connections.
+
+### C. Neural Dubbing Engine (AI Feature)
+*   **Dynamic Script Generation:** The system reads the Video Title and Channel Name to generate a custom introductory script.
+*   **Voice Overlay:** Generates a professional **British English** AI voice.
+*   **Smart Looping:** If the video is longer than the script, the audio is intelligently managed to fit the duration.
+
+### D. Automated Post-Processing
+*   **Auto-Segmenter:** Capable of slicing long videos into **30-second clips** (e.g., for Shorts/Reels usage).
+*   **Direct Desktop Save:** Automatically locates the user's Desktop and saves the final output there.
+*   **Temp Cleanup:** Uses a hidden `temp_processing` directory for heavy tasks and auto-deletes files after completion to save disk space.
+
+---
+
+## 📚 4. PYTHON LIBRARIES & IMPORTS EXPLAINED
+
+This project utilizes specific libraries to achieve its "All-in-One" capability.
+
+### 1. `flask` & `flask_cors`
+```python
+from flask import Flask, request, jsonify, render_template
+from flask_cors import CORS
+```
+*   **Purpose:** creates the local web server.
+*   **Why:** `jsonify` sends JSON data to React, `render_template` serves the HTML UI, and `CORS` allows the frontend to communicate with the backend securely.
+
+### 2. `yt_dlp`
+```python
+import yt_dlp
+```
+*   **Purpose:** The successor to `youtube-dl`.
+*   **Why:** It is currently the *only* library capable of reliably bypassing modern YouTube throttling and age-restrictions. We use `yt_dlp.YoutubeDL(options)` context managers for safe execution.
+
+### 3. `moviepy.editor`
+```python
+from moviepy.editor import VideoFileClip, AudioFileClip, CompositeAudioClip
+```
+*   **Purpose:** Video Editing.
+*   **Why:** Allows us to load the video (`VideoFileClip`), replace its audio (`set_audio`), and cut it (`subclip`) programmatically without needing external software like Premiere Pro.
+
+### 4. `imageio_ffmpeg`
+```python
+import imageio_ffmpeg
+```
+*   **Purpose:** Binary management.
+*   **Why:** Automatically finds the FFmpeg executable binary on the system. This ensures the project runs even if the user hasn't manually installed FFmpeg in their PATH.
+
+### 5. `gTTS` (Google Text-to-Speech)
+```python
+from gtts import gTTS
+```
+*   **Purpose:** AI Voice Generation.
+*   **Why:** Converts the dynamically generated text string into an MP3 file, which MoviePy then overlays onto the video.
+
+### 6. `os` & `shutil`
+```python
+import os, shutil
+```
+*   **Purpose:** File System Operations.
+*   **Why:** `os.path.join` ensures cross-platform path compatibility. `shutil.move` transfers the final file to the Desktop, and `shutil.rmtree` cleans up the temporary folder.
+
+---
+
+## 🚀 5. SYSTEM ARCHITECTURE (Workflow)
+
+1.  **User** pastes URL in **React UI**.
+2.  **React** sends `POST /api/video-info` to **Flask**.
+3.  **Flask** uses `yt-dlp` (Android Mode) to fetch metadata.
+4.  **User** selects options (e.g., "1080p", "Neural Dub").
+5.  **React** sends `POST /api/process`.
+6.  **Backend Workflow:**
+    *   Download Video -> `temp_processing/`
+    *   Check for AI Dubbing? -> Generate MP3 -> Merge with MoviePy.
+    *   Check for Segmentation? -> Cut Video.
+    *   **Finalize:** Merge Audio/Video via FFmpeg.
+    *   **Delivery:** Move file to `Desktop`.
+    *   **Cleanup:** Delete `temp_processing/`.
+7.  **Result:** "Notification" on UI.
+
+---
+
+## 🏁 6. CONCLUSION
+This Micro-Project demonstrates the power of combining **Web Technologies** with **Python Automation**. By automating the complex tasks of downloading, merging, and dubbing, the tool saves significant manual effort and provides a seamless user experience.
+
+---
+**Developed for Micro-Project Submission (2025-26)**

package/staging_area/micro projects/SD -Advanced Media Processing Toolkit Automated Downloader, Segmenter & Neural Dubber/README.md

@@ -0,0 +1,30 @@
+# 🎬 Advanced Media Processing Toolkit
+
+**College Micro-Project (2025-26)**
+An automated tool to Download, Segment, and Dub videos using AI.
+
+---
+
+## ⚡ QUICK START
+1.  **Double-click** `RUN_PROJECT.bat`
+2.  Wait for the Black Window.
+3.  Paste YouTube URL & Click Search.
+4.  Select Quality (1080p) or AI Options (Neural Dub).
+5.  **Files Saved to DESKTOP.**
+
+---
+
+## � PROJECT REPORT
+For full documentation, technical details, and code explanation, please open:
+**`PROJECT_REPORT.md`**
+
+---
+
+## 🛠️ TECH STACK
+*   **React + Python (Flask)**
+*   **yt-dlp** (Downloader)
+*   **MoviePy** (Editor)
+*   **gTTS** (AI Voice)
+
+---
+*Created by [Your Name]*

package/staging_area/micro projects/SD -Advanced Media Processing Toolkit Automated Downloader, Segmenter & Neural Dubber/RUN_PROJECT.bat

@@ -0,0 +1,56 @@
+@echo off
+setlocal
+title Media Toolkit (Localhost:5000)
+
+REM ==========================================
+REM PERFECT LOCAL RUNNER (REACT + PYTHON)
+REM ==========================================
+
+set "PROJECT_ROOT=%~dp0"
+cd /d "%PROJECT_ROOT%"
+
+REM 1. PYTHON CHECK
+python --version >nul 2>&1
+if errorlevel 1 (
+    echo [ERROR] Python not found! Please install Python.
+    pause
+    exit /b 1
+)
+
+REM 2. DEPENDENCIES CHECK
+if not exist "backend\installed.flag" (
+    echo [INFO] Installing Dependencies...
+    cd backend
+    pip install -r requirements.txt
+    echo done > installed.flag
+    cd /d "%PROJECT_ROOT%"
+)
+
+REM ALWAYS UPDATE YT-DLP (Important for YouTube fixes)
+echo [INFO] Checking for yt-dlp updates (Skip if no internet)...
+pip install --upgrade yt-dlp --quiet --timeout 10 --retries 1
+
+REM 3. OPEN BROWSER (Wait a bit for server)
+echo [INFO] Opening http://localhost:5000...
+start "" "http://localhost:5000"
+
+REM 4. START SERVER (Main Loop)
+echo.
+echo ==========================================
+echo    SERVER IS STARTING...
+echo    DO NOT CLOSE THIS WINDOW.
+echo    Go to browser: http://localhost:5000
+echo ==========================================
+echo.
+
+cd backend
+python app.py
+
+REM 5. ERROR CATCH (If crashed)
+if errorlevel 1 (
+    echo.
+    echo [CRITICAL ERROR] Server stopped or crashed.
+    echo check the error message above.
+    pause
+)
+pause

package/staging_area/micro projects/SD -Advanced Media Processing Toolkit Automated Downloader, Segmenter & Neural Dubber/api/index.py

@@ -0,0 +1,13 @@
+import os
+import sys
+
+# Add the parent directory to path so we can import backend
+sys.path.append(os.path.join(os.path.dirname(__file__), '..'))
+
+# Import the Flask app
+from backend.app import app
+
+# Vercel needs this 'app' variable
+# It acts as the handler
+if __name__ == '__main__':
+    app.run()

package/staging_area/micro projects/SD -Advanced Media Processing Toolkit Automated Downloader, Segmenter & Neural Dubber/backend/app.py

@@ -0,0 +1,236 @@
+from flask import Flask, request, jsonify, render_template, send_file
+from flask_cors import CORS
+import os
+import shutil
+import yt_dlp
+from datetime import datetime
+
+# ============================================
+# FLASK SERVER (VERCEL OPTIMIZED)
+# ============================================
+
+# Use Absolute Paths for Templates/Static to avoid Vercel path errors
+BASE_DIR = os.path.dirname(os.path.abspath(__file__))
+TEMPLATE_DIR = os.path.join(BASE_DIR, 'templates')
+STATIC_DIR = os.path.join(BASE_DIR, 'static')
+
+app = Flask(__name__, template_folder=TEMPLATE_DIR, static_folder=STATIC_DIR)
+CORS(app)
+
+# DETECT ENVIRONMENT
+IS_VERCEL = os.environ.get('VERCEL') == '1'
+
+# PATHS
+if IS_VERCEL:
+    TEMP_DIR = "/tmp/processing"
+    DOWNLOAD_FOLDER = "/tmp/downloads"
+else:
+    TEMP_DIR = os.path.join(BASE_DIR, 'temp_processing')
+    DESKTOP_PATH = os.path.join(os.path.expanduser('~'), 'Desktop')
+    DOWNLOAD_FOLDER = os.path.join(DESKTOP_PATH, 'Media_Toolkit_Downloads')
+
+# Init Folders (Only if not Vercel, or inside route)
+if not IS_VERCEL:
+    for d in [TEMP_DIR, DOWNLOAD_FOLDER]:
+        if os.path.exists(d): shutil.rmtree(d)
+        os.makedirs(d, exist_ok=True)
+
+# -------------------------------------------------------------
+# ROUTES
+# -------------------------------------------------------------
+@app.route('/')
+def home():
+    return render_template('index.html')
+
+@app.route('/health')
+def health():
+    return "OK", 200
+
+@app.route('/api/video-info', methods=['POST'])
+def video_info():
+    try:
+        url = request.json.get('url')
+        if not url: return jsonify({'success': False, 'error': 'No URL'}), 400
+
+        ydl_opts = {
+            'nocheckcertificate': True,
+            'ignoreerrors': True,
+            'quiet': True,
+            'extract_flat': 'in_playlist',
+            'extractor_args': {
+                'youtube': {
+                    'player_client': ['android', 'ios', 'web'],
+                    'skip': ['hls', 'dash']
+                }
+            },
+            'user_agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36',
+            'source_address': '0.0.0.0', # Force IPv4 to avoid DNS/resolution issues on some Windows setups
+            'retries': 10,
+            'socket_timeout': 30
+        }
+        
+        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+            info = ydl.extract_info(url, download=False)
+            
+        if not info: return jsonify({'success': False, 'error': 'Failed to fetch info'}), 500
+
+        formats = []
+        if 'formats' in info:
+            seen = set()
+            for f in info['formats']:
+                if f.get('vcodec') != 'none' and f.get('ext') == 'mp4':
+                    h = f.get('height')
+                    if h and h not in seen:
+                        formats.append({
+                            'format_id': str(h), 
+                            'quality': f'{h}p', 
+                            'mb': round(f.get('filesize',0)/1e6, 2) if f.get('filesize') else '?'
+                        })
+                        seen.add(h)
+        formats.sort(key=lambda x: int(x['format_id']) if x['format_id'].isdigit() else 0, reverse=True)
+
+        return jsonify({
+            'success': True,
+            'title': info.get('title'),
+            'thumbnail': info.get('thumbnail'),
+            'duration': info.get('duration'),
+            'uploader': info.get('uploader'),
+            'views': info.get('view_count'),
+            'formats': formats[:6]
+        })
+    except Exception as e:
+        return jsonify({'success': False, 'error': str(e)}), 500
+
+@app.route('/api/process', methods=['POST'])
+def process():
+    try:
+        # LAZY IMPORTS (Prevents Vercel Crash on Startup)
+        from moviepy.editor import VideoFileClip, AudioFileClip, CompositeAudioClip
+        from gtts import gTTS
+        import imageio_ffmpeg
+
+        # Ensure folders exist in Vercel environment
+        if IS_VERCEL:
+            os.makedirs(TEMP_DIR, exist_ok=True)
+            os.makedirs(DOWNLOAD_FOLDER, exist_ok=True)
+
+        data = request.json
+        url = data.get('url')
+        selected_fmt = data.get('format', 'best')
+        enable_dubber = data.get('enable_dubber', False)
+        enable_segmenter = data.get('enable_segmenter', False)
+        
+        ffmpeg_path = imageio_ffmpeg.get_ffmpeg_exe()
+
+        # DOWNLOAD
+        ts = datetime.now().strftime("%H%M%S")
+        temp_filename = f"temp_{ts}.mp4"
+        temp_path = os.path.join(TEMP_DIR, temp_filename)
+        
+        if selected_fmt and selected_fmt != 'best':
+            fmt_str = f'bestvideo[height<={selected_fmt}]+bestaudio/best[height<={selected_fmt}]/best'
+        else:
+            fmt_str = 'bestvideo+bestaudio/best'
+
+        ydl_opts = {
+            'format': fmt_str,
+            'outtmpl': temp_path,
+            'ffmpeg_location': ffmpeg_path,
+            'merge_output_format': 'mp4',
+            'nocheckcertificate': True,
+            'quiet': False,
+            'extractor_args': {
+                'youtube': {
+                    'player_client': ['android', 'ios', 'web']
+                }
+            }, 
+            'user_agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36',
+            'source_address': '0.0.0.0', 
+            'retries': 20,              # Increased retries
+            'fragment_retries': 20,     # Increased fragment retries
+            'socket_timeout': 120,      # Doubled timeout (2 minutes)
+            'buffersize': 1024*1024,    # 1MB buffer
+            'http_chunk_size': 10485760 # 10MB chunks to prevent connection drops
+        }
+
+        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+            info = ydl.extract_info(url, download=True)
+            video_title = info.get('title', 'video')
+
+        # PROCESSING
+        processed_path = temp_path
+        final_suffix = ""
+
+        if enable_dubber or enable_segmenter:
+            try:
+                clip = VideoFileClip(temp_path)
+                if enable_segmenter and clip.duration > 30:
+                    clip = clip.subclip(0, 30)
+                    final_suffix += "_Segmented"
+
+                if enable_dubber:
+                    uploader = info.get('uploader', 'Unknown')
+                    clean_text = "".join([c for c in video_title if c.isalnum() or c in " .,!?'"])
+                    tts_text = f"Welcome. Watching {clean_text}. AI Dub engine active."
+                    
+                    tts_file = os.path.join(TEMP_DIR, "dub.mp3")
+                    tts = gTTS(text=tts_text, lang='en', tld='co.uk')
+                    tts.save(tts_file)
+                    
+                    dub_audio = AudioFileClip(tts_file)
+                    if dub_audio.duration < clip.duration:
+                        final_audio = CompositeAudioClip([dub_audio.set_start(0)])
+                    else:
+                        final_audio = dub_audio.subclip(0, clip.duration)
+                    clip = clip.set_audio(final_audio)
+                    final_suffix += "_AIDubbed"
+
+                processed_filename = f"processed_{ts}.mp4"
+                processed_path = os.path.join(TEMP_DIR, processed_filename)
+                clip.write_videofile(processed_path, codec='libx264', audio_codec='aac', preset='ultrafast', logger=None)
+                clip.close()
+                if enable_dubber: dub_audio.close()
+            except Exception as e:
+                print(f"Processing Error: {e}")
+                processed_path = temp_path
+
+        # FINALIZE
+        clean_title = "".join([c for c in video_title if c.isalnum() or c in (' ','-','_')]).rstrip()
+        final_filename = f"{clean_title}{final_suffix}.mp4"
+        
+        if IS_VERCEL:
+            # VERCEL: Stream file DIRECTLY (Solves 404 Error)
+            # We don't move to download folder, we just stream from temp
+            return send_file(processed_path, as_attachment=True, download_name=final_filename)
+
+        else:
+            # LOCAL: Move to Desktop
+            local_dest = os.path.join(DOWNLOAD_FOLDER, final_filename)
+            if os.path.exists(local_dest): local_dest = os.path.join(DOWNLOAD_FOLDER, f"{clean_title}_{ts}{final_suffix}.mp4")
+            shutil.move(processed_path, local_dest)
+            
+            return jsonify({'success': True, 'vercel': False, 'files': [{'filename': os.path.basename(local_dest)}]})
+
+    except Exception as e:
+        print(f"Error: {e}")
+        return jsonify({'success': False, 'error': str(e)}), 500
+    
+    finally:
+        # CLEANUP (Always runs, keeps Vercel /tmp clean)
+        # Note: On Vercel send_file might need the file to exist, so we rely on Vercel's auto cleanup
+        # But for Local, we must clean temp
+        if not IS_VERCEL and os.path.exists(TEMP_DIR):
+             try: shutil.rmtree(TEMP_DIR)
+             except: pass
+
+@app.route('/api/download_file')
+def download_file():
+    fname = request.args.get('file')
+    if not fname or '/' in fname: return "Invalid File", 400
+    file_path = os.path.join(DOWNLOAD_FOLDER, fname)
+    if os.path.exists(file_path):
+        return send_file(file_path, as_attachment=True)
+    return "File Not Found", 404
+
+if __name__ == '__main__':
+    app.run(host='0.0.0.0', port=5000)

package/staging_area/micro projects/SD -Advanced Media Processing Toolkit Automated Downloader, Segmenter & Neural Dubber/backend/downloader.py

@@ -0,0 +1,145 @@
+"""
+Media Downloader Module
+Downloads video/audio from URLs for educational purposes
+Uses yt-dlp library for robust media downloading
+"""
+
+import os
+import yt_dlp
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+class MediaDownloader:
+    """Handles media downloading from various sources"""
+    
+    def __init__(self, download_folder):
+        """
+        Initialize downloader
+        
+        Args:
+            download_folder (str): Path to store downloaded files
+        """
+        self.download_folder = download_folder
+        os.makedirs(download_folder, exist_ok=True)
+    
+    def download(self, url, session_id):
+        """
+        Download media from URL
+        
+        Args:
+            url (str): Media URL to download
+            session_id (str): Unique session identifier
+            
+        Returns:
+            dict: Result with success status and filename
+        """
+        try:
+            logger.info(f"Starting download for session {session_id}")
+            
+            # Generate output filename
+            output_template = os.path.join(
+                self.download_folder,
+                f'{session_id}_original.%(ext)s'
+            )
+            
+            # Configure yt-dlp options with SSL fix
+            ydl_opts = {
+                'format': 'best[ext=mp4]/best',  # Prefer MP4
+                'outtmpl': output_template,
+                'quiet': False,
+                'no_warnings': False,
+                'extract_flat': False,
+                # SSL certificate fix for educational use
+                'nocheckcertificate': True,
+                # Limit file size for educational demo (50MB)
+                'max_filesize': 50 * 1024 * 1024,
+                'progress_hooks': [self._progress_hook],
+                # Additional options for better compatibility
+                'ignoreerrors': False,
+                'no_color': True,
+                # Use legacy SSL for compatibility
+                'legacy_server_connect': True,
+            }
+            
+            # Download the media
+            with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+                logger.info(f"Downloading from URL: {url}")
+                info = ydl.extract_info(url, download=True)
+                
+                # Get the actual filename
+                filename = ydl.prepare_filename(info)
+                filename = os.path.basename(filename)
+                
+                logger.info(f"Download complete: {filename}")
+                
+                return {
+                    'success': True,
+                    'filename': filename,
+                    'title': info.get('title', 'Unknown'),
+                    'duration': info.get('duration', 0),
+                    'ext': info.get('ext', 'mp4')
+                }
+                
+        except yt_dlp.utils.DownloadError as e:
+            logger.error(f"Download error: {str(e)}")
+            return {
+                'success': False,
+                'error': f'Download failed: {str(e)}'
+            }
+        except Exception as e:
+            logger.error(f"Unexpected error: {str(e)}")
+            return {
+                'success': False,
+                'error': f'Unexpected error: {str(e)}'
+            }
+    
+    def _progress_hook(self, d):
+        """
+        Progress callback for download tracking
+        
+        Args:
+            d (dict): Progress information from yt-dlp
+        """
+        if d['status'] == 'downloading':
+            percent = d.get('_percent_str', '0%')
+            speed = d.get('_speed_str', 'N/A')
+            logger.info(f"Downloading: {percent} at {speed}")
+        elif d['status'] == 'finished':
+            logger.info("Download finished, processing...")
+    
+    def get_video_info(self, url):
+        """
+        Get video information without downloading
+        
+        Args:
+            url (str): Media URL
+            
+        Returns:
+            dict: Video information
+        """
+        try:
+            ydl_opts = {
+                'quiet': True,
+                'no_warnings': True,
+                'extract_flat': True,
+            }
+            
+            with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+                info = ydl.extract_info(url, download=False)
+                
+                return {
+                    'success': True,
+                    'title': info.get('title', 'Unknown'),
+                    'duration': info.get('duration', 0),
+                    'uploader': info.get('uploader', 'Unknown'),
+                    'thumbnail': info.get('thumbnail', '')
+                }
+                
+        except Exception as e:
+            logger.error(f"Error getting video info: {str(e)}")
+            return {
+                'success': False,
+                'error': str(e)
+            }

package/staging_area/micro projects/SD -Advanced Media Processing Toolkit Automated Downloader, Segmenter & Neural Dubber/backend/downloads/.gitkeep

@@ -0,0 +1,2 @@
+# This folder stores downloaded and processed media files
+# Files are automatically created and managed by the backend