Upload 5 files

.gitattributes

@@ -1,35 +1,11 @@
-*.7z filter=lfs diff=lfs merge=lfs -text
-*.arrow filter=lfs diff=lfs merge=lfs -text
-*.bin filter=lfs diff=lfs merge=lfs -text
-*.bz2 filter=lfs diff=lfs merge=lfs -text
-*.ckpt filter=lfs diff=lfs merge=lfs -text
-*.ftz filter=lfs diff=lfs merge=lfs -text
-*.gz filter=lfs diff=lfs merge=lfs -text
-*.h5 filter=lfs diff=lfs merge=lfs -text
-*.joblib filter=lfs diff=lfs merge=lfs -text
-*.lfs.* filter=lfs diff=lfs merge=lfs -text
-*.mlmodel filter=lfs diff=lfs merge=lfs -text
-*.model filter=lfs diff=lfs merge=lfs -text
-*.msgpack filter=lfs diff=lfs merge=lfs -text
-*.npy filter=lfs diff=lfs merge=lfs -text
-*.npz filter=lfs diff=lfs merge=lfs -text
-*.onnx filter=lfs diff=lfs merge=lfs -text
-*.ot filter=lfs diff=lfs merge=lfs -text
-*.parquet filter=lfs diff=lfs merge=lfs -text
-*.pb filter=lfs diff=lfs merge=lfs -text
-*.pickle filter=lfs diff=lfs merge=lfs -text
-*.pkl filter=lfs diff=lfs merge=lfs -text
-*.pt filter=lfs diff=lfs merge=lfs -text
-*.pth filter=lfs diff=lfs merge=lfs -text
-*.rar filter=lfs diff=lfs merge=lfs -text
-*.safetensors filter=lfs diff=lfs merge=lfs -text
-saved_model/**/* filter=lfs diff=lfs merge=lfs -text
-*.tar.* filter=lfs diff=lfs merge=lfs -text
-*.tar filter=lfs diff=lfs merge=lfs -text
-*.tflite filter=lfs diff=lfs merge=lfs -text
-*.tgz filter=lfs diff=lfs merge=lfs -text
-*.wasm filter=lfs diff=lfs merge=lfs -text
-*.xz filter=lfs diff=lfs merge=lfs -text
-*.zip filter=lfs diff=lfs merge=lfs -text
-*.zst filter=lfs diff=lfs merge=lfs -text
-*tfevents* filter=lfs diff=lfs merge=lfs -text
+# Default behavior
+* text=auto
+
+# Python and Markdown
+*.py text eol=lf
+*.md text eol=lf
+
+# Hugging Face / GitHub Large File Storage (LFS) rules
+*.mp4 filter=lfs diff=lfs merge=lfs -text
+*.mkv filter=lfs diff=lfs merge=lfs -text
+*.webm filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,22 @@
+# Python artifacts
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+
+# Output videos (prevents accidental commits of large files)
+*.mp4
+*.mkv
+*.webm
+*.part
+*.ytdl
+
+# OS generated files
+.DS_Store
+Thumbs.db

README.md

@@ -0,0 +1,59 @@
+---
+title: X Video Downloader
+colorFrom: blue
+colorTo: indigo
+sdk: docker
+pinned: false
+---
+
+# X.com Video Downloader
+
+![Python](https://img.shields.io/badge/python-3.8+-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Maintenance](https://img.shields.io/badge/maintained-yes-brightgreen.svg)
+
+A robust, fast-processing Python tool to download high-quality video content from X.com (Twitter) links. 
+
+**Author:** algorembrant
+
+## Architecture and Flow
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant CLI as x_downloader.py
+    participant YTDLP as yt-dlp Core
+    participant X as X.com Servers
+    participant Local as Local Storage
+
+    User->>CLI: python x_downloader.py "url"
+    CLI->>YTDLP: Pass URL and Configuration
+    YTDLP->>X: Request Metadata & Media Streams
+    X-->>YTDLP: Return Video Stream & Audio Stream
+    YTDLP->>Local: Download Streams
+    YTDLP->>Local: Merge via FFmpeg (mp4)
+    Local-->>CLI: Success Status
+    CLI-->>User: "Download completed successfully."
+
+```
+.
+## File Structure
+├── .gitattributes
+├── .gitignore
+├── README.md
+├── requirements.txt
+└── x_downloader.py
+
+
+- 1	Install Python	Ensure Python 3.8+ is installed on your system.
+- 2	Install FFmpeg	
+    - Windows: Download from gyan.dev, extract, and add the bin folder to your System PATH.
+    - macOS: brew install ffmpeg
+    - Linux (Debian/Ubuntu): sudo apt update && sudo apt install ffmpeg
+- 3	Create Directory	Create a folder for your project and navigate into it.
+- 4	Set up Virtual Env	python -m venv venv (then activate it: venv\Scripts\activate on Windows or source venv/bin/activate on Mac/Linux).
+- 5	Save Files	Save the provided .py, requirements.txt, .gitignore, .gitattributes, and README.md files in your directory.
+- 6	Install Libraries	pip install -r requirements.txt
+- 7	Run the Script	Execute the script using the commands listed at the top of the Python file.
+
+**Note**: FFmpeg is strictly required. X.com often serves video and audio as separate streams to optimize bandwidth; FFmpeg allows the script to rapidly merge them back into a single MP4 file without quality loss.

requirements.txt

@@ -0,0 +1 @@
+yt-dlp>=2023.11.16

x_downloader.py

@@ -0,0 +1,91 @@
+"""
+X.com Video Downloader
+Author: algorembrant
+
+Usage Commands:
+1. Basic usage (download to current directory with default title):
+   python x_downloader.py "https://x.com/user/status/123456789"
+
+2. Specify output directory:
+   python x_downloader.py "https://x.com/user/status/123456789" -o "./downloads"
+
+3. Specify custom filename (must include extension, e.g., .mp4):
+   python x_downloader.py "https://x.com/user/status/123456789" -f "my_video.mp4"
+"""
+
+import argparse
+import sys
+import os
+import yt_dlp
+
+def download_x_video(url: str, output_dir: str = None, filename: str = None) -> None:
+    """
+    Downloads a video from an X.com link using yt-dlp.
+    """
+    print(f"Initializing download for: {url}")
+    
+    # Base configuration for optimal processing
+    ydl_opts = {
+        'format': 'bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best',
+        'merge_output_format': 'mp4',
+        'quiet': False,
+        'no_warnings': True,
+        'updatetime': False,
+    }
+
+    # Handle output paths
+    if filename:
+        if output_dir:
+            ydl_opts['outtmpl'] = os.path.join(output_dir, filename)
+        else:
+            ydl_opts['outtmpl'] = filename
+    else:
+        if output_dir:
+            ydl_opts['outtmpl'] = os.path.join(output_dir, '%(title)s_%(id)s.%(ext)s')
+        else:
+            ydl_opts['outtmpl'] = '%(title)s_%(id)s.%(ext)s'
+
+    try:
+        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+            print("Extracting video metadata and downloading...")
+            error_code = ydl.download([url])
+            
+            if error_code == 0:
+                print("Download completed successfully.")
+            else:
+                print(f"Download finished with non-zero exit code: {error_code}")
+                sys.exit(1)
+                
+    except yt_dlp.utils.DownloadError as e:
+        print(f"Error during download: {str(e)}")
+        sys.exit(1)
+    except Exception as e:
+        print(f"An unexpected error occurred: {str(e)}")
+        sys.exit(1)
+
+def main():
+    parser = argparse.ArgumentParser(description="Download videos from X.com links.")
+    parser.add_argument("url", help="The full X.com (or Twitter) status URL.")
+    parser.add_argument("-o", "--output-dir", type=str, help="Directory to save the video.")
+    parser.add_argument("-f", "--filename", type=str, help="Custom filename (e.g., video.mp4).")
+    
+    args = parser.parse_args()
+
+    # Validate URL structure loosely
+    if "x.com" not in args.url and "twitter.com" not in args.url:
+        print("Error: The provided URL does not appear to be a valid X.com or Twitter link.")
+        sys.exit(1)
+        
+    # Ensure output directory exists if provided
+    if args.output_dir and not os.path.exists(args.output_dir):
+        try:
+            os.makedirs(args.output_dir)
+            print(f"Created output directory: {args.output_dir}")
+        except OSError as e:
+            print(f"Error creating output directory: {e}")
+            sys.exit(1)
+
+    download_x_video(args.url, args.output_dir, args.filename)
+
+if __name__ == "__main__":
+    main()