mirror of
https://github.com/Alvin-Zilverstand/Twitter-X-Media-Batch-Downloader.git
synced 2026-11-21 13:53:13 +01:00
4.7 KiB
4.7 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
The downloaded application won't run❓
🐧 Solution (Ubuntu/Linux): Open your terminal and run:
chmod +x TwitterXMediaBatchDownloader_Linux
https://github.com/user-attachments/assets/cc7400ec-76dd-4519-848d-71a834b7ec95
🍎 Solution (macOS): Open your terminal and run:
xattr -rd com.apple.quarantine ~/Downloads/TwitterXMediaBatchDownloader_Mac.app
https://github.com/user-attachments/assets/4b13c0b9-cf3a-48ce-ac35-a19007189ac8
✨ Features
- Powered by
gallery-dl, similar toyt-dlp - Bulk download: Download multiple accounts 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 Application
pyinstaller --onefile --windowed TwitterXMediaBatchDownloader_Linux.py
The compiled binary will be located in the dist/ folder.
🍎 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_Mac.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