Skip to content

coflyn/Ivory

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ivory

Version License

Ivory is an advanced, minimalist Chrome extension designed to bypass platform protections and securely download media files (MP4, HLS, DASH, Blob) from strictly protected websites.

What's New

  • Turbo Download Settings (Thread Control): Added a dynamic slider in the settings panel to manually control the HLS parallel download limit. Users with high-speed internet can crank the thread concurrency up to 20x for blazing fast downloads.
  • Minimalist Progress UI: Redesigned the download progress bar to perfectly match the sleek, monochrome aesthetic. Features a clean 4px track, dynamic accent colors, and separated processing labels.
  • HLS Compatibility Fixes: Restored global declarativeNetRequest rules (CORS & Referer spoofing) to fix HLS downloads, while simultaneously adding targeted domain exclusions to prevent the extension from breaking TikTok's internal page navigation and video player.
  • HLS Segments Bug Fix: Fixed an undefined variable crash (totalSegments) in the offscreen document that caused HLS downloads to immediately fail before muxing.

Previous Updates

  • Interactive PDF Image Picker: Added a full-screen interactive modal displaying a thumbnail grid of detected images. Users can selectively include/exclude images (to filter out banners or placeholders) before merging into a final PDF.
  • Dynamic WebP to jsPDF Conversion: Bypasses jsPDF limitations by using an off-screen HTML canvas to automatically convert WebP and GIF images into JPEGs on the fly before PDF rendering.
  • Advanced Image & Manga Detection: Added support for detecting images (.webp, .jpg, .png, .gif) including those obscured by application/octet-stream headers, complete with categorized UI filters.
  • Dynamic UI Customization: Introduced a fully functional Settings Panel with options to enable/disable network media scanning on the fly, toggle CORS bypass and auto-merge, set default video quality, change the primary Accent Color, and switch the UI Font (defaulting to Google's Plus Jakarta Sans).
  • Cloudflare & Anti-Leech Bypass: Implemented a dual-layered strategy combining Manifest V3 declarativeNetRequest rules to dynamically spoof Referer headers at the network level, and an isolated content_script to fetch media directly from the origin DOM context, seamlessly bypassing Cloudflare challenges and strict cookie checks.
  • Modern Toggle Switch UI: Upgraded the settings panel interface by replacing generic OS checkboxes with custom-styled, animated toggle switches that adapt dynamically to the user's configured Accent Color.

Features

  • Media Detection: Intercepts and captures HLS (m3u8), DASH (mpd), TS, and MP4 streams from network traffic. Employs advanced sniffing (details.type === 'media') to catch videos obscured by fake extensions (like .json) or obfuscated MIME types.
  • Targeted Domain Exclusions: Smartly excludes specific sites (like TikTok) from aggressive script injection and global header modifications to ensure complex Single Page Applications don't crash.
  • FFmpeg WebAssembly Integration: Embedded @ffmpeg/core engine muxes decrypted HLS chunks directly into a pure, lossless .mp4 file within the browser's memory.
  • Dynamic Referer Spoofing: Automatically records and utilizes the origin website's URL as the Referer header. Supports both Offscreen FFmpeg processing and Chrome's Native Download Manager to seamlessly bypass strict CDNs.
  • Parallel Downloading: Utilizes a Promise-based concurrent worker pool to fetch multiple HLS segments simultaneously. Users can dynamically scale the concurrency limit up to 20x in settings, unlocking maximum download speeds on high-bandwidth connections.
  • AES-128 Decryption: Handles encrypted HLS streams transparently — downloads the key, derives the IV, and decrypts every segment before assembly.
  • Header Bypass & CORS Injection: Forces Access-Control headers to circumvent rigid cross-origin restrictions.
  • CDN Anti-Hang Protocol: Implements AbortController and Retry mechanisms (up to 3 attempts with a 15s timeout) to prevent silent connection drops from aggressive server CDNs.
  • Instant Abort Control: Users can instantly cancel long-running HLS downloads via the UI, immediately halting all parallel fetches and freeing up memory.
  • MSE Capture: Injects scripts into Media Source Extensions to capture raw video buffers directly from the DOM before they are played.
  • Native Background Download: Defers standard media formats to Chrome's native download manager for zero-memory, popup-independent background downloading.
  • Offscreen Processing: Uses Chrome Manifest V3 Offscreen Documents to merge and assemble HLS/DASH fragments seamlessly in the background without requiring the popup to stay open.
  • Smart Filenaming: Automatically extracts the original filename from CDN URLs and enforces correct extensions based on processing results.
  • Pure Minimalist UI: Sleek, modern, monochrome user interface with dynamic placeholders and real-time FFmpeg Muxing progress tracking.

Installation

  1. Go to chrome://extensions/ in your browser.
  2. Enable Developer mode in the top right corner.
  3. Click Load unpacked and select the Ivory directory.

Usage

  1. Open a video on supported or custom streaming platforms.
  2. Click the Ivory icon in your extensions toolbar.
  3. Review the available quality and formats, then click Download on the detected media.

License

MIT

About

An Chrome extension to bypass strict CDNs and download HLS/DASH media with on-the-fly FFmpeg muxing

Resources

License

Stars

2 stars

Watchers

0 watching

Forks

Releases

No releases published

Contributors