x-downloader

Automate Twitter/X media downloads using gallery-dl with cookie authentication.

1|Updated May 30, 2026
One-click install
npx skills add https://github.com/oksummer/x-downloader --skill x-downloader
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-downloader
Source: https://github.com/oksummer/x-downloader/tree/main
Command: npx skills add https://github.com/oksummer/x-downloader --skill x-downloader

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires , and includes scripts (resource) and references (resource) components.

What problem does it solve?

Automates the process of downloading media (images, videos, GIFs, and audio) from Twitter/X by providing a scripted workflow that handles authentication via cookies, proxy configuration, and flexible download options, saving time and effort for content collection and archival tasks.

Core Features & Use Cases

  • Single Tweet or User Timeline: Download media from a specific tweet URL or an entire user's media timeline.
  • Media Types & Quality: Supports images, videos, GIFs, and audio with configurable video quality.
  • Proxy & Cookie Authentication: Works with HTTP/HTTPS/SOCKS4/SOCKS5 proxies and Netscape-format cookies for authenticated access.
  • Date Filtering & Post Limiting: Filter posts by date range and limit the number of downloaded posts; optionally include tweet text with media.

Quick Start

Provide the Twitter username or tweet URL and Netscape cookies, then run the script to begin downloading media with optional proxy settings.

Frequently Asked Questions about x-downloader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download Twitter media with cookies using gallery-dl?

Download Twitter media with cookies by providing your username or tweet URL alongside Netscape-format cookies to authenticate gallery-dl, which then fetches images, videos, GIFs, and audio from the target timeline or post.

Can I download videos from a Twitter user timeline with a proxy?

Yes, you can download videos from a user timeline through a proxy. The script supports HTTP, HTTPS, SOCKS4, and SOCKS5 proxies to route your gallery-dl traffic while fetching media via cookie-based authentication.

Do I need pysocks to download Twitter images through a SOCKS5 proxy?

Yes, pysocks is required for proxy support. You must install both gallery-dl and pysocks to successfully route your Twitter media downloads through SOCKS4 or SOCKS5 proxy connections.

How do I filter Twitter media downloads by date and post limit?

Filter Twitter media downloads by specifying a date range and post limit before execution. The script applies these parameters to gallery-dl, restricting the fetched timeline posts and optionally including the tweet text alongside media files.

What is the best way to archive authenticated Twitter media automatically?

Archiving authenticated Twitter media is best handled by automating gallery-dl with Netscape-format cookies. This approach fetches images, videos, and audio while managing retweet control and date filtering for comprehensive collection.

Does gallery-dl support raw cookie text for downloading Twitter videos?

Yes, gallery-dl supports raw cookie text for downloading Twitter videos. The script accepts both Netscape-format cookie files and raw cookie text to authenticate access to restricted media timelines.