Social Media Downloader

Download public TikTok, Twitter/X, Instagram, Facebook, YouTube, Pinterest, Reddit, Threads, Snapchat, Twitch & Vimeo posts in their original quality — HD video, reels, Shorts, MP3 audio, photo carousels, and ffmpeg-rendered slideshow MP4s. Free, no login, no limits. Installs as an app.

🚀 Try it live →#

A free downloader for public posts on TikTok, Twitter/X, Instagram, Facebook, YouTube, Pinterest, Reddit, Threads, Snapchat, Twitch, and Vimeo. Paste a link and get an HD video, reel, or Short, MP3 audio, a photo carousel (individual images or a ZIP), or a fully rendered slideshow MP4 with the original soundtrack. No login and no install are required, and it runs in your browser. It reaches only what a logged-out visitor can already see: no private accounts, no paywalled or subscriber-only posts, no DRM.

It's also an installable app (PWA): add it to your home screen and share links straight from the TikTok, Instagram, or YouTube app, with no browser and no copy-paste.

Open source, with no popups, no redirects, no tracking, and a multi-source fallback chain so downloads keep working when any single provider goes down.

⭐ If this tool is useful to you, please star the repo. It helps others find it.

Built with Next.js 16, React 19, TypeScript, Tailwind CSS 4, and Motion by Mohamed Gado.

Why use it#

• 11 platforms, one paste box. TikTok, X, Instagram, Facebook, YouTube, Pinterest, Reddit, Threads, Snapchat, Twitch, and Vimeo, auto-detected from the URL.
• Any other link too. Paste a URL from anywhere else and the extractor still goes to work: it reads whatever media the page publishes (og:video, JSON-LD, player configs, download links), with a self-hosted yt-dlp resolver behind it for everything stricter. If the page serves its media to the public, this usually resolves it.
• Original quality, HD by default. The source file with no re-encode, a one-tap fallback to SD, and MP3 audio extraction wherever a stream resolves.
• No login, no API key, no daily limit. Nothing to sign up for and nothing installed unless you want the app.
• Private by design. No account is needed to download and nothing logs what you download. A Google sign-in exists so preferences can sync and so supporters' extras can be attached to an account. Your Recent list lives in your own browser.
• Resilient. A per-platform fallback chain retries other sources, so a single provider outage doesn't break your download.
• Installable PWA. Home-screen icon, app shortcuts, and native share-in from other apps.

Features#

Platforms#

TikTok

• HD video downloads at the source quality
• Extract the soundtrack as MP3 (re-served with audio/mpeg)
• Photo carousels (slideshows): preview every image, save individually or as a ZIP, keep the original background music
• Render a TikTok slideshow into a real MP4 video (ffmpeg) when the platform only ships images

Twitter / X

• Native video and GIF extraction from any twitter.com or x.com status URL
• Resolves t.co short links

Instagram

• Download reels and feed videos in their original quality
• Save single-photo posts and multi-image carousels — individually or as a ZIP
• Extract the audio track from a reel as MP3
• Works with instagram.com/p/…, /reel/…, /tv/… and share links — no login required
• Posts Instagram will not serve logged-out (private, age- or region-restricted) need IG_SESSIONID and the ig grant, and are the only Instagram links that fail

YouTube

• Download videos and Shorts in HD as MP4
• Extract the audio track as MP3
• Metadata (title, channel, thumbnail) pulled from YouTube's public oEmbed
• Works with youtube.com/watch?v=…, youtu.be/…, /shorts/…, and /embed/…

Facebook

• Download public videos, watch clips, and reels in HD
• Extract the audio track as MP3
• Resolves fb.watch/… short links and /share/… links automatically
• Works with facebook.com/…/videos/…, facebook.com/watch/?v=…, and facebook.com/reel/…

Pinterest

• Download Pin videos and images from pinterest.com/pin/… (and pin.it short links)

Reddit

• Download videos from reddit.com/r/…/comments/… posts and /s/… share links

Threads

• Download videos and images from threads.net / threads.com posts

Snapchat

• Download Spotlight clips and public story/profile media

Twitch

• Download clips and VODs from twitch.tv/…/clip/…, clips.twitch.tv/…, and twitch.tv/videos/…

Vimeo

• Download videos from vimeo.com/… and player.vimeo.com/… via a dedicated extractor

Any other site

• Paste any public link. The generic chain reads the page's own media (og:video, JSON-LD contentUrl, <video> sources, inline player configs, download anchors), verifies it serves a file rather than an error page, and offers it
• Sites that wall datacenter IPs are retried at an address they do answer (host-specific recipes read the embed/player page, which usually stays open when the watch page does not); a relay chain and an optional self-hosted yt-dlp resolver (deploy/resolver/) sit behind that, but note the free relays now refuse Worker-origin fetches, so on Cloudflare only a configured unlocker or resolver adds anything
• MP3 extraction works on this long tail too: when no audio-specific source answers, the resolved video stream is re-served through the audio route
• Where native binaries exist (self-hosting, local dev), a full yt-dlp extractor runs as the final fallback for pages whose players defeat tag-scraping — automatically absent on Cloudflare, where it short-circuits to null

App experience#

• Installable PWA — add to your home screen and launch it like a native app (standalone, own icon, splash).
• Share Target (Android) — installing registers the app as a share destination, so you can hit Share → Social Downloader from inside TikTok/Instagram/YouTube and land straight on a resolved download. No browser, no paste.
• App shortcuts / jump list — long-press the installed icon to jump straight to the TikTok, X, Instagram, YouTube, or Facebook downloader.
• iOS add-to-home hint — a nudge with the exact "Share → Add to Home Screen" steps, plus an iOS save hint on results.
• One-tap paste — reads the clipboard and resolves the link in a single tap.
• Batch paste (supporter) — drop a whole list of links (one per line or space-separated); every URL is pulled out, de-duplicated, and resolved in turn with live progress, across 1–3 parallel lanes.
• Collection import (supporter) — paste a YouTube playlist?list=…, a subreddit or Reddit profile, a Pinterest board, or a Vimeo channel once and it expands into batch rows, capped and de-duplicated, no re-pasting.
• Subtitle download (supporter) — every caption track on a resolved YouTube video saves as an SRT or WebVTT file, manual and auto-generated languages included; your language is remembered and syncs with your account.
• Thumbnail save — the cover image of any result saves as its own file.
• Recent export/import — the local history leaves the device as plain JSON and merges back in on another one (newest wins), staying local-first either way.
• Result re-pick — switch a resolved result between HD / SD / MP3 without re-pasting; your choice is remembered for the next link.
• Recent — a local, privacy-friendly history of what you've grabbed (branded per-platform tiles, "View all"), stored only in your browser and re-resolvable in one tap. Never stores the short-lived CDN/stream URL.

Quality of life#

• Inline video and image previews before downloading
• Multi-source fallback chain per platform (resilient against any single provider going down)
• Warm-instance resolve cache and direct tunnel downloads for faster, lighter fetches
• CORS-proxied media routes so downloads (and Instagram's hotlink-protected CDN) work cross-origin, with HTTP range support for seek/preview
• Inline URL validation, motion animations, responsive layout, low-power/touch-aware effects
• Eleven dedicated, SEO-tuned landing pages (one per platform)
• SEO: dynamic OpenGraph and Twitter card images, per-platform OG images, JSON-LD (WebSite, Person, SoftwareApplication, HowTo, FAQPage), hreflang, sitemap, IndexNow ping on build, and a PWA-tuned manifest
• No registration, no API keys, no daily limit

Supporting the project#

The site is free and stays free. It is paid for by a single sponsor card shown after a download. There are no popups, no redirects, no interstitials, and no tracking of what you download.

Nothing here is for sale. A subscription existed briefly and was withdrawn: two merchants of record refused to underwrite a third-party downloader, the second after every fixable item on their published review checklist had been fixed, so the rejection was about the product category. Supporting the project is a donation, arranged by email with booogado@gmail.com for now, and supporters get the extras switched on by hand. See the support page.

Tech stack#

Four of these are deliberate removals: Axios (~half the CPU of /api/download; see src/lib/httpClient.ts), Cheerio (too slow for the Worker CPU budget), lucide-react (three icons, hand-copied paths), and arctic (41% of the Worker bundle to reach one OAuth provider). Nothing in the deployed Worker comes from node_modules any more. Adding a dependency that the Worker imports is a CPU decision — run pnpm cf:startup.

How to use#

Download a video, reel, or Short

1. Copy a link from any supported platform.
2. Paste it into the input on the homepage (or tap Paste, or share it into the installed app).
3. Click Process URL. The app fetches metadata and a clean download link.
4. Optionally preview, then click Video or Extract Audio, or re-pick HD / SD / MP3.

Download several at once (batch)

1. Paste a list of links — one per line or space-separated.
2. Each URL is detected and resolved in turn with live progress.

Download a photo carousel

1. Paste the photo post URL (a TikTok slideshow or an Instagram carousel).
2. All images appear as a selectable grid.
3. Toggle the selections, then download them individually or as a ZIP.
4. For TikTok slideshows, click Video (slideshow) to render an MP4 of the images timed to the original music.

Install as an app

• Android/Chrome: tap Install on the in-app prompt (or the browser's install button). Afterwards, share links straight from other apps via Share → Social Downloader.
• iOS Safari: tap Share → Add to Home Screen, then launch from the icon and use one-tap Paste.

Supported URL formats

Project structure#

src/
├── app/
│   ├── page.tsx                 # Home page
│   ├── layout.tsx               # Root layout, metadata, JSON-LD injection
│   ├── <platform>-downloader/   # 11 per-platform landing pages (SEO)
│   ├── opengraph-image.tsx      # Dynamic 1200x630 OG image (edge runtime)
│   ├── twitter-image.tsx        # Twitter card image (delegates to OG)
│   ├── robots.ts                # robots.txt (incl. AI crawler policy)
│   ├── sitemap.ts               # sitemap.xml with hreflang + OG image
│   ├── globals.css
│   └── api/
│       ├── download/            # POST — resolves URL, returns video/image data
│       ├── video/               # GET  — proxies the video stream (video/mp4, range-aware)
│       ├── audio/               # GET  — proxies the same stream as audio/mpeg
│       ├── image/               # GET  — proxies a single image (CORS + CDN referer)
│       ├── images/              # POST — batch image fetcher with ZIP support
│       ├── slideshow/           # POST — renders an MP4 from images + audio (ffmpeg)
│       ├── thumb/               # GET  — proxied, cached thumbnails for Recent tiles
│       ├── tiktok/              # platform-specific resolve helper
│       └── youtube/             # platform-specific resolve helper
├── components/
│   ├── DownloaderApp.tsx        # Main client app (paste, batch, re-pick, Recent)
│   ├── InstallPrompt.tsx        # PWA install nudge (Android + iOS)
│   ├── PlatformLanding.tsx      # Shared landing-page template
│   ├── ImageLightbox.tsx, GlowCard.tsx, InteractiveBackground.tsx, …
│   └── icons.tsx
├── config/
│   └── site.ts                  # Single source of truth for site metadata
└── lib/
    ├── downloader.ts            # Core resolve logic + per-platform fallbacks
    ├── validator.ts             # URL validation and platform detection (11 platforms)
    ├── platforms.ts             # Per-platform copy, colors, landing config
    ├── proxyHeaders.ts          # Per-CDN Referer resolution shared by proxy routes
    ├── responseCache.ts         # Warm-instance resolve cache
    ├── history.ts               # Local, privacy-friendly Recent list
    ├── appReducer.ts            # Client state machine
    ├── audioExtractor.ts        # Audio extraction helpers
    ├── videoProcessor.ts        # Video processing utilities
    ├── ytdlp.ts                 # youtube-dl-exec fallback
    ├── structuredData.ts        # JSON-LD graph (Schema.org)
    ├── platformOgImage.tsx      # Per-platform OG image rendering
    ├── types.ts                 # Shared TypeScript types
    └── utils.ts

API reference#

POST /api/download#

Resolves a supported URL and returns download links and metadata.

{ "url": "https://www.instagram.com/reel/ABC123/" }

Video response:

{
  "success": true,
  "downloadUrl": "/api/video?url=...",
  "audioUrl": "/api/audio?url=...",
  "metadata": { "title": "…", "author": "…", "thumbnail": "…", "platform": "instagram" }
}

Photo carousel response:

{
  "success": true,
  "metadata": {
    "title": "…",
    "author": "…",
    "platform": "instagram",
    "images": ["…", "…"]
  }
}

GET /api/video?url=<encoded>#

Proxies a video file with Content-Type: video/mp4, adding the correct Referer for each CDN (via lib/proxyHeaders.ts) and honoring HTTP range requests so preview/seek works.

GET /api/audio?url=<encoded>#

Same proxy as /api/video but with Content-Type: audio/mpeg, so browsers treat it as an audio download.

GET /api/image?url=<encoded>#

Proxies a single image with the correct CDN Referer and permissive CORS headers. Instagram's CDN refuses cross-origin browser requests, so Instagram image previews and individual downloads are routed through this endpoint.

POST /api/images#

Fetches a list of image URLs. Returns either a JSON list of (proxied) downloadable URLs or a ZIP archive depending on asZip.

{ "imageUrls": ["https://…"], "title": "post-title", "asZip": true }

POST /api/slideshow#

Renders a real MP4 from a TikTok photo carousel using ffmpeg, timing each image and laying the original music on top.

{
  "imageUrls": ["https://…", "https://…"],
  "audioUrl": "https://…",
  "perImageSeconds": 3
}

Source fallback order#

The downloader tries providers in order and falls back automatically on failure.

• TikTok videos: Tikwm → Snaptik → SSSTik → direct scraping
• Twitter/X videos: vxTwitter → public Cobalt instances
• Instagram posts/reels: embed page (shortcode_media) → private media API (/api/v1/media/<id>/info/, session only) → public Cobalt instances. The embed resolves public posts, reels and carousels with no login; Cobalt covers what it misses. Anything Instagram will not serve logged-out — private, age- or region-restricted posts, and all stories — needs IG_SESSIONID and the ig grant on the requesting account. The web GraphQL extractor was removed on 2026-08-15: Instagram retired the persisted query and refuses the doc_id itself, identically for a logged-out and a logged-in caller.
• YouTube videos/Shorts: public Cobalt instances → public Piped instances → youtube-dl-exec (metadata enriched via YouTube oEmbed)
• Facebook videos/reels: video plugin page (/plugins/video.php) → direct page scrape (browser_native_*_url) → public Cobalt instances
• Vimeo: player config (/config) progressive renditions → embed-only when Vimeo ships no progressive rendition for that video (playable, not downloadable — the DASH/HLS manifests it ships instead need ffmpeg)
• Reddit: the embed view's packaged-media-json (pre-muxed MP4s; the raw v.redd.it renditions are video and audio in separate files) → Cobalt
• Threads: the post's /embed view, requested as a link crawler (a browser user agent gets the empty app shell) → Cobalt
• Twitch clips: the public GraphQL clip query, signed with the access token from the same response → Cobalt. VODs are HLS and are not supported.
• Pinterest: the widget API (/v3/pidgets/pins/info/) — video renditions, or the image as a one-image gallery → Cobalt
• Snapchat and anything else: best-effort via public Cobalt instances, then the generic page scrape

Each platform above tries its own endpoint before Cobalt because the one open public instance now answers api.fetch.fail/api.fetch.critical for most of them — its address is blocked by the origins. Cobalt stays in the chain: when it does answer, it tunnels the media, which streams from any IP.

Cobalt does the heavy lifting on serverless hosts (where yt-dlp isn't available). Set COBALT_API_URL to point the fallback chain at your own Cobalt instance for more reliable, higher-throughput extraction.

Deployment#

Production runs on Cloudflare Workers. pnpm cf:build exports the whole site to out/, wrangler uploads that as Workers Static Assets, and cloudflare/worker.js answers only /api/*. A page view matches an asset before the Worker is invoked, so it costs no CPU and nothing against the free plan's request cap.

A push to main deploys (.github/workflows/deploy-cloudflare.yml). The same run checks the bundle against the upload limit and the isolate startup budget (pnpm cf:startup), pings IndexNow with the deployed sitemap, and publishes a dated release listing what that deploy carried. The Cloudflare-side setup — D1, migrations, secrets, WAF — is in Getting started.

Is it still working?#

Extractors do not break when this repo changes. They break when a platform changes, on a day nobody deployed. So .github/workflows/platform-monitor.yml resolves one real public post per platform against production every morning and fails the run if one stops working — the same scripts/cf-smoke.mjs that runs after each deploy, with SMOKE_STRICT=1 so a platform's verdict counts. After a deploy those same probes are advisory: an upstream having a bad minute must never block shipping a fix.

Run the whole suite yourself against production with pnpm cf:smoke, or against any origin with pnpm cf:smoke https://example.com. Every check is a hard failure outside CI.

It also runs on any Node.js host that supports Next.js 16 (Node 20+, ideally 24 LTS): the App Router files under src/app/api/ wrap the same handlers the Worker calls, so nothing here is Cloudflare-only except the deploy itself. For the most reliable extraction in production, set COBALT_API_URL to a self-hosted Cobalt instance.

Legal#

This tool is intended for personal use with content you have the right to save. Respect the Terms of Service of each platform and do not download content without the creator's permission. Private accounts, stories, and age-restricted, members-only, or private videos are not supported.

Author#

Built and maintained by Mohamed Gado.

Issues and contributions#

Open a ticket on the Issues page with a description, the URL format you tried, and any error message. Pull requests welcome. If the tool saved you time, a ⭐ is welcome.

Before opening a pull request, run pnpm verify — typecheck, lint and tests in one command. CI does not run those separately: next build type-checks the whole project including test files, so a type error in a test fails the deploy rather than the test run.