Skip to content

Repository files navigation

Savewave — Universal Media Downloader

Savewave Logo

Savewave is a minimal, high-performance, 100% stateless media resolver and universal downloader built with React, Express, yt-dlp, and Vercel.


⚡ Key Principles

  • Zero Database: No user accounts, database tables, or persistent server-side logs.
  • Stateless Resolution: Links are resolved on-the-fly to extract available stream URLs.
  • No Permanent Server Storage: Media stream requests pipe directly from source $\rightarrow$ client browser.
  • Automatic Quality Selection: Automatically selects the highest sensible video/audio stream without requiring complex preset menus.
  • Local Browser History: Download history is stored exclusively on your device (localStorage) and can be cleared with a single click.

💻 Tech Stack

  • Frontend: React 18, Tailwind CSS, Vanilla JS, HTML5 PWA Manifest
  • Backend / Engine: Node.js, Express, yt-dlp, Native Stream Piping
  • Testing & Tooling: Vitest, Babel Standalone, Vercel Web Analytics
  • Deployment & Hosting: Vercel Serverless Architecture

🌐 Supported Sources

Platform Supported Media
YouTube Videos, Shorts, Audio Extraction
Instagram Reels, Video Posts, Photos, Carousels, Stories
Facebook Public Videos, Reels, Post Media
Threads Public Post Videos & Images
X / Twitter Public Videos & Images
SoundCloud Public Audio Streams
Spotify Track Metadata + Smart Match Audio Resolver
Google Drive Public Shared Files
Dropbox Public Shared Files
Direct URLs MP4, MP3, PDF, Images, ZIP archives

🛠️ Quick Start

# Clone the repository
git clone https://github.com/kuberbassi/savewave.git
cd savewave

# Install dependencies
npm install

# Run automated Vitest test suite
npm test

# Launch local development server
npm start

Open http://localhost:3000 in your browser.


🚀 Progressive Web App (PWA) & Deployment

Savewave is PWA-ready for home-screen installation on iOS, Android, and Desktop.


📜 License

MIT License © 2026 Savewave / Kuber Bassi

About

Universal Media Downloader

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages