mirror of
https://github.com/Alvin-Zilverstand/Twitter-X-Media-Batch-Downloader.git
synced 2026-11-21 13:53:13 +01:00
5.0 KiB
5.0 KiB
Twitter/X Media Batch Downloader is a GUI tool that allows users to download all media, including images and videos, in their original quality from Twitter/X accounts using
gallery-dl
📥 Download
- Windows: TwitterXMediaBatchDownloader
- Linux: TwitterXMediaBatchDownloader
- Mac: TwitterXMediaBatchDownloader
- If you're familiar with userscripts, please install it here
The downloaded application won't run❓
🐧 Solution (Ubuntu/Linux): Open your terminal and run:
chmod +x TwitterXMediaBatchDownloader
./TwitterXMediaBatchDownloader
https://github.com/user-attachments/assets/2048555f-393e-469d-a8bd-4275e33a81bd
🍎 Solution (macOS): Open your terminal and run:
xattr -rd com.apple.quarantine ~/Downloads/TwitterXMediaBatchDownloader.app
https://github.com/user-attachments/assets/f0fcd2ba-e1dd-4205-bda7-2b4154b982ee
✨ Features
- Powered by
gallery-dl, similar toyt-dlp - Bulk download: Download multiple items at once
- Media-type selection: All (Images + GIFs + Videos) or specific (Images / GIFs / Videos)
- MP4 → GIF conversion: Convert downloaded MP4 videos into GIF format
- Downloads at original quality
🖼️ Screenshots
🐧 Build Yourself (Ubuntu/Linux)
1. Install Required Packages
sudo apt install git python3-pip python3-venv
2. Clone the Repository
git clone https://github.com/afkarxyz/Twitter-X-Media-Batch-Downloader.git
cd Twitter-X-Media-Batch-Downloader
3. Create and Activate a Virtual Environment
python3 -m venv .venv
source .venv/bin/activate
4. Install Python Dependencies
pip install -r requirements.txt
pip install pyinstaller
5. Build the Executable
pyinstaller --onefile --windowed TwitterXMediaBatchDownloader.py
6. Run the Application
The compiled binary will be located in the dist/ folder:
./dist/TwitterXMediaBatchDownloader
🍎 Build Yourself (macOS)
1. Install Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. Install Git and Python
brew install git python
3. Go to Downloads and Clone the Repository
cd ~/Downloads
git clone https://github.com/afkarxyz/Twitter-X-Media-Batch-Downloader.git
cd Twitter-X-Media-Batch-Downloader
4. Create and Activate a Virtual Environment
python3 -m venv .venv
source .venv/bin/activate
5. Install Python Dependencies
pip install -r requirements.txt
pip install pyinstaller
6. Build the Application
pyinstaller --onefile --windowed --icon=Archived/icon.icns TwitterXMediaBatchDownloader.py
The .app bundle will be generated inside the dist/ folder.
🔑 How to Obtain Auth Token
Warning
- I suggest not using the main account to obtain the token.
- You can use https://temp-mail.io to register a Twitter account.
- Using an auth token or cookies has the potential to get the account suspended.
- If too many media files are fetched, it may trigger a rate limit, and the media retrieval will fail, try enabling Batch mode.
Video Tutorial
- Go to Twitter's website
- Log into your account
- Open the Developer Tools by pressing
F12 - Navigate to the Application tab, then select Storage → Cookies
- Find and copy the
auth_tokenvalue or use the browser extension X.com Auth Token Grabber - Do not log out of your account, as a new
auth_tokenwill be generated by Twitter
X.com Auth Token Grabber
Developer Tools