X Alt Text Reminder Prompt

WHAT IT DOES

This script helps you make your tweets more accessible by reminding you to add descriptive alt text to images you attach. When you compose a tweet with one or more images, the script displays a non-blocking reminder prompt near the compose area. The prompt shows how many images are attached, how many have alt text, and how many are missing it. If any images lack alt text, the prompt highlights this with a warning icon and provides a direct "Add alt text" button that focuses the native alt text input field for each image. Images that already have alt text are clearly indicated, and when all images are properly described, the reminder shows a confirmation message. The reminder can be dismissed for the current compose session, but reappears when you start a new tweet with images.

WHERE IT RUNS

The script runs on all X domains: twitter.com, *.twitter.com, x.com, and *.x.com. It works in the main tweet compose interface, reply compose boxes, quote tweet dialogs, and the popup compose modal that appears when you click the tweet button from any page. It uses MutationObserver to detect when compose dialogs open and when images are added or removed, so the reminder updates in real time as you compose.

HOW TO USE

After installation, the settings panel appears on the left side of the screen with the gear emoji (⚙️). Open the panel to configure the script:

- Toggle "Show reminder prompt" on/off. When enabled, reminders appear whenever you attach images. When disabled, no reminders are shown.

- Toggle "Remind only when all images lack alt text" to control when the reminder appears. When enabled, the reminder only shows up if none of your attached images have alt text. When disabled, the reminder appears for any image attachment, showing the full status including which images are already described.

When the reminder appears, it displays the image count and alt text status. Click "Add alt text" to jump directly to the native alt text input field. Click the ✕ (dismiss) button to hide the reminder for the current compose session. The reminder reappears automatically when you start a new tweet or if you remove and re-add images.

TECHNICAL SECTION — REAL MECHANISM

The script identifies compose containers by looking for elements with data-testid attributes that X uses for its tweet textarea (tweetTextarea_0, tweetTextarea_1, tweetTextarea_2) and role="textbox" elements. Each container is tracked individually using a Set to avoid duplicate processing. To detect images, the script queries for img elements inside data-testid="attachments" and data-testid="tweetPhoto" containers, filtering out avatar images and UI decorations. Alt text status is determined by checking the value of data-testid="altTextInput" inputs and the presence of data-testid="altTextBadge" indicators that X displays when alt text is set. The reminder uses a custom DOM insertion strategy that finds the best insertion point near the attachments area or tweet button, falling back to appending to the container if no suitable insertion point exists. Each compose container gets its own MutationObserver that watches for changes to child lists, subtrees, and src/alt attributes, allowing the reminder to update dynamically when images are added, removed, or when alt text is entered.

THE PANEL

The settings panel is built with BotGentz's BGPanel component. It is draggable via its header, allowing you to reposition it anywhere on the screen. The panel snaps to the left edge by default but can be moved freely. Click the gear emoji to collapse the panel into a small bubble, and click the bubble to expand it again. The panel remembers its position per page session. Press the Escape key to quickly close or minimize the panel. The panel includes a status flash bar that provides visual feedback when settings are changed or actions are performed. The "Check all compose dialogs" button manually rescans for compose containers and refreshes all reminders, useful if you notice stale reminders.

PLEASE NOTE

This script requires the free BotGentz browser extension to run. It does not function as a standalone Chrome extension and does not use chrome.* APIs. X/Twitter frequently updates its DOM structure, which may break the script's selectors. If reminders stop appearing, please check for script updates. The script reads the page DOM to detect compose containers and image elements, and stores only boolean preference values via GM_setValue. No data is sent externally. The script never reads or writes password fields, hidden inputs, or file inputs. All DOM operations use safe methods (style properties, textContent, insertBefore, appendChild) to prevent XSS and injection vulnerabilities. Alt text is never read or stored by the script — it only checks for the presence of content in the native alt text input fields provided by X. The reminder is intentionally non-blocking and does not prevent posting tweets; it is a visual prompt only, and you remain fully in control of your posting decisions.