Final Update: README and Native Muxer Polish

Author: Hamas

README.md

@@ -3,185 +3,64 @@
 > **The World's First Pure-Dart, Zero-FFmpeg Media Engine for 8K Performance & 1,000+ Site Scalability.**
 
 [![Pure Dart](https://img.shields.io/badge/Pure-Dart-blue?logo=dart)](https://dart.dev)
+[![Kotlin](https://img.shields.io/badge/Kotlin-Native-purple?logo=kotlin)](https://kotlinlang.org)
+[![Swift](https://img.shields.io/badge/Swift-Native-orange?logo=swift)](https://developer.apple.com/swift)
 [![Zero FFmpeg](https://img.shields.io/badge/Zero-FFmpeg-green)](https://github.com/hamas/dart_dlp)
 [![License](https://img.shields.io/badge/License-MIT-purple)](LICENSE)
 
 ---
 
 ## 📖 Introduction
 
-**dart_dlp** is a revolutionary media extraction engine designed to liberate Dart and Flutter developers from the constraints of heavy external binaries. Unlike traditional solutions that wrap `yt-dlp` (Python) or require massive `ffmpeg` bundles, `dart_dlp` is built from the ground up in **100% Pure Dart**.
+**dart_dlp** is a revolutionary media extraction engine designed to liberate Dart and Flutter developers from the constraints of heavy external binaries. Unlike traditional solutions that wrap `yt-dlp` (Python) or require massive `ffmpeg` bundles, `dart_dlp` is built from the ground up to be **Lightweight and Invincible**.
 
-It is engineered for **Hyper-Scale** and **Stealth**, capable of navigating complex anti-bot protections, executing rolling cipher decryption natively, and delivering 8K video streams without a single byte of compiled native code.
+It combines a **Pure Dart** extraction core with a **Native (Kotlin/Swift)** muxing bridge, delivering 8K video streams without a single byte of compiled FFmpeg or Python code.
 
-### Why dart_dlp?
-
-1.  **Zero Dependencies**: No Python, no node.js, no FFMPEG binaries required to *run*.
-2.  **Native Performance**: Everything happens in the Dart VM.
-3.  **HamasDownloader™**: A proprietary, multi-threaded chunked downloader that saturates your bandwidth by opening parallel connections.
-4.  **Stealth Mode**: Rotates between 50+ real-world User-Agents and injects human-like HTTP headers (`Sec-Fetch-*`) to evade IP blocking.
-5.  **Architecture**: Decoupled design allows you to run this on a server, in a CLI, or embedded directly in a Flutter app.
-
----
-
-## ✅ Supported Platforms
-
-The engine comes pre-loaded with highly optimized extractors for the "Major 5" social giants, plus generic extendability.
-
-| Platform | Features | Stealth Level |
-| :--- | :--- | :--- |
-| **YouTube** | 8K/4K/1080p, Rolling Cipher Decryption (JS), Separate Audio/Video Streams | 🛡️ High |
-| **TikTok** | Watermark-free Video, JSON Rehydration parsing | 🛡️ Medium |
-| **Instagram** | `window._sharedData` parsing, Reels & Posts | 🛡️ High |
-| **Facebook** | SD/HD Source Extraction, Regex-based parsing | 🛡️ Medium |
-| **X (Twitter)** | `__NEXT_DATA__` Traversal | 🛡️ High |
-| **Reddit** | Native JSON API (`.json`) extraction | 🛡️ Low |
-| **Pinterest** | `__PWS_DATA__` extraction | 🛡️ Medium |
+It is engineered for **Hyper-Scale** and **Stealth**, capable of navigating complex anti-bot protections and executing rolling cipher decryption.
 
 ---
 
-## 📦 Installation
-
-Since `dart_dlp` is a premium, high-performance engine, it is distributed via Git to ensure you always have the latest anti-censorship patches.
-
-Add this to your `pubspec.yaml`:
-
-```yaml
-dependencies:
-  dart_dlp:
-    git:
-      url: https://github.com/hamas/dart_dlp.git
-      ref: main
-```
-
-Run the installation:
+### Why dart_dlp?
 
-```bash
-dart pub get
-```
+1.  **Zero External Binaries**: No Python, no node.js.
+2.  **Native Muxing**: Uses Android's `MediaMuxer` and iOS's `AVAssetExportSession` to merge 4K video+audio instantly (Zero-Encoding).
+3.  **HamasDownloader™**: A proprietary, multi-threaded chunked downloader that saturates your bandwidth by opening parallel connections.
+4.  **Stealth Mode**: Rotates between 50+ real-world User-Agents and injects human-like HTTP headers (`Sec-Fetch-*`) to evade IP blocking.
+5.  **Architecture**: Decoupled design allows for pure Dart usage (extraction only) or full Flutter Plugin power (muxing enabled).
 
 ---
 
-## 🛠️ Usage & Architecture
-
-The system is composed of three core pillars: **The Engine**, **The Extractor**, and **The Downloader**.
-
-### 1. The DlpEngine (The Brain)
-
-The `DlpEngine` is the central command dispatcher. It accepts a raw URL, identifies the correct registered extractor, and routes the request.
-
-**Initialization:**
-
-```dart
-import 'package:dart_dlp/dart_dlp.dart';
-
-// Create the engine
-final engine = DlpEngine();
-```
-
-**Stealth Configuration:**
-To avoid IP bans when scraping thousands of urls, pass a proxy:
-
-```dart
-final engine = DlpEngine(proxy: 'http://user:[email protected]:8080');
-// This proxy is automatically propagated to every extractor.
-```
-
-### 2. Analysis & Extraction
-
-Calling `extract` returns a `VideoData` object. This object is a normalized representation of the media, regardless of whether it came from YouTube, TikTok, or Reddit.
-
-```dart
-try {
-  final url = 'https://www.youtube.com/watch?v=dQw4w9WgXcQ';
-  
-  // The engine automatically executes JS decryption if needed
-  final VideoData video = await engine.extract(url);
-
-  print('Title: ${video.title}');
-  print('Duration: ${video.duration}');
-  print('Thumbnail: ${video.thumbnail}');
-  
-  // Inspect available qualities
-  for (var stream in video.streams) {
-    print('[${stream.quality}] ${stream.format} - ${stream.url}');
-  }
-} catch (e) {
-  print('Extraction failed: $e');
-}
-```
-
-### 3. The HamasDownloader (The Muscle)
+## ⚙️ Advanced Features
 
-Standard HTTP requests are slow. `dart_dlp` ships with `HamasDownloader`, a specialized tool that uses **HTTP Range Headers** to download file chunks in parallel.
+### ⚡ HD Download & Native Muxing (The "Super" Pattern)
+YouTube (and others) often serve 1080p+ video as separate Video and Audio tracks.
+`dart_dlp` handles this automatically using its Native Bridge.
 
-```dart
-// 1. Select the best stream (e.g., 1080p video)
-final stream = video.streams.firstWhere((s) => s.quality == '1080p');
-
-// 2. Initialize Downloader
-final downloader = HamasDownloader();
-
-// 3. Start Download
-await downloader.download(
-  stream.url,
-  'path/to/video.mp4',
-  onProgress: (DownloadProgress progress) {
-    // Real-time stats
-    final percent = (progress.progress * 100).toStringAsFixed(1);
-    final speed = progress.speedMBps.toStringAsFixed(2);
-    final eta = progress.etaSeconds;
-    
-    print('$percent% downloaded | Speed: $speed MB/s | ETA: ${eta}s');
-  }
-);
-```
+**Zero-FFmpeg Requirement:**
+We utilize the device's native APIs (`MediaMuxer` on Android, `AVAssetExportSession` on iOS) to merge streams instantly without re-encoding. This keeps the app size tiny only adding ~20KB to your bundle, compared to FFmpeg's ~50MB.
 
-### 4. DlpController (State Management)
-For Flutter apps usage, `DlpController` provides a reactive stream of state changes (`analyzing`, `downloading`, `merging`, `completed`, `error`).
+**How it works:**
+1.  **Detects** if a video is split (e.g., 4K stream).
+2.  **Downloads** video and audio tracks concurrently.
+3.  **Invokes** the Native Bridge to merge them in seconds.
+4.  **Cleans up** temporary files.
 
 ```dart
 final controller = DlpController();
-controller.stateStream.listen((state) {
-  if (state.status == DlpStatus.downloading) {
-    print('Downloading... ${state.progress}%');
-  } else if (state.status == DlpStatus.completed) {
-    print('Done! File at: ${state.message}');
+
+// Listen to status updates (Extracting -> Downloading -> Merging -> Completed)
+controller.state.listen((state) {
+  print('[${state.status}] ${state.message}');
+  if (state.status == DlpStatus.merging) {
+    print('Merging Video & Audio streams...');
   }
 });
 
-// One-liner execution
-controller.process('https://tiktok.com/...', '/downloads/');
-```
-
----
-
-## ⚙️ Advanced Features
-
-### Handling Split Streams (The "NativeMuxer" Pattern)
-YouTube (and others) often serve 1080p+ video as separate Video and Audio tracks.
-`dart_dlp` detects this automatically.
-
-In **Pure Dart Mode**, the `NativeMuxer` is a no-op interface. The controller will download **both** files and return their paths.
-
-```text
-Result:
-- video_1080p.mp4 (Video Only)
-- audio_128k.m4a (Audio Only)
+// Start the Magic (Auto-Muxing included)
+final path = await controller.startDownload(videoData, '/storage/emulated/0/Download');
+print('Saved to: $path');
 ```
 
-It is up to your application layer (Server or Client) to invoke `ffmpeg` or `mkvmerge` if you wish to combine them. This keeps `dart_dlp` lightweight and portable.
-
-### Rolling Cipher Decryption
-YouTube protects high-value streams with a "Rolling Cipher" in their JavaScript.
-`dart_dlp` includes a **JS Execution Engine** (via `flutter_js` or pure Regex parsing) that:
-1.  Downloads the player JavaScript.
-2.  Parses the obfuscated decryption functions.
-3.  Executes the math to solve the signature challenge.
-4.  Unlocks the 4K stream URL.
-
-All of this happens transparently inside `YouTubeExtractor`.
-
 ---
 
 ## 🛡️ Stealth Technology

android/.gradle/9.2.0/checksums/checksums.lock

@@ -0,0 +1,2 @@
+#Fri Jan 30 20:28:44 PKT 2026
+gradle.version=9.2.0