OmniFetch Universal video downloader built with Electron, Vue 3, and yt-dlp. Supports 1000+ websites including YouTube, X, Bilibili, Douyin, and more.

For the full list of 1000+ supported sites, see Supported Sites.

---

Core

Features

Emoji	Feature	Description
🚀	Universal Download	Download videos from 1000+ websites with yt-dlp compatibility
📥	One-click Parse	Enter a video URL and inspect available formats
🎚️	Format Selection	Choose video/audio quality, codec, and output container
⏱️	Progress & Speed	Show live progress percentage, speed, and ETA
⏸️	Pause / Resume / Cancel	Control active downloads and recover from interruptions
⚙️	Bundled Runtime	Includes built-in yt-dlp and ffmpeg binaries for local use
🔒	Secure IPC	Uses Electron contextBridge with a safe preload API

Quick Start

1. Requirements

   • Node.js >= 18
   • macOS / Windows / Linux

2. Install dependencies

   npm install

3. Download runtime binaries

   ⚠️ Note: Binaries are platform-specific. You must run npm run download:bins on the target platform to fetch the matching build. Copying binaries across platforms causes incompatibility (e.g. a macOS Mach-O binary cannot run on Windows).

   ⚠️ Note: Unless you specifically need the latest version, avoid frequent online binary updates. Upstream download sources are unstable and may have a high failure rate. Prefer the bundled binaries shipped with the repository.

   npm run download:bins

4. Start the renderer dev server

   npm run dev

5. Launch Electron in development mode

   npm run electron:dev

6. Build the production app

   npm run build

7. Package the release build

   npm run electron:build

Usage

1. Open OmniFetch.
2. Paste a video link into the URL input.
3. Click Parse to load metadata and available formats.
4. Select a download format from the list.
5. Choose an output folder.
6. Click Download.
7. Watch live progress, speed, and ETA in the UI.
8. Use Pause, Resume, or Cancel as needed.

When you cancel a download, OmniFetch prompts whether to delete the partial file.

⚠️ Network prerequisite: Parsing and downloading require your local network to be able to access the target video site normally (e.g. Bilibili, YouTube). If your network cannot open these sites in a browser, OmniFetch will be unable to parse video info or download videos. We recommend confirming you can open the target link in a browser before using this tool.

Runtime Binary Support

OmniFetch ships with bundled runtime binaries, organized by platform-arch under bin/:

• bin/win32-x64/yt-dlp.exe + ffmpeg.exe
• bin/darwin-arm64/yt-dlp + ffmpeg (Apple Silicon)
• bin/darwin-x64/yt-dlp + ffmpeg (Intel)
• bin/linux-x64/yt-dlp + ffmpeg
• bin/linux-arm64/yt-dlp + ffmpeg (Raspberry Pi / ARM servers)

⚠️ Binaries are platform-specific. You must run npm run download:bins on the target platform to fetch the matching build. Copying binaries across platforms causes incompatibility (e.g. a macOS Mach-O binary cannot run on Windows).

These binaries are included as extra resources during packaging. If you run from source, execute npm run download:bins first to ensure the local runtime tools are available.

The Electron main process resolves built-in binaries via electron/bin-resolver.ts (with magic-number validation to ensure platform match). If no matching built-in binary is found, it falls back to the system PATH for yt-dlp / ffmpeg. If both are missing, the app shows a clear error with a fix hint (run npm run download:bins).

Bundled versions & auto-update

The app ships prebuilt binaries for all platforms in the installer, and bin/manifest.json records the bundled version per platform-arch. On startup:

• If the bundled binary for the current platform-arch is already up to date (matches manifest.json), the app skips the online update and uses the bundled file directly.
• If an upstream update is detected, a warning is shown at the top of the UI, explicitly noting that online downloads have a high failure rate and recommending the bundled binaries; whether to update online is left to the user.

Binary download links per platform

These are the exact latest sources used by npm run download:bins. When bundling manually, place files under bin/<platform>-<arch>/ and record the actual version in bin/manifest.json.

yt-dlp

Platform-arch	Download URL	Stored as
win32-x64	https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp.exe	bin/win32-x64/yt-dlp.exe
darwin-arm64	https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp_macos	bin/darwin-arm64/yt-dlp
darwin-x64	https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp_macos	bin/darwin-x64/yt-dlp
linux-x64	https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp_linux	bin/linux-x64/yt-dlp
linux-arm64	https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp_linux	bin/linux-arm64/yt-dlp

Note: the macOS yt-dlp build is a universal binary, so darwin-arm64 and darwin-x64 share the same URL; on Linux, x64 and arm64 share the same yt-dlp_linux URL.

Proxy Auto-Detection

OmniFetch auto-detects a proxy and passes it to yt-dlp via --proxy, so you don't need to configure it manually for most setups. Detection priority:

1. Environment variables (cross-platform): HTTPS_PROXY / HTTP_PROXY / ALL_PROXY (and lowercase variants).
2. Windows system proxy: read from the Internet Settings registry (HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings, ProxyEnable / ProxyServer), supporting both protocol-specific (http=...;https=...;socks=...) and single-address formats.
3. macOS system proxy: read via scutil --proxy (HTTPS / HTTP).
4. Linux system proxy: read from GNOME gsettings (org.gnome.system.proxy.{http,https,socks}, manual mode) with a fallback to KDE kreadconfig5 (proxysettings).

If no proxy is detected, yt-dlp connects directly. For geo-blocked or restricted sites (e.g. xhamster.desi), enable your VPN/proxy and make sure it is exposed either as the system proxy or via the HTTPS_PROXY environment variable (e.g. http://127.0.0.1:7890), otherwise the connection may be reset (curl: (35) Recv failure: Connection was reset).

ffmpeg

Platform-arch	Download URL	Extract to
win32-x64	https://github.com/BtbN/FFmpeg-Builds/releases/download/latest/ffmpeg-master-latest-win64-gpl.zip	extract bin/ffmpeg.exe → bin/win32-x64/ffmpeg.exe
darwin-arm64	https://evermeet.cx/ffmpeg/ffmpeg-7.0.2.zip	extract ffmpeg → bin/darwin-arm64/ffmpeg
darwin-x64	https://evermeet.cx/ffmpeg/ffmpeg-7.0.2.zip	extract ffmpeg → bin/darwin-x64/ffmpeg
linux-x64	https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-amd64-static.tar.xz	extract ffmpeg-*-static/ffmpeg → bin/linux-x64/ffmpeg
linux-arm64	https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-arm64-static.tar.xz	extract ffmpeg-*-static/ffmpeg → bin/linux-arm64/ffmpeg

Note: Windows/Linux ffmpeg ships as an archive and must be extracted; macOS ships as a bare binary zip.

Sync versions to manifest.json

After placing binaries under bin/<platform>-<arch>/ (either via npm run download:bins or manually), run the following to auto-detect and record their actual versions into bin/manifest.json:

npm run sync:bin-versions

The script scans each bin/<platform>-<arch>/ directory, executes yt-dlp --version and ffmpeg -version, parses the output, and writes the resolved version numbers back to bin/manifest.json (preserving other platforms' entries). This keeps the bundled-version record accurate without manual editing.

Project Structure

OmniFetch/
├── bin/
│   ├── <platform>-<arch>/
│   │   ├── yt-dlp(.exe)
│   │   └── ffmpeg(.exe)
│   └── manifest.json
├── electron/
│   ├── bin-resolver.ts
│   ├── downloader.ts
│   ├── binary-updater.ts
│   ├── main/
│   │   └── index.ts
│   ├── preload/
│   │   └── index.ts
├── python-script/
├── scripts/
│   └── download-bins.mjs
├── src/
│   ├── assets/
│   ├── components/
│   ├── stores/
│   ├── views/
│   ├── App.vue
│   └── main.ts
├── docs/
│   └── TechnicalSolution-v1.0.0(MVP).md
├── package.json
├── tsconfig.json
├── electron.vite.config.ts
└── README.md

Contributing

Contributions are welcome! For setup, runtime-binary (Git LFS) management, branching, and commit-message conventions, please read the full guide in CONTRIBUTING.md.

Supported Sites

OmniFetch relies on yt-dlp's extractors to support 1000+ websites. For the full list of supported sites, see SupportedSites.md (English) and SupportedSites.zh-CN.md (中文).

License

MIT License

---