A fast, simple Windows desktop app for downloading MP4 video or MP3 audio from YouTube, TikTok and Instagram. Paste a link, pick a format, and you're done.
Built with React + Electron, powered by yt-dlp and ffmpeg.
- 🎬 MP4 video at best quality, or capped at 2160p / 1440p / 1080p / 720p / 480p / 360p
- 🎵 MP3 audio at best VBR, 320, 192 or 128 kbps, with embedded cover art and metadata
- 🔗 Paste to fetch: pasting a link instantly shows the title, thumbnail, uploader and duration
- 📊 Live progress with speed and ETA, plus several downloads at once and a cancel button
- 📁 Show in folder or Save as… when a download finishes
- 🍪 Browser cookies (optional) for private or login-only posts, which is mostly an Instagram issue
- 🔄 Update yt-dlp from the menu when a site changes and downloads stop working
- ⚙️ Settings page for light/dark theme, app updates, yt-dlp, download folder and default format/quality
- 📦 No setup needed: yt-dlp and ffmpeg ship inside the app
Get the latest build from the Releases page:
| File | What it is |
|---|---|
YouScrapper-Setup-x.y.z.msi |
Installs to C:\Program Files\YouScrapper and adds Start Menu and desktop shortcuts (needs admin) |
YouScrapper-Portable-x.y.z.exe |
Portable version that runs from anywhere without installing |
Windows SmartScreen may warn you because the app isn't code-signed. Click More info → Run anyway.
Files are saved to %USERPROFILE%\Downloads\YouScrapper by default. You can change this in Settings, or open the folder from File → Open downloads folder.
On startup, YouScrapper checks this repo's Releases page for a newer version. You can also check anytime from Settings or File → Check for app updates.
- MSI install: downloads the new
.msiand upgrades the copy in Program Files. Windows asks for admin permission. - Portable exe: downloads the new
.exe, replaces the old one in the same folder, and restarts.
yt-dlp is updated separately from Settings or File → Update yt-dlp. It runs from %APPDATA%\YouScrapper\bin, so updating it doesn't need admin rights.
Open Settings with the ⚙ button in the top-right corner, File → Settings…, or Ctrl+,.
| Section | Options |
|---|---|
| Appearance | Theme: System (follows Windows), Light or Dark. |
| App updates | Shows your version and release notes. You can check now, check on startup (on by default), install updates automatically without asking, include pre-releases, and un-skip a version you skipped. |
| yt-dlp | Shows the yt-dlp version. You can update now or update on startup. |
| Downloads | Download folder, default format (MP4/MP3), default video and audio quality, and browser cookies. |
| About | Version info and Reset all settings. |
App settings are saved in %APPDATA%\YouScrapper\settings.json.
- Copy a video link from YouTube, TikTok or Instagram.
- Paste it into YouScrapper with Ctrl+V or the Paste button. The video info loads automatically.
- Pick MP4 Video or MP3 Audio and a quality.
- Click Download.
| Problem | Fix |
|---|---|
| A site suddenly stops working | File → Update yt-dlp. Sites change often and yt-dlp updates fix most breakages. |
| Instagram says "login required" | Open Settings → Browser cookies and pick a browser you're logged into Instagram with. Firefox works best; recent Chrome/Edge versions encrypt cookies so tools can't read them. |
| "Sign in to confirm you're not a bot" on YouTube | Same fix: use browser cookies from Settings. |
Requirements: Node.js 20+ on Windows.
git clone <this repo>
cd YouScrapper
npm install # also downloads yt-dlp into ./bin
npm start # build the UI and open the desktop appIf npm blocks install scripts (npm 11+), approve the ones that download the binaries:
npm approve-scripts electron ffmpeg-static esbuild electron-winstaller
npm rebuild- Bump
versioninpackage.json, for example1.0.1. - Run
npm run release. It builds both files and uploads them to a newv1.0.1release. - Installed copies pick up the update the next time they start.
| Command | Description |
|---|---|
npm start |
Build the UI and launch the desktop app |
npm run dev |
Browser dev mode with hot reload (UI at http://localhost:5173) |
npm run dist |
Build the MSI installer and portable .exe into release/ |
npm run release |
Build, then publish both files as a GitHub release on doolecg/YouScrapper (needs gh auth login) |
npm run update-ytdlp |
Re-download the latest yt-dlp into ./bin |
┌──────────────── Electron window ────────────────┐
│ React UI (src/) │
│ │ fetch /api/* + Server-Sent Events │
│ ▼ │
│ Express server (server/index.js, 127.0.0.1) │
│ │ spawns │
│ ▼ │
│ yt-dlp.exe ──► ffmpeg (merge / MP3 convert) │
└─────────────────────────────────────────────────┘
electron/main.jsstarts the local API server on a random localhost port and opens the window.server/index.jswraps yt-dlp:/api/inforeads metadata,/api/downloadstarts a job, and/api/jobs/:id/eventsstreams progress.src/holds the React UI, built with Vite.electron/updater.jschecks GitHub Releases and installs new versions.scripts/ytdlp.jsdownloads the right yt-dlp binary for your platform.
The server only listens on 127.0.0.1, so nothing is exposed to your network.
YouScrapper/
├── build/ # App icon (icon.ico / icon.png)
├── electron/main.js # Desktop window, menu, packaging paths
├── electron/updater.js # Self-updater for the MSI install and portable exe
├── server/index.js # Local API around yt-dlp + ffmpeg
├── scripts/ytdlp.js # yt-dlp downloader/updater
├── scripts/release.js # Publishes a release with gh
├── src/ # React UI (App.jsx, styles.css)
├── index.html
├── vite.config.js
└── package.json # Scripts + electron-builder config
Copyright (c) 2026 doole. All rights reserved. No licence is granted to copy, change or share this code unless the author says so in writing.
This software is provided "as is", without warranty of any kind. To the extent permitted by law, the author is not liable for any loss or damage from using it, including lost data, lost work or damage to files or projects. Nothing here limits liability that cannot be limited by law, such as for death or personal injury caused by negligence.
Back up your work before using it. You use it at your own risk.
Not affiliated with or endorsed by YouTube, TikTok, Instagram or the makers of yt-dlp.
You are responsible for following the terms of service of any site you use this with, and for copyright in anything you download. Use it only for content you have the right to access.
YouScrapper is intended for downloading content you own, content that is in the public domain or licensed for reuse, or content you otherwise have permission to save.
The app contacts the sites whose links you give it and GitHub (to check for updates and to update yt-dlp). It does not send your downloads or settings to the author.