Skip to content

About

MP3/MP4 downloader for YouTube, TikTok and Instagram (Electron + React + yt-dlp)

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

12 Commits

Folders and files

Repository files navigation

YouScrapper

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.


Features

  • 🎬 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

Download & install

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.

Automatic updates

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 .msi and 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.

Settings

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.

Usage

  1. Copy a video link from YouTube, TikTok or Instagram.
  2. Paste it into YouScrapper with Ctrl+V or the Paste button. The video info loads automatically.
  3. Pick MP4 Video or MP3 Audio and a quality.
  4. Click Download.

Troubleshooting

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.

Building from source

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 app

If npm blocks install scripts (npm 11+), approve the ones that download the binaries:

npm approve-scripts electron ffmpeg-static esbuild electron-winstaller
npm rebuild

Publishing a new version

  1. Bump version in package.json, for example 1.0.1.
  2. Run npm run release. It builds both files and uploads them to a new v1.0.1 release.
  3. Installed copies pick up the update the next time they start.

Scripts

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

How it works

┌──────────────── 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.js starts the local API server on a random localhost port and opens the window.
  • server/index.js wraps yt-dlp: /api/info reads metadata, /api/download starts a job, and /api/jobs/:id/events streams progress.
  • src/ holds the React UI, built with Vite.
  • electron/updater.js checks GitHub Releases and installs new versions.
  • scripts/ytdlp.js downloads the right yt-dlp binary for your platform.

The server only listens on 127.0.0.1, so nothing is exposed to your network.

Project structure

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

Disclaimer

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.

About

MP3/MP4 downloader for YouTube, TikTok and Instagram (Electron + React + yt-dlp)

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages