Greasy Fork

Greasy Fork is available in English.

X.com Enhanced Gallery

Media viewer and download functionality for X.com

当前为 2025-12-11 提交的版本，查看 最新版本。

如何安装

您需要先安装一个扩展，例如 篡改猴、Greasemonkey 或 暴力猴，之后才能安装此脚本。

You will need to install an extension such as Tampermonkey to install this script.

您需要先安装一个扩展，例如 篡改猴 或 暴力猴，之后才能安装此脚本。

您需要先安装一个扩展，例如 篡改猴 或 Userscripts ，之后才能安装此脚本。

您需要先安装一款用户脚本管理器扩展，例如 Tampermonkey，才能安装此脚本。

您需要先安装用户脚本管理器扩展后才能安装此脚本。

（我已经安装了用户脚本管理器，让我安装！）

如何安装

您需要先安装一款用户样式管理器扩展，比如 Stylus，才能安装此样式。

您需要先安装一款用户样式管理器扩展，比如 Stylus，才能安装此样式。

您需要先安装一款用户样式管理器扩展，比如 Stylus，才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

（我已经安装了用户样式管理器，让我安装！）

作者
PiesP
评分
0 0 0
版本
1.1.2
创建于
2025-12-08
更新于
2025-12-11
大小
420.0 KB
许可证
MIT
适用于

🚀 X.com Enhanced Gallery

PC-only userscript to browse and download media from X.com in original quality.

Install Version License

X.com Enhanced Gallery is a lightweight, PC-only userscript that turns X.com (formerly Twitter) media into a fast, keyboard-friendly gallery with one-click original-quality downloads.

✨ What it does

  • Opens an isolated vertical gallery for all images and videos in a tweet
  • Downloads media in original quality (single file or bulk ZIP)
  • Provides keyboard and mouse navigation optimized for desktop use
  • Keeps the original X.com UI intact while adding an overlay gallery
  • Respects privacy by running entirely in your browser (no data collection)

Built with modern tooling:

  • UI: Solid.js 1.9
  • Language: TypeScript 5.9 (strict)
  • Runtime: Deno 2.x
  • Bundler: Vite 7 + vite-plugin-solid

📥 Installation

1️⃣ Install Userscript Manager

First, install a userscript manager extension in your browser.

Browser Recommended Extension
Chrome/Edge Tampermonkey
Firefox Tampermonkey
Safari Userscripts

2️⃣ Install Script

### 🔗 **[Click here to install](https://github.com/PiesP/xcom-enhanced-gallery/releases/latest/download/xcom-enhanced-gallery.user.js)** _Clicking will automatically open the installation screen in your userscript manager_ **📦 [View latest release](https://github.com/PiesP/xcom-enhanced-gallery/releases)**

3️⃣ Verify Installation

  1. Visit X.com: Go to https://x.com
  2. Click Image: Click an image or video in any tweet
  3. Check Gallery: Verify the enhanced vertical-scroll gallery appears

💡 Tip: Refresh the page after installation to use immediately.

🎮 Usage Guide

Basic Usage

  1. Open Gallery: Click an image or video in a tweet
  2. Navigate Media:
    • 🖱️ Mouse Wheel: Scroll up/down to navigate images in order
    • 🖱️ Arrow Buttons: Click navigation buttons on the left/right sides
    • ⌨️ Keyboard: Use arrow keys or keyboard shortcuts
  3. Play Video: Press spacebar or click play button on a video

Download Feature

Download Type Button Description
Single 📥 Download Save current image/video in original quality
Bulk 📦 Download All Download all media from tweet as ZIP file

Advanced Features

  • Image Zoom: Use mouse wheel to inspect image details
  • Auto Scroll: Long images automatically scroll to bottom
  • Optimized Loading: Current image loads first for faster navigation
  • Memory Management: Unused images auto-released for performance

🌐 Browser support

Desktop browsers only (no mobile/touch support):

Browser Version (minimum)
Chrome 117+
Edge 117+
Firefox 119+
Safari 17+

Note: Build target is esnext with ES2024 features. CSS features require: oklch (Chrome 111+), color-mix (Chrome 111+), container queries (Chrome 105+).

🔒 Security & privacy

  • All logic runs locally in your browser on X.com.
  • No analytics, telemetry, or third-party tracking.
  • No personal data or authentication tokens are collected or sent to external servers.
  • Network requests are limited to X.com/Twitter media endpoints and GitHub (for update checks).

For full details and vulnerability reporting, see the Security Policy.

📄 License and Open Source

This project is distributed under the MIT License.

Used Open Source Libraries

Library License Purpose
Solid.js MIT UI Framework
@heroicons/react MIT Icon Components

Full license texts are available in the LICENSES/ directory.

🤝 Contributing

Have ideas for project improvements?

Development Setup

git clone https://github.com/PiesP/xcom-enhanced-gallery.git
cd xcom-enhanced-gallery

# Build userscript bundle (includes quality checks)
deno task build

# Development build
deno task build:dev

# Quick build (skip quality checks)
deno task build:fast

# Individual quality checks
deno task check      # TypeScript
deno task lint       # Deno lint
deno task fmt:check  # Format check

Prerequisites: Deno 2.x is required. No npm install needed.

GitHub Actions runs a subset of these commands for continuous integration and security. See .github/workflows/ for details.

📞 Support and Feedback

**🌟 If you find this project useful, please give it a Star! 🌟** **Made with ❤️ and GitHub Copilot by [PiesP](https://github.com/PiesP)**