crazynomad/skills

twitter-downloader

Download videos from X (Twitter) posts using twmd — a fast, API-less downloader

First seen Mar 29, 2026

Installation

$ npx skills add crazynomad/skills --skill twitter-downloader

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from crazynomad/skills · top by installs.

npx skills add crazynomad/skills

Browse all from crazynomad/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 27
License LICENSE
Default branch master
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,615 B
  • docs SUMMARY.md 107 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 22 installs

SKILL.md

X / Twitter Video Downloader (twmd)

Download videos from individual X (Twitter) posts using twmd, an API-less Go-based downloader.

When to Use

Use this skill when users:

  • Provide an X/Twitter post URL and want to download its video
  • Mention "下载推文视频", "download Twitter video", "save X video", "下载 X 视频"
  • Share a link like https://x.com/username/status/123456 or https://twitter.com/username/status/123456

Usage

Basic Syntax

python scripts/download_tweet.py "TWEET_URL" [OPTIONS]

Common Scenarios

Download video from a tweet:

python scripts/download_tweet.py "https://x.com/username/status/1234567890"

Specify output directory:

python scripts/download_tweet.py "https://x.com/username/status/1234567890" -o ~/Downloads/twitter

Download in specific quality:

python scripts/download_tweet.py "https://x.com/username/status/1234567890" -q 720

Print video URL without downloading:

python scripts/download_tweet.py "https://x.com/username/status/1234567890" --url-only

Arguments

Argument Description Default
url X/Twitter post URL (required) -
-o, --output Output directory Current directory
-q, --quality Video quality: best, 1080, 720, 480 best
--url-only Print video direct URL without downloading False
--cookies Path to cookies file (for private/restricted content) None

Dependencies

pip install yt-dlp

No additional setup needed. yt-dlp handles public X/Twitter posts without cookies or API keys.

Output Structure

OutputDir/
└── <tweet_id>.mp4     # Downloaded video file

twmd names files by tweet ID. The script reports the file path after download.

Authentication (Optional)

For private accounts or login-gated content, export cookies from your browser:

  1. Install a browser extension like "Get cookies.txt LOCALLY"
  2. Log in to X, then export cookies for x.com as a Netscape-format .txt file
  3. Pass the file with --cookies:
python scripts/download_tweet.py "URL" --cookies ~/x-cookies.txt

Claude Integration

When user provides an X/Twitter post URL and wants to download its video:

  1. Check if yt-dlp is installed:

``bash yt-dlp --version ``

  1. Install if missing:

``bash pip install yt-dlp ``

  1. Execute download:

``bash python twitter-downloader/scripts/downloadtweet.py "TWEETURL" -o ./output ``

  1. Report the downloaded file to the user with its path and size.

Common Issues

Q: Download fails with "Unable to extract" error? A: Update yt-dlp first: pip install -U yt-dlp — X/Twitter frequently changes its API.

Q: The tweet has no video? A: Try --url-only to check what media yt-dlp can find. Image-only tweets will not yield a video URL.

Q: Need to download from a private account? A: Export browser cookies (see Authentication section above) and pass with --cookies.

Q: Why not just use youtube-downloader for Twitter URLs? A: You can — yt-dlp handles Twitter URLs too. This skill provides a Twitter-focused interface with cleaner prompts and no unneeded options (playlists, subtitles, etc.).

References