X 媒体下载器 (X Media Downloader)

One-click download of all images (original quality) and videos (highest quality) from X (Twitter) tweets.

Install this script ?

Ask a question, post a review, or report the script.

Author

VoidMuser

Daily installs

Total installs

111

Ratings

0 0 0

Version

1.2.0

Created

2025-11-22

Updated

2025-11-22

Size

14.5 KB

License

MIT

Applies to

X (Twitter) 媒体下载器 / X Media Downloader

[中文] | [English]

🇨🇳 中文说明

简介

这是一款功能强大的 Tampermonkey 脚本，旨在为您提供最便捷的 X (原 Twitter) 媒体下载体验。它直接集成在推文底部的操作栏中，让您能够一键下载高质量的视频和原图。

✨ 核心功能

🎬 视频下载：自动识别并下载最高画质（最高码率）的 MP4 视频，无需手动选择分辨率。
🖼️ 图片下载：强制获取原图 (Original Quality)，绝不压缩画质。
💎 原生体验：下载按钮完美融入 X 的操作栏（位于点赞、分享按钮旁），UI 风格与原生保持一致。
📂 智能命名：下载的文件名会自动包含推文的文本摘要和 ID，方便您后续整理和查找。
⚡ 批量处理：如果一条推文包含多张图片或视频，脚本会自动全部下载。

🚀 使用方法

安装浏览器扩展 Tampermonkey (Chrome / Edge / Firefox)。
点击安装本脚本。
打开或刷新 X (Twitter) 页面。
找到您想下载的推文，点击底部操作栏新增的 下载图标 (⬇️)。
- ⏳ 旋转中：正在准备下载...
- ✅ 变绿：下载成功！
- ❌ 变红：下载失败（请重试）。

🔧 常见问题

Q: 为什么点击没反应？
- A: 如果是刚加载的页面，请尝试滚动一下，让脚本捕获数据。如果是第一次使用，浏览器可能会询问是否允许脚本下载文件，请选择“总是允许”。
Q: 为什么需要 @connect 权限？
- A: 脚本需要直接从 Twitter 的媒体服务器（如 pbs.twimg.com）下载文件并保存到您的硬盘，这属于跨域操作，必须声明权限。

🇺🇸 English Description

Introduction

A powerful Tampermonkey script designed to provide the most convenient media downloading experience on X (formerly Twitter). It integrates directly into the tweet's action bar, allowing you to download high-quality videos and original images with a single click.

✨ Key Features

🎬 Video Download: Automatically detects and downloads the highest quality (highest bitrate) MP4 videos. No need to manually select resolutions.
🖼️ Image Download: Forces the retrieval of Original Quality images, ensuring no compression loss.
💎 Native UI: The download button is seamlessly integrated into X's action bar (next to Like/Share), matching the native style perfectly.
📂 Smart Naming: Saved filenames automatically include the tweet's text summary and ID, making organization easier.
⚡ Batch Processing: If a tweet contains multiple images or videos, the script downloads them all automatically.

🚀 How to Use

Install the Tampermonkey extension for your browser (Chrome / Edge / Firefox).
Install this script.
Open or refresh the X (Twitter) page.
Find the tweet you want to download and click the new Download Icon (⬇️) in the bottom action bar.
- ⏳ Spinning: Preparing download...
- ✅ Green: Download successful!
- ❌ Red: Download failed (please try again).

🔧 FAQ

Q: Why is nothing happening when I click?
- A: If the page just loaded, try scrolling a bit to let the script capture the data. If it's your first time using it, your browser/Tampermonkey might ask for permission to download files. Please select "Always Allow".
Q: Why does the script need @connect permissions?
- A: The script needs to download files directly from Twitter's media servers (like pbs.twimg.com) to your hard drive. This is a cross-origin operation that requires explicit permission in Tampermonkey.

扫码关注【爱吃馍】