https://github.com/koyasi777/x-advanced-search-userscript

Adds a floating advanced search modal to X.com (formerly Twitter). Multilingual UI, live query sync, and persistent modal position.
https://github.com/koyasi777/x-advanced-search-userscript

tampermonkey twitter userscript violentmonkey x

Last synced: 11 months ago
JSON representation

Adds a floating advanced search modal to X.com (formerly Twitter). Multilingual UI, live query sync, and persistent modal position.

• Host: GitHub
• URL: https://github.com/koyasi777/x-advanced-search-userscript
• Owner: koyasi777
• License: mit
• Created: 2025-07-12T14:36:12.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2025-07-12T15:03:27.000Z (11 months ago)
• Last Synced: 2025-07-12T16:24:07.993Z (11 months ago)
• Topics: tampermonkey, twitter, userscript, violentmonkey, x
• Language: JavaScript
• Homepage:
• Size: 36.1 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# X.com (formerly Twitter) Advanced Search Modal 🔍

## ✨ Overview

This user script adds an **Advanced Search Modal** to **X.com (formerly Twitter)**, allowing you to build complex search queries through a user-friendly interface.

- 📌 **Quick access** to advanced search from anywhere on the site  

- 🌐 **Multilingual UI** (Japanese, English, Korean, Chinese, and more)  

- 🔄 **Live synchronization** with X.com's native search box  

- 📍 **Remembers** the modal’s position and visibility state across sessions

---

## 🚀 Installation

1. Install a userscript manager for your browser:  

   - [Violentmonkey](https://violentmonkey.github.io/) or  

   - [Tampermonkey](https://www.tampermonkey.net/)

2. Click the link below to install the script:  

   👉 [Install this script](https://raw.githubusercontent.com/koyasi777/x-advanced-search-userscript/main/x-advanced-search.user.js)

---

## 🧩 Features

- Supports **advanced search conditions**:  

  keywords, exact phrases, hashtags, language filters, engagement metrics, date ranges, and more.

- Builds the search query dynamically and **injects it into the search box**

- Also **parses existing queries** and automatically fills the modal fields

- Draggable modal UI — **freely position it anywhere on screen**

- **State is persisted** using `localStorage`: modal visibility and position will be restored next time

---

## 🌍 Supported Languages

- Japanese (ja)

- English (en)

- Chinese (Simplified / Traditional)

- Korean (ko)

- French, Spanish, German, Portuguese, Russian *(in progress)*

---

## 🖼 Target Domain

- `https://x.com/*`  

> This includes all pages on **X.com**, formerly known as **Twitter**.

---

## 🔐 Stored Data

Only the following data is stored **locally** in your browser:

- Modal visibility state  

- Modal position (`left` and `top` CSS)

> ✅ No personal or search data is ever sent to external servers.

---

## 📄 License

MIT License — freely usable, modifiable, and redistributable.

---

## 🛠 Support

Please report bugs or feature requests via  

👉 [GitHub Issues](https://github.com/koyasi777/x-advanced-search-userscript/issues)

---

> Make searching on X.com (formerly Twitter) smarter, clearer, and more powerful — with just one click.