StreamSaver Video Sniffer - User Manual

📖 Introduction

This Userscript is a high-performance video downloader designed for Android (Kiwi Browser) and PC (Chrome/Edge). Unlike traditional downloaders that store the entire video in RAM (causing crashes with large files), this script uses StreamSaver.js. It creates a virtual download stream, writing data directly to your device's storage in real-time.

🛠️ Prerequisites

1. Browser:
   • PC: Google Chrome, Microsoft Edge.
   • Android: Kiwi Browser (Recommended) or Firefox Nightly.
   • ❌ iOS (iPhone/iPad) is NOT supported due to Apple's system restrictions.
2. Extension: Tampermonkey or Violentmonkey.
3. Network: A stable internet connection is required (pausing is not supported).

🚀 How to Use

1. Install: Create a new script in Tampermonkey and paste the provided code.
2. Browse: Open a video website (must be HTTPS) and play a video.
3. Sniff: A floating button (⚡) or a panel will appear on the right side of the screen when a video link (M3U8 or MP4) is detected.
4. Download:
   • Click the "Stream Download" button.
   • Important: You will see a download starting from jimmywarting.github.io or streamsaver.mitm. This is normal. It is the bridge allowing the browser to save files directly to your disk.
5. Finish:
   • The button will show the percentage (e.g., "15%").
   • Wait until the text changes to "Done". The file will appear in your default "Downloads" folder.

⚠️ Important Limitations

• DO NOT use Incognito/Private Mode: The script requires access to a Service Worker to handle the stream. Incognito mode blocks this, causing the download to fail.
• HTTPS Only: The script only works on secure (HTTPS) websites.
• Do Not Close the Tab: You must keep the video page open while downloading. Closing it will kill the process.
• Android Storage: On Android, the file is written to the system's "Downloads" folder. Due to the streaming nature, the "Total Size" might appear unknown until finished.

❓ FAQ

Q: Why does the download show it's coming from github.io? A: This is the "Man-in-the-Middle" (MITM) technique. Since the script cannot register a Service Worker on the video site directly (due to security rules), it uses a proxy page to handle the file saving. Your data is safe; it just passes through locally.

Q: Why doesn't it work on iPhone? A: Apple's Safari (WebKit) blocks the Service Worker technologies required for this specific method.