X.com Enhanced Gallery

PiesP
2025-12-08T02:39:03Z

Media viewer and download functionality for X.com

🚀 X.com Enhanced Gallery

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

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.

✨ Features

Vertical gallery for all images and videos in a tweet

Original quality downloads (single file or bulk ZIP)

Keyboard and mouse navigation optimized for desktop

Privacy-focused - runs entirely in your browser, no data collection

Non-intrusive - keeps the original X.com UI intact

📥 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 | Minimum Version
Chrome | 117+
Edge | 117+
Firefox | 119+
Safari | 17+

🔒 Security & Privacy

Runs entirely in your browser - no external data collection

No analytics, telemetry, or third-party tracking

Network requests limited to X.com media and GitHub (update checks only)

For security reports, see the Security Policy.

📄 License

This project is distributed under the MIT License.

🤝 Contributing

Contributions are welcome! Please check the repository for development guidelines and contribution instructions.

📞 Support and Feedback

🐛 Report bugs: GitHub Issues

💡 Feature requests & questions: GitHub Discussions

📝 Changelog: CHANGELOG.md

🔒 Security reports: Please follow the Security Policy.

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