How do I install the Twitter Media Downloader skill?

Run npx skillmds@latest add bossjones/twitter-media-downloader in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Twitter Media Downloader safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Twitter Media Downloader?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Twitter Media Downloader free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Twitter Media Downloader?

bossjones (@bossjones) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Twitter Media Downloader by bossjones

Name: Twitter Media Downloader
Author: bossjones

Twitter Media Downloader

Download images and videos from X/Twitter using gallery-dl. Use when user wants to download media from Twitter/X URLs including tweets, user profiles, timelines, or likes. Supports single tweets, entire user media galleries, bookmarks, and lists. Handles authentication via cookies for accessing protected content.

bossjones Updated Sep 17, 2026

File contents

Twitter/X Media Downloader

Download images and videos from X/Twitter using gallery-dl.

Quick Start

Run the download script with a Twitter/X URL:

uv run scripts/download.py "https://x.com/username" --output ./downloads

Supported URL Types

Single tweets: https://x.com/user/status/1234567890
User timelines: https://x.com/username
User media: https://x.com/username/media
User likes: https://x.com/username/likes (requires auth)
Bookmarks: https://x.com/i/bookmarks (requires auth)
Lists: https://x.com/i/lists/1234567890

Authentication

For protected content (likes, bookmarks, private accounts), provide cookies:

uv run scripts/download.py "URL" --cookies /path/to/cookies.txt

Or use browser cookies directly (recommended):

uv run scripts/download.py "URL" --browser firefox

Note: Using --browser firefox is recommended as it automatically extracts cookies from your browser session.

Common Options

Option	Description
`--output DIR`	Output directory (default: ./downloads)
`--cookies FILE`	Path to cookies.txt file
`--browser NAME`	Extract cookies from browser (firefox, chrome, etc.)
`--videos-only`	Download only videos
`--images-only`	Download only images
`--limit N`	Limit number of items to download
`--retweets`	Include retweets when downloading user timeline
`--replies`	Include replies when downloading user timeline
`--json`	Output structured JSON with downloaded file paths
`--debug`	Enable verbose debug output for troubleshooting

Examples

Download all media from a user:

uv run scripts/download.py "https://x.com/NASA" --output ./nasa_media

Download a single tweet's media:

uv run scripts/download.py "https://x.com/user/status/1234567890"

Download only videos from a user (limit 50):

uv run scripts/download.py "https://x.com/username" --videos-only --limit 50

Download bookmarks with Firefox cookies:

uv run scripts/download.py "https://x.com/i/bookmarks" --browser firefox

JSON Output Mode

For programmatic use (e.g., integration with other skills), use --json to get structured output:

uv run scripts/download.py "https://x.com/user/status/123" --json --videos-only

Output format:

{
  "files": ["/path/to/downloads/twitter_user_123_1.mp4"],
  "tweet_id": "123",
  "output_dir": "/path/to/downloads",
  "url": "https://x.com/user/status/123",
  "success": true,
  "error": null
}

This is used by the twitter-to-reel skill to automatically download videos before creating reels.

Output Structure

Files are saved with the following naming pattern:

{output_dir}/twitter_{username}_{tweet_id}_{num}.{ext}

Troubleshooting

Rate limiting: Add delays between requests with --sleep 2
Login required: Use --cookies or --browser for authentication
Missing videos: Ensure yt-dlp is installed for video downloads
Debug mode: Use --debug flag for verbose output to diagnose issues

---name: twitter-media-downloaderdescription: Download images and videos from X/Twitter using gallery-dl. Use when user wants to download media from Twitter/X URLs including tweets, user profiles, timelines, or likes. Supports single tweets, entire user media galleries, bookmarks, and lists. Handles authentication via cookies for accessing protected content.---# Twitter/X Media DownloaderDownload images and videos from X/Twitter using gallery-dl.## Quick StartRun the download script with a Twitter/X URL:```bashuv run scripts/download.py "https://x.com/username" --output ./downloads```## Supported URL Types- **Single tweets**: `https://x.com/user/status/1234567890`- **User timelines**: `https://x.com/username`- **User media**: `https://x.com/username/media`- **User likes**: `https://x.com/username/likes` (requires auth)- **Bookmarks**: `https://x.com/i/bookmarks` (requires auth)- **Lists**: `https://x.com/i/lists/1234567890`## AuthenticationFor protected content (likes, bookmarks, private accounts), provide cookies:```bashuv run scripts/download.py "URL" --cookies /path/to/cookies.txt```Or use browser cookies directly (recommended):```bashuv run scripts/download.py "URL" --browser firefox```> **Note**: Using `--browser firefox` is recommended as it automatically extracts cookies from your browser session.## Common Options| Option | Description ||--------|-------------|| `--output DIR` | Output directory (default: ./downloads) || `--cookies FILE` | Path to cookies.txt file || `--browser NAME` | Extract cookies from browser (firefox, chrome, etc.) || `--videos-only` | Download only videos || `--images-only` | Download only images || `--limit N` | Limit number of items to download || `--retweets` | Include retweets when downloading user timeline || `--replies` | Include replies when downloading user timeline || `--json` | Output structured JSON with downloaded file paths || `--debug` | Enable verbose debug output for troubleshooting |## ExamplesDownload all media from a user:```bashuv run scripts/download.py "https://x.com/NASA" --output ./nasa_media```Download a single tweet's media:```bashuv run scripts/download.py "https://x.com/user/status/1234567890"```Download only videos from a user (limit 50):```bashuv run scripts/download.py "https://x.com/username" --videos-only --limit 50```Download bookmarks with Firefox cookies:```bashuv run scripts/download.py "https://x.com/i/bookmarks" --browser firefox```## JSON Output ModeFor programmatic use (e.g., integration with other skills), use `--json` to get structured output:```bashuv run scripts/download.py "https://x.com/user/status/123" --json --videos-only```Output format:```json{ "files": ["/path/to/downloads/twitter_user_123_1.mp4"], "tweet_id": "123", "output_dir": "/path/to/downloads", "url": "https://x.com/user/status/123", "success": true, "error": null}```This is used by the `twitter-to-reel` skill to automatically download videos before creating reels.## Output StructureFiles are saved with the following naming pattern:```text{output_dir}/twitter_{username}_{tweet_id}_{num}.{ext}```## Troubleshooting- **Rate limiting**: Add delays between requests with `--sleep 2`- **Login required**: Use `--cookies` or `--browser` for authentication- **Missing videos**: Ensure yt-dlp is installed for video downloads- **Debug mode**: Use `--debug` flag for verbose output to diagnose issues

Frequently asked questions