Files
2025-07-26 11:44:31 +07:00

4.8 KiB

GitHub All Releases

TwitterXMediaBatchDownloader

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

https://github.com/user-attachments/assets/41231de2-e665-4d61-a4f4-62f424973af3

🍎 Solution (macOS): Open your terminal and run:

xattr -rd com.apple.quarantine ~/Downloads/TwitterXMediaBatchDownloader.app

https://github.com/user-attachments/assets/56a89c03-29ab-45f1-979f-4317f45191f7

✨ Features

  • Powered by gallery-dl, similar to yt-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

image

image

🐧 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.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.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

  1. Go to Twitter's website
  2. Log into your account
  3. Open the Developer Tools by pressing F12
  4. Navigate to the Application tab, then select Storage → Cookies
  5. Find and copy the auth_token value or use the browser extension X.com Auth Token Grabber
  6. Do not log out of your account, as a new auth_token will be generated by Twitter

X.com Auth Token Grabber

image

Developer Tools

image