# SnapVid

> SnapVid is a high-speed, privacy-first online video and audio downloader engineered by Ameer Medhat. It extracts clean, original-quality media from YouTube (single videos and full playlists), TikTok (without watermark), Instagram Reels, Facebook, and X (Twitter) via an encrypted, zero-storage direct stream pipeline.

## Overview

SnapVid (`https://snapvid.ameermedht.com/`) is designed for fast, frictionless media extraction directly in any modern browser without requiring app installations, browser extensions, or subscriptions. It features a bilingual interface (English primary LTR, Arabic secondary RTL) built strictly following human-first Anti-Slop design principles and high-contrast accessibility.

## Key Capabilities

- **Single Video Downloader**: Extracts direct MP4 streams up to 1080p Full HD from YouTube, TikTok, Instagram Reels, and Facebook.
- **Full YouTube Playlist Downloader**: Analyzes public YouTube playlists, generates structured video lists, allows one-click batch link copying, and enables individual video downloads.
- **Watermark Removal**: Automatically detects and provides clean TikTok video streams without watermarks.
- **Audio Extractor (MP3)**: Isolates high-bitrate audio streams from video links for music and podcasts.
- **Direct Streaming Pipeline**: Uses chunked HTTP streaming (`download.php`) with zero permanent disk storage on the server, ensuring user privacy and instant transfers.
- **Multi-Tier Fallback Engine**: Employs redundant extraction gateways (Invidious API, Cobalt Engine, and local yt-dlp CLI) to ensure 99.9% extraction uptime.

## Supported Platforms

| Platform | Supported Formats | Features |
| :--- | :--- | :--- |
| **YouTube** | MP4 (1080p, 720p, 480p, 360p), MP3 Audio | Single videos, Shorts, and Full Playlists (`&list=...`) |
| **TikTok** | Original MP4, Audio | Clean video stream without watermark |
| **Instagram** | MP4 Video | Reels, Posts, and Video clips |
| **Facebook** | HD / SD MP4 | Public videos, Reels, and Watch clips |
| **X (Twitter)** | MP4 Video | Video tweets and clips |

## Architecture & API Reference

### Extraction Endpoint
- **URL**: `POST https://snapvid.ameermedht.com/api/extract.php`
- **Headers**: `Content-Type: application/json`
- **Payload Schema**:
  ```json
  {
    "url": "https://www.youtube.com/watch?v=VIDEO_ID",
    "mode": "single"
  }
  ```
  *(Set `"mode": "playlist"` when querying a YouTube playlist URL).*
- **Response Schema (Single Video)**:
  ```json
  {
    "success": true,
    "data": {
      "url": "https://www.youtube.com/watch?v=...",
      "platform": { "id": "youtube", "name": "YouTube", "badge": "يوتيوب", "color": "#EF4444" },
      "title": "Video Title",
      "thumbnail": "https://...",
      "duration_str": "03:45",
      "has_playlist": false,
      "qualities": [
        { "label": "1080p Full HD", "ext": "mp4", "download_url": "https://...", "is_recommended": true, "badge": "HD" }
      ],
      "audio": [
        { "label": "MP3 High Quality", "ext": "mp3", "download_url": "https://...", "badge": "Audio" }
      ]
    }
  }
  ```
- **Response Schema (Playlist)**:
  ```json
  {
    "success": true,
    "data": {
      "is_playlist": true,
      "url": "https://www.youtube.com/playlist?list=...",
      "platform": { "id": "youtube", "name": "YouTube" },
      "title": "Playlist Name",
      "uploader": "Channel Name",
      "total_videos": 25,
      "videos": [
        {
          "index": 1,
          "id": "VIDEO_ID",
          "title": "Item Title",
          "duration_str": "04:12",
          "thumbnail": "https://...",
          "url": "https://www.youtube.com/watch?v=VIDEO_ID"
        }
      ]
    }
  }
  ```

### Direct Download Proxy
- **URL**: `GET https://snapvid.ameermedht.com/download.php?url={ENCODED_STREAM_URL}&title={FILENAME}&ext={mp4|mp3}&platform={PLATFORM_ID}`
- **Behavior**: Streams media chunks directly to client HTTP response headers (`Content-Disposition: attachment; filename="..."`) without saving bytes to local server storage.

## Creator & Attribution
- **Creator & Lead Engineer**: Ameer Medhat
- **Personal Website**: [ameermedhat.com](https://ameermedhat.com)
- **Deployment Target**: Hostinger Shared Hosting (PHP 8.x + MySQL + Vanilla JS/HTML5/CSS3)
- **License / Usage**: 100% Free Public Utility

## Links
- [SnapVid Web App](https://snapvid.ameermedht.com/)
- [Ameer Medhat Portfolio](https://ameermedhat.com)
- [How-to Guide](https://snapvid.ameermedht.com/#howto)
- [Frequently Asked Questions](https://snapvid.ameermedht.com/#faq)