Doc no. SK-404DatasheetRev 2026.11Sheet 2.19 of 4
grab
Batch downloader for videos, image posts and files: a CLI, a browser GUI, a Mac app and a stream-catching extension, built on yt-dlp, gallery-dl and aria2c.
Active
Source on GitHub
$ grab URL --concurrency 8
Block diagram
Characteristics
| Video & streams | Uses yt-dlp and ffmpeg across ~1,800 sites plus .m3u8 (HLS), .mpd (DASH), ISM and RTMP fetched in parallel fragments |
|---|---|
| Image posts | Routes Reddit, X, Instagram, Imgur, Pixiv, DeviantArt, Flickr, Tumblr and booru galleries through gallery-dl |
| Direct files | Accelerates ZIPs, ISOs, PDFs and media downloads over aria2c (up to 16 connections per file with automatic fallback) |
| Browser fallback | Falls back to a page extractor and headless Chromium engine for JS-rendered embeds (DRM streams refused) |
| Interfaces | Python CLI (grab), local web UI (127.0.0.1:8765), native Swift Mac menu-bar app and a Chrome stream-catcher extension |
Overview & build notes
Routes any pasted URL automatically to the engine best suited for it — yt-dlp for video platforms and HLS/DASH streams, gallery-dl for image galleries and aria2c for direct multi-connection file transfers.
Playlists and channel URLs expand into concurrent worker queues (default 4, configurable up to 32), while analyze.py and browser.py handle JavaScript-gated embeds when standard extractors don't recognise a page.
Four front doors share the same Python core: direct CLI invocation, a local FastAPI web GUI (ui.html / web.py), a native Swift macOS app wrapper (app/main.swift) and the Stream Catcher browser extension (browser-extension/).
Files & artifacts
| Kind | File | Details | Size |
|---|---|---|---|
| Source | grab/core.py | URL routing, concurrent worker queue and extractor orchestration on GitHub | GitHub |
| Source | grab/browser.py | Headless Chromium stream sniffer and fallback page extractor on GitHub | GitHub |
| Mac app | app/main.swift | Native Swift desktop frontend wrapping the local download queue on GitHub | GitHub |
| Extension | browser-extension/ | Stream Catcher manifest, media detector and popup scripts on GitHub | GitHub |