https://github.com/bewinxed/xitter-scraper
A browser extension that lets you download high-quality images from X/Twitter profiles in bulk.
https://github.com/bewinxed/xitter-scraper
Last synced: 3 days ago
JSON representation
A browser extension that lets you download high-quality images from X/Twitter profiles in bulk.
- Host: GitHub
- URL: https://github.com/bewinxed/xitter-scraper
- Owner: Bewinxed
- Created: 2025-01-25T15:37:40.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-03-15T16:08:30.000Z (over 1 year ago)
- Last Synced: 2025-10-30T13:45:31.511Z (8 months ago)
- Language: TypeScript
- Size: 1.58 MB
- Stars: 10
- Watchers: 1
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Xitter-Scraper
**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)!
Built with TypeScript and [WXT](https://wxt.dev).
## ✨ 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:
```bash
git clone https://github.com/bewinxed/xitter-scraper
cd x-image-downloader
```
2. Install dependencies:
```bash
bun install
```
3. Build the extension:
```bash
bun run build
```
4. 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:
```bash
pnpm dev
```
Build for production:
```bash
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](https://github.com/bewinxed).