feat: deployment

.gitignore

@@ -0,0 +1,7 @@
+.mypy_cache
+.venv
+
+__pycache__/
+*.pyc
+env/
+downloads/

Dockerfile

@@ -0,0 +1,30 @@
+# Use an official Python runtime as a parent image
+FROM python:3.9-slim
+
+# Install ffmpeg and other system dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    ffmpeg \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set the working directory in the container
+WORKDIR /app
+
+# Copy the dependencies file to the working directory
+COPY requirements.txt .
+
+# Install any needed packages specified in requirements.txt
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy the rest of the application code to the working directory
+COPY . .
+
+# Make port 7860 available to the world outside this container
+# Hugging Face Spaces use 7860 by default
+EXPOSE 7860
+
+# Define environment variables
+ENV FLASK_APP=app.py
+
+# Run the app using gunicorn for production
+# Use 0.0.0.0 to make it accessible from outside the container
+CMD ["gunicorn", "--bind", "0.0.0.0:7860", "--workers", "1", "--threads", "4", "app:app"]

app.py

@@ -0,0 +1,131 @@
+from flask import Flask, render_template, request, jsonify, Response, stream_with_context
+import yt_dlp
+import os
+import shutil
+import urllib.parse
+import requests # We now use requests to stream the final content
+
+app = Flask(__name__)
+
+def get_ffmpeg_path():
+    """Finds the full path to the ffmpeg executable."""
+    return shutil.which('ffmpeg')
+
+def sanitize_facebook_url(url):
+    """Cleans up Facebook URLs that are wrapped in a redirect link."""
+    try:
+        parsed_url = urllib.parse.urlparse(url)
+        if 'l.facebook.com' in parsed_url.netloc:
+            query_params = urllib.parse.parse_qs(parsed_url.query)
+            if 'u' in query_params:
+                clean_url = query_params['u'][0]
+                print(f"Sanitized URL: {url} -> {clean_url}", flush=True)
+                return clean_url
+    except Exception as e:
+        print(f"Could not sanitize URL, using original. Error: {e}", flush=True)
+    return url
+
+@app.route('/')
+def index():
+    """Serves the main HTML page."""
+    return render_template('index.html')
+
+@app.route('/download', methods=['POST'])
+def download():
+    """
+    This function now acts as a streaming proxy.
+    1. Extracts the direct media URL using yt-dlp.
+    2. Streams the content from that URL directly to the user's browser.
+    """
+    url = request.form.get('url')
+    output_format = request.form.get('format', 'mp4')
+
+    if not url:
+        return jsonify({'error': 'URL is required'}), 400
+
+    # --- Pre-flight checks ---
+    if not os.path.exists('cookies.txt'):
+        return jsonify({'error': '`cookies.txt` not found. Required for Facebook downloads.'}), 500
+    
+    ffmpeg_path = get_ffmpeg_path()
+    if not ffmpeg_path:
+        return jsonify({'error': 'FFmpeg not found. It is required for format processing.'}), 500
+
+    try:
+        clean_url = sanitize_facebook_url(url)
+        
+        # --- yt-dlp Options to EXTRACT INFO, NOT DOWNLOAD ---
+        ydl_opts = {
+            'quiet': True, 'cookiefile': 'cookies.txt', 'noplaylist': True,
+            'ffmpeg_location': os.path.dirname(ffmpeg_path)
+        }
+        
+        # Determine format selection for yt-dlp
+        audio_formats = ['mp3', 'm4a', 'wav']
+        if output_format in audio_formats:
+            ydl_opts['format'] = 'bestaudio/best'
+            # We request a postprocessor but won't run it; this helps select the right stream
+            ydl_opts['postprocessors'] = [{'key': 'FFmpegExtractAudio', 'preferredcodec': output_format}]
+        else: # Video formats
+             ydl_opts['format'] = f'bestvideo[ext={output_format}]+bestaudio[ext=m4a]/best[ext={output_format}]/best'
+
+        # --- Stage 1: Get direct media URL from Facebook ---
+        print("Extracting media information from URL...")
+        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+            info_dict = ydl.extract_info(clean_url, download=False)
+
+        # Find the best URL to stream from
+        stream_url = info_dict.get('url')
+        if not stream_url:
+            # Handle cases where video and audio are separate
+            requested_formats = info_dict.get('requested_formats')
+            if requested_formats:
+                # Typically, the first URL is the most relevant one (video or combined)
+                stream_url = requested_formats[0].get('url')
+            else:
+                 return jsonify({'error': 'Could not extract a downloadable URL from the provided link.'}), 500
+
+        title = info_dict.get('title', 'facebook_content')
+        safe_title = "".join([c for c in title if c.isalpha() or c.isdigit() or c in (' ', '-', '_')]).rstrip()
+        download_name = f'{safe_title}.{output_format}'
+        
+        # --- Stage 2: Stream the content from the direct URL to the user ---
+        print(f"Starting to stream from direct URL for: {download_name}")
+        # Make a HEAD request first to get the total size for the progress bar
+        head_req = requests.head(stream_url, allow_redirects=True, timeout=10)
+        total_size = int(head_req.headers.get('content-length', 0))
+
+        # Make the streaming GET request
+        stream_req = requests.get(stream_url, stream=True, allow_redirects=True, timeout=15)
+
+        # Check if the request was successful
+        if not stream_req.ok:
+            return jsonify({'error': f'Failed to fetch media. Status: {stream_req.status_code}'}), 500
+            
+        def generate_content():
+            """A generator function that yields chunks of the download."""
+            for chunk in stream_req.iter_content(chunk_size=8192):
+                if chunk:
+                    yield chunk
+        
+        # Prepare and return the streaming response
+        mime_types = {'mp4': 'video/mp4', 'webm': 'video/webm', 'mp3': 'audio/mpeg', 'm4a': 'audio/mp4', 'wav': 'audio/wav'}
+        mimetype = mime_types.get(output_format, 'application/octet-stream')
+
+        response = Response(stream_with_context(generate_content()), mimetype=mimetype)
+        response.headers['Content-Disposition'] = f'attachment; filename="{download_name}"'
+        # Crucially, we provide the Content-Length for the progress bar
+        if total_size > 0:
+            response.headers['Content-Length'] = total_size
+            
+        return response
+
+    except Exception as e:
+        error_message = str(e)
+        print(f"An unexpected error occurred: {error_message}")
+        if "private" in error_message.lower() or "login" in error_message.lower():
+            return jsonify({'error': 'This content is private or requires login. Please check `cookies.txt`.'}), 403
+        return jsonify({'error': 'An unknown error occurred. The link may be invalid or private.'}), 500
+
+if __name__ == '__main__':
+    app.run(debug=True, host='0.0.0.0', port=7860)

cookies.txt

@@ -0,0 +1,9 @@
+# Netscape HTTP Cookie File
+# This file is generated by yt-dlp.  Do not edit.
+
+.facebook.com	TRUE	/	TRUE	1796890983	datr	ZgkLaeUf04X_Z64d2osIDiRy
+.facebook.com	TRUE	/	TRUE	1770354288	fr	01mWyo4bom3O5LIia.AWcJdxDktq7qLh5y68sNC9JdRLm-fVK_hdm42oxpaa2b7zSn4UQ.BpCwlm..AAA.0.0.BpDs9x.AWf1imU5ilyIp07pbgfjE73blTQ
+.facebook.com	TRUE	/	TRUE	1762417538	presence	C%7B%22t3%22%3A%5B%5D%2C%22utc3%22%3A1762331050912%2C%22v%22%3A1%7D
+.facebook.com	TRUE	/	TRUE	1796891043	sb	ZgkLaXd4J6Y7zBpMdScBr7q4
+.facebook.com	TRUE	/	TRUE	1762935850	wd	1920x1065
+.facebook.com	TRUE	/	TRUE	0	noscript	1

requirements.txt

@@ -0,0 +1,8 @@
+Flask
+yt-dlp
+ffmpeg-python
+requests
+gunicorn
+gallery-dl
+beautifulsoup4
+selenium

templates/index.html

@@ -0,0 +1,500 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Facebook Video & Audio Downloader</title>
+    <style>
+      :root {
+        --primary-color: #1877f2;
+        --primary-hover: #166fe5;
+        --background-color: #f0f2f5;
+        --container-bg: #ffffff;
+        --text-color: #1c1e21;
+        --subtle-text: #606770;
+        --border-color: #dddfe2;
+        --error-bg: #fff0f0;
+        --error-text: #d8000c;
+        --progress-bg: #e4e6ea;
+        --progress-fill: var(--primary-color);
+      }
+      body {
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
+          Helvetica, Arial, sans-serif;
+        background-color: var(--background-color);
+        color: var(--text-color);
+        margin: 0;
+        padding: 20px;
+        display: flex;
+        justify-content: center;
+        align-items: flex-start;
+        min-height: 100vh;
+      }
+      .container {
+        background: var(--container-bg);
+        padding: 2rem;
+        border-radius: 8px;
+        box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
+        width: 100%;
+        max-width: 600px;
+        transition: all 0.3s ease-in-out;
+      }
+      h1 {
+        text-align: center;
+        color: var(--primary-color);
+        margin-bottom: 1.5rem;
+        font-size: 1.8rem;
+      }
+      .tabs {
+        display: flex;
+        border-bottom: 1px solid var(--border-color);
+        margin-bottom: 1.5rem;
+      }
+      .tab-button {
+        background: none;
+        color: var(--subtle-text);
+        padding: 1rem;
+        border: none;
+        cursor: pointer;
+        font-size: 1rem;
+        font-weight: 600;
+        transition: color 0.2s, border-bottom 0.2s;
+        border-bottom: 3px solid transparent;
+        flex-grow: 1;
+      }
+      .tab-button.active {
+        color: var(--primary-color);
+        border-bottom-color: var(--primary-color);
+      }
+      .tab-content {
+        display: none;
+      }
+      .tab-content.active {
+        display: block;
+      }
+      form {
+        display: flex;
+        flex-direction: column;
+      }
+      input[type="text"],
+      select {
+        padding: 1rem;
+        margin-bottom: 1rem;
+        border: 1px solid var(--border-color);
+        border-radius: 6px;
+        font-size: 1rem;
+        width: 100%;
+        box-sizing: border-box;
+      }
+      button {
+        background-color: var(--primary-color);
+        color: white;
+        padding: 1rem;
+        border: none;
+        border-radius: 6px;
+        cursor: pointer;
+        font-size: 1.1rem;
+        font-weight: 600;
+        transition: background-color 0.3s;
+      }
+      button:hover:not(:disabled) {
+        background-color: var(--primary-hover);
+      }
+      button:disabled {
+        background-color: #a0bdf5;
+        cursor: not-allowed;
+      }
+      #status-container {
+        margin-top: 1.5rem;
+        text-align: center;
+        font-weight: 500;
+      }
+      #status.error {
+        color: var(--error-text);
+        background-color: var(--error-bg);
+        padding: 0.8rem;
+        border-radius: 6px;
+      }
+      .spinner {
+        border: 4px solid rgba(0, 0, 0, 0.1);
+        width: 36px;
+        height: 36px;
+        border-radius: 50%;
+        border-left-color: var(--primary-color);
+        animation: spin 1s linear infinite;
+        display: none;
+        margin: 20px auto;
+      }
+      @keyframes spin {
+        to {
+          transform: rotate(360deg);
+        }
+      }
+      .note {
+        font-size: 0.9rem;
+        color: var(--subtle-text);
+        margin-top: 1rem;
+        background-color: #f7f8fa;
+        padding: 0.8rem;
+        border-radius: 6px;
+        text-align: center;
+      }
+      .important-note {
+        font-size: 0.9rem;
+        color: #946c00;
+        margin-bottom: 1.5rem;
+        background-color: #fffbe6;
+        padding: 0.8rem;
+        border-radius: 6px;
+        text-align: center;
+      }
+      #progress-container {
+        display: none;
+        margin-top: 1rem;
+        text-align: center;
+      }
+      #progress-bar {
+        width: 100%;
+        height: 20px;
+        background-color: var(--progress-bg);
+        border-radius: 10px;
+        overflow: hidden;
+        display: block;
+        margin-bottom: 0.5rem;
+      }
+      #progress-bar::-webkit-progress-bar {
+        background-color: var(--progress-bg);
+        border-radius: 10px;
+      }
+      #progress-bar::-webkit-progress-value {
+        background-color: var(--progress-fill);
+        border-radius: 10px;
+      }
+      #progress-bar::-moz-progress-bar {
+        background-color: var(--progress-fill);
+        border-radius: 10px;
+      }
+      #progress-text {
+        font-weight: 600;
+        color: var(--subtle-text);
+      }
+      #control-buttons {
+        display: none;
+        margin-top: 1rem;
+      }
+      #pause-btn,
+      #cancel-btn {
+        margin: 0 0.5rem;
+        padding: 0.5rem 1rem;
+        font-size: 1rem;
+      }
+      #pause-btn.paused {
+        background-color: #28a745;
+      }
+      #pause-btn.paused:hover {
+        background-color: #218838;
+      }
+    </style>
+  </head>
+  <body>
+    <div class="container">
+      <h1>Facebook Video & Audio Downloader</h1>
+
+      <div class="tabs">
+        <button class="tab-button active" onclick="openTab(event, 'video')">
+          Video
+        </button>
+        <button class="tab-button" onclick="openTab(event, 'audio')">
+          Audio
+        </button>
+      </div>
+
+      <div id="video" class="tab-content active">
+        <form id="videoForm">
+          <input
+            type="text"
+            name="url"
+            placeholder="Enter Facebook Video URL"
+            required
+          />
+          <select name="format">
+            <option value="mp4">MP4</option>
+            <option value="webm">WebM</option>
+          </select>
+          <button type="submit">Download Video</button>
+        </form>
+        <p class="note">
+          Download Facebook videos in MP4 or WebM format. The download will
+          appear in your browser's download manager.
+        </p>
+      </div>
+
+      <div id="audio" class="tab-content">
+        <form id="audioForm">
+          <input
+            type="text"
+            name="url"
+            placeholder="Enter Facebook Video URL"
+            required
+          />
+          <select name="format">
+            <option value="mp3">MP3</option>
+            <option value="m4a">M4A</option>
+            <option value="wav">WAV</option>
+          </select>
+          <button type="submit">Download Audio</button>
+        </form>
+        <p class="note">
+          Extract audio from Facebook videos in various formats. The download
+          will appear in your browser's download manager.
+        </p>
+      </div>
+
+      <div id="status-container">
+        <div id="spinner" class="spinner"></div>
+        <div id="progress-container">
+          <progress id="progress-bar" value="0" max="100"></progress>
+          <div id="progress-text">0%</div>
+        </div>
+        <div id="control-buttons">
+          <button id="pause-btn">Pause</button>
+          <button id="cancel-btn" style="background-color: #dc3545">
+            Cancel
+          </button>
+        </div>
+        <div id="status"></div>
+      </div>
+    </div>
+
+    <script>
+      let isDownloading = false;
+      let paused = false;
+      let currentReader = null;
+      let currentChunks = [];
+      let currentReceived = 0;
+      let currentTotal = 0;
+      let currentResponse = null;
+
+      function openTab(evt, tabName) {
+        document
+          .querySelectorAll(".tab-content")
+          .forEach((tc) => tc.classList.remove("active"));
+        document
+          .querySelectorAll(".tab-button")
+          .forEach((tb) => tb.classList.remove("active"));
+        document.getElementById(tabName).classList.add("active");
+        evt.currentTarget.classList.add("active");
+      }
+
+      async function handleSubmit(e) {
+        e.preventDefault();
+
+        if (isDownloading) {
+          document.getElementById("status").textContent =
+            "A download is already in progress. Please wait or pause/cancel the current one.";
+          document.getElementById("status").classList.add("error");
+          return;
+        }
+
+        const form = e.target;
+        const submitButton = form.querySelector('button[type="submit"]');
+        const status = document.getElementById("status");
+        const spinner = document.getElementById("spinner");
+        const progressContainer = document.getElementById("progress-container");
+        const progressBar = document.getElementById("progress-bar");
+        const progressText = document.getElementById("progress-text");
+        const controlButtons = document.getElementById("control-buttons");
+
+        // Disable all download buttons
+        document
+          .querySelectorAll('button[type="submit"]')
+          .forEach((btn) => (btn.disabled = true));
+        isDownloading = true;
+        paused = false;
+
+        spinner.style.display = "block";
+        submitButton.disabled = true;
+        status.textContent =
+          "Initializing... Please wait, this may take a moment.";
+        status.classList.remove("error");
+        progressContainer.style.display = "none";
+        progressBar.value = 0;
+        progressText.textContent = "0%";
+        controlButtons.style.display = "none";
+
+        try {
+          const formData = new FormData(form);
+          const response = await fetch("/download", {
+            method: "POST",
+            body: formData,
+          });
+
+          if (!response.ok) {
+            const data = await response.json();
+            throw new Error(data.error || "An unknown server error occurred.");
+          }
+
+          status.textContent = "Streaming download...";
+          spinner.style.display = "none";
+          progressContainer.style.display = "block";
+          controlButtons.style.display = "block";
+
+          currentTotal = parseInt(
+            response.headers.get("Content-Length") || "0"
+          );
+          currentReceived = 0;
+          currentChunks = [];
+          currentReader = response.body.getReader();
+          currentResponse = response;
+
+          // Set up pause button
+          const pauseBtn = document.getElementById("pause-btn");
+          pauseBtn.onclick = togglePause;
+          pauseBtn.textContent = "Pause";
+          pauseBtn.classList.remove("paused");
+
+          // Set up cancel button
+          const cancelBtn = document.getElementById("cancel-btn");
+          cancelBtn.onclick = cancelDownload;
+
+          readChunk();
+        } catch (error) {
+          status.textContent = `Error: ${error.message}`;
+          status.classList.add("error");
+          resetDownloadState();
+        }
+      }
+
+      async function readChunk() {
+        if (!currentReader || !isDownloading) return;
+
+        try {
+          // If paused, wait and check again
+          while (paused && isDownloading) {
+            await new Promise((resolve) => setTimeout(resolve, 100));
+          }
+
+          if (!isDownloading) return;
+
+          const { done, value } = await currentReader.read();
+          if (done) {
+            // Download complete
+            await completeDownload();
+            return;
+          }
+
+          currentChunks.push(value);
+          currentReceived += value.length;
+
+          if (currentTotal > 0) {
+            const percent = Math.min(
+              (currentReceived / currentTotal) * 100,
+              100
+            ).toFixed(2);
+            document.getElementById("progress-bar").value = percent;
+            document.getElementById(
+              "progress-text"
+            ).textContent = `${percent}%`;
+          } else {
+            document.getElementById("progress-text").textContent = `${(
+              currentReceived /
+              1024 /
+              1024
+            ).toFixed(1)} MB`;
+          }
+
+          if (isDownloading) {
+            readChunk();
+          }
+        } catch (err) {
+          if (isDownloading) {
+            throw err;
+          }
+        }
+      }
+
+      function togglePause() {
+        paused = !paused;
+        const pauseBtn = document.getElementById("pause-btn");
+        if (paused) {
+          pauseBtn.textContent = "Resume";
+          pauseBtn.classList.add("paused");
+          document.getElementById("status").textContent = "Download paused.";
+        } else {
+          pauseBtn.textContent = "Pause";
+          pauseBtn.classList.remove("paused");
+          document.getElementById("status").textContent =
+            "Streaming download...";
+          readChunk(); // Resume reading
+        }
+      }
+
+      async function cancelDownload() {
+        isDownloading = false;
+        paused = false;
+        if (currentReader) {
+          await currentReader.cancel();
+        }
+        document.getElementById("status").textContent = "Download cancelled.";
+        document.getElementById("status").classList.add("error");
+        resetDownloadState();
+      }
+
+      async function completeDownload() {
+        isDownloading = false;
+        paused = false;
+
+        const blob = new Blob(currentChunks);
+        let downloadName = "facebook_content";
+        const contentDisposition = currentResponse.headers.get(
+          "Content-Disposition"
+        );
+        if (contentDisposition && contentDisposition.includes("attachment")) {
+          const filenameRegex = /filename[^;=\n]*="?([^";\n]*)"?/;
+          const matches = filenameRegex.exec(contentDisposition);
+          if (matches != null && matches[1]) {
+            downloadName = decodeURIComponent(matches[1]);
+          }
+        }
+
+        const url = window.URL.createObjectURL(blob);
+        const a = document.createElement("a");
+        a.style.display = "none";
+        a.href = url;
+        a.download = downloadName;
+        document.body.appendChild(a);
+        a.click();
+        window.URL.revokeObjectURL(url);
+        a.remove();
+
+        document.getElementById("status").textContent =
+          "Download complete! Check your browser's downloads.";
+        document.getElementById("progress-container").style.display = "none";
+        document.getElementById("control-buttons").style.display = "none";
+        resetDownloadState();
+      }
+
+      function resetDownloadState() {
+        document
+          .querySelectorAll('button[type="submit"]')
+          .forEach((btn) => (btn.disabled = false));
+        document.getElementById("spinner").style.display = "none";
+        document.getElementById("progress-container").style.display = "none";
+        document.getElementById("control-buttons").style.display = "none";
+        isDownloading = false;
+        paused = false;
+        currentReader = null;
+        currentChunks = [];
+        currentReceived = 0;
+        currentResponse = null;
+      }
+
+      document
+        .getElementById("videoForm")
+        .addEventListener("submit", handleSubmit);
+      document
+        .getElementById("audioForm")
+        .addEventListener("submit", handleSubmit);
+    </script>
+  </body>
+</html>

test.py

@@ -0,0 +1,54 @@
+import subprocess
+import os
+
+def download_fb_content(url, cookies_path):
+    """
+    Downloads content from a direct Facebook URL using gallery-dl.
+    
+    Args:
+        url (str): The direct URL to the Facebook content.
+        cookies_path (str): The path to the cookies.txt file.
+    """
+    
+    # First, check if the cookies file exists before attempting to download.
+    if not os.path.exists(cookies_path):
+        print(f"Error: Cookies file not found at '{cookies_path}'")
+        print("Please ensure the file exists and the path is correct.")
+        return  # Stop the function if cookies are missing
+
+    # --- Direct download logic ---
+    print("-" * 20)
+    print(f"Running gallery-dl for: {url}")
+    print("-" * 20)
+    
+    cmd = [
+        "gallery-dl",
+        "--cookies", cookies_path,
+        url
+    ]
+    
+    try:
+        # Run the command and check for any errors during execution.
+        subprocess.run(cmd, check=True)
+        print("\nDownload completed successfully.")
+        
+    except FileNotFoundError:
+        print("\n--- ERROR ---")
+        print("Command 'gallery-dl' not found.")
+        print("Please make sure gallery-dl is installed and accessible in your system's PATH.")
+        
+    except subprocess.CalledProcessError as e:
+        print("\n--- ERROR ---")
+        print(f"gallery-dl returned an error (Exit Code: {e.returncode}).")
+        print("This could be due to an invalid URL, private content, or expired cookies.")
+        print("Try running the command directly in your terminal for more detailed error messages.")
+
+# --- EXAMPLE ---
+
+# Set the path to your cookies file.
+# Make sure it's in the same directory as this script or provide the full path.
+cookies_file = "cookies.txt"
+
+print("--- Downloading Facebook Story Content ---")
+story_url = "https://www.facebook.com/stories/108639588358960/UzpfSVNDOjE1NjIwNDMzMjg0ODk0ODA=/?view_single=false"
+download_fb_content(story_url, cookies_file)

test.txt

@@ -0,0 +1,4 @@
+
+https://www.facebook.com/stories/122760247048923/UzpfSVNDOjEwNTY3ODYxNDY0NzUyMTY=/?bucket_count=9&source=story_tray
+
+https://www.facebook.com/share/v/1BqrcUihBf/