X.com Enhanced Gallery

Media viewer and download functionality for X.com

目前為 2025-12-24 提交的版本,檢視 最新版本

您需要先安裝使用者腳本管理器擴展,如 TampermonkeyGreasemonkeyViolentmonkey 之後才能安裝該腳本。

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

您需要先安裝使用者腳本管理器擴充功能,如 TampermonkeyViolentmonkey 後才能安裝該腳本。

您需要先安裝使用者腳本管理器擴充功能,如 TampermonkeyUserscripts 後才能安裝該腳本。

你需要先安裝一款使用者腳本管理器擴展,比如 Tampermonkey,才能安裝此腳本

您需要先安裝使用者腳本管理器擴充功能後才能安裝該腳本。

(我已經安裝了使用者腳本管理器,讓我安裝!)

你需要先安裝一款使用者樣式管理器擴展,比如 Stylus,才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展,比如 Stylus,才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展,比如 Stylus,才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展後才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展後才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展後才能安裝此樣式

(我已經安裝了使用者樣式管理器,讓我安裝!)

作者
PiesP
評價
0 0 0
版本
1.5.0
建立日期
2025-12-08
更新日期
2025-12-24
尺寸
296.9 KB
相容性
相容於 Firefox 相容於 Chrome 相容於 Safari 相容於 Edge
授權條款
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: Node.js 24 (via Volta)
  • Bundler: Vite 8 + vite-plugin-solid
  • Linter/Formatter: Biome 2.3

📥 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)
pnpm build

# Development build
pnpm build:dev

# Quick build (skip quality checks)
pnpm build:fast

# Individual quality checks
pnpm check      # TypeScript
pnpm lint       # Biome lint
pnpm fmt:check  # Biome format check

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)**