Skip to content

A browser extension that lets you download high-quality images from X/Twitter profiles in bulk.

Notifications You must be signed in to change notification settings

deyman12/xitter-scraper

 
 

Repository files navigation

Xitter-Scraper

Xitter-scraper banner

Chrome Web Store Version

Release

![Build]

A browser extension that lets you download high-quality images from X/Twitter profiles in bulk.


Open someone's X profile, Click the ⬇ button, and get all their images in a ZIP file (Full Quality)! Example Built with TypeScript and WXT.

✨ Features

  • 🚀 One-click bulk downloading
  • 📦 Automatic ZIP file creation
  • 🖼️ Downloads highest quality versions (4K when available)
  • 🎯 Clean UI integration with X's interface
  • 📊 Real-time progress tracking
  • 🔄 Auto-scrolling to find more images
  • 🎨 Preserves original image formats (JPG/PNG)

🛠️ Installation

Download from the chrome store OR:

  1. Clone this repo:
git clone https://github.com/bewinxed/xitter-scraper
cd x-image-downloader
  1. Install dependencies:
bun install
  1. Build the extension:
bun run build
  1. Load the extension:
  • Open Chrome/Edge
  • Go to chrome://extensions
  • Enable "Developer mode"
  • Click "Load unpacked"
  • Select the dist folder

🎮 Usage

  1. Navigate to any X/Twitter profile
  2. Find the download button next to the Follow/Following button
  3. Select how many images you want to download
  4. Watch the progress bar as images are collected and downloaded
  5. Get your images in a nicely organized ZIP file!

🧑‍💻 Development

Run the dev server:

bun dev
-- then, see no 4 at installation section!

Build for production:

pnpm build

🧰 Tech Stack

  • TypeScript
  • WXT (WebExtension Tooling)
  • JSZip

📝 Notes

  • Only downloads media from the current profile/timeline view
  • Downloads highest quality versions:
    • JPGs: Up to 4096x4096 resolution
    • PNGs: Original quality
  • The extension requires permissions for:
    • x.com & twitter.com (for UI integration)
    • pbs.twimg.com (for image downloads)

⚖️ License

Don't be a jerk. If you claim this is yours or wrap it without credit, I will come to your house and steal your socks.

🤝 Contributing

PRs and issues welcome! Some ideas for contributions:

  • Video support
  • Custom naming patterns
  • Download filters
  • Better error handling
  • Progress notifications
  • Different archive formats

⭐ Found this useful?

Give it a star, fork it, share it! And maybe follow the developer on GitHub.

About

A browser extension that lets you download high-quality images from X/Twitter profiles in bulk.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 99.6%
  • Svelte 0.4%