ljg-x-download

Download images and videos from X post URLs to ~/Downloads using yt-dlp.

Updated Jul 11, 2022
One-click install
npx skills add https://github.com/zhengfran/dotconfig --skill ljg-x-download-zhengfran
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ljg-x-download
Source: https://github.com/zhengfran/dotconfig/tree/main/tools/ai/agents/skills/ljg-x-download
Command: npx skills add https://github.com/zhengfran/dotconfig --skill ljg-x-download-zhengfran

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the hassle of manually saving photos or videos from X (Twitter) posts by automating media downloads from a shared status link directly to your local Downloads folder.

Core Features & Use Cases

  • Video-first downloading with yt-dlp: Downloads videos from a given X/Twitter status URL to ~/Downloads using a consistent filename pattern.
  • Fallback image extraction when video fails: Detects image-only posts by extracting thumbnail URLs (and upgrading to original images) when direct video download does not work.
  • Practical use cases: Use it when you receive an X/Twitter link and want to save the embedded media for offline viewing or archiving.

Quick Start

Ask the assistant to run ljg-x-download on this X status link you provide.

Frequently Asked Questions about ljg-x-download

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

FAQPage Schema
How do I download images and videos from an X or Twitter post link?

Downloading media from an X status link is handled by parsing the post URL and saving the embedded video or images directly to your local ~/Downloads directory in one step.

Can I save images from Twitter posts that do not contain video?

Yes, you can save images from Twitter posts without video. The Skill includes a fallback flow that detects image-only posts, parses JSON thumbnail URLs, and downloads the original media URLs to your Downloads folder.

Do I need yt-dlp to save X media to my local Downloads folder?

Yes, you need yt-dlp installed to enable video-first downloading from X status URLs. It handles retrieving the video content and saving it to your local ~/Downloads directory using a consistent filename pattern.

What happens when yt-dlp fails to download media from an x.com link?

When yt-dlp fails to download media from an x.com link, the Skill triggers a fallback flow that extracts JSON thumbnail URLs from the post, upgrades them to original image URLs, and downloads those files instead.

Does the Twitter media downloader support resolving short-links?

Yes, the Twitter media downloader supports short-link resolution. It can process user-shared short links from x.com or twitter.com, resolve them to the full status URL, and proceed with the media extraction workflow.