Gmail Snooze Reminder Badge

WHAT IT DOES

This script adds visible countdown badges to snoozed messages in Gmail, helping you track when snoozed emails will return to your inbox. When you snooze a message, Gmail hides it until a specified time. This script places a badge on the snoozed message showing how long until it returns (e.g., "2h 30m," "1d 4h," or "Now"). The badge updates in real-time. A sidebar section shows all currently snoozed messages grouped by return date, giving you a quick overview of what's coming back and when. Clicking the sidebar section filters your inbox to show only snoozed messages. The script works with Gmail's built-in snooze feature and updates dynamically as you snooze or unsnooze messages.

WHERE IT RUNS

The script runs on Gmail (mail.google.com). It works on the message list view and supports both desktop and mobile views.

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:

- The "Show snooze badges" toggle enables or disables the badges and sidebar section.

- Toggle "Show countdown timer" to show or hide the countdown on badges (when disabled, badges show "Snoozed" instead).

- Click "Refresh badges" to manually re-scan the message list.

- Click "Show snoozed messages" to filter your inbox to show only snoozed messages.

The badges appear on snoozed messages in the message list. The sidebar shows a summary of all snoozed messages.

TECHNICAL SECTION — REAL MECHANISM

The script detects Gmail message rows using the .zA selector and looks for snooze indicators by checking for "Snoozed" text in the message content, the presence of snooze-related CSS classes, or data-snooze attributes. It extracts the snooze return date by parsing text from elements like .bog, .bsU, .bkx, or .bkt, and by parsing date strings like "Today at 2:30 PM," "Tomorrow at 10:00 AM," or "Mon 10:00 AM." The parsed date is stored as a JavaScript Date object. Badges are rendered as span elements inserted next to the message subject, showing a countdown (e.g., "2h 30m") or "⏰ Snoozed" if countdown is disabled. A setInterval updates the badges every minute. The sidebar section is injected into the Gmail sidebar, showing a list of snoozed messages sorted by return date. A click handler on the sidebar section sets the search box to "is:snoozed" and submits the form to filter the inbox.

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. All settings save automatically via GM_setValue.

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. Gmail frequently updates its interface, which may affect the selectors used to find messages and snooze indicators. If badges stop appearing, please check for script updates. The script relies on Gmail's built-in snooze feature—it does not implement snoozing itself. The date parsing is based on common Gmail date formats and may not handle all variations perfectly. The script stores only your preferences via GM_setValue. No data is sent externally—all data is stored locally in your browser. The script never reads or writes password fields, hidden inputs, or file inputs. All DOM operations use safe methods (style properties, textContent, appendChild) and never use innerHTML.