ProtonMail Web Label Color Customizer

WHAT IT DOES

ProtonMail Web Label Color Customizer scans the current page for ProtonMail web interface labels, extracting label names, associated colors, and label groups from the ProtonMail sidebar and label management UI. The floating panel displays a color picker interface for each detected label, allowing users to customize label colors with visual previews. Predefined color palettes, custom color input, and color contrast checking for accessibility make it easy to find the perfect color. Save color preferences per label, reset to defaults, and export label color configurations as JSON. Color changes are applied in real-time to the ProtonMail interface.

WHERE IT RUNS

Works on ProtonMail web interface pages, including the inbox, label management, and sidebar views. The script detects labels using ProtonMail-specific selectors and extracts label metadata. It works best on ProtonMail web interface label management pages.

HOW TO USE

The panel displays all detected labels with their current colors. Each label shows a color preview, a color picker input, and a row of preset color dots for quick selection. Click the color picker to select a custom color, or click any preset dot to apply a predefined color. Changes are saved automatically and applied in real-time. Use "Apply All" to ensure all saved colors are applied to the interface. Export your color configuration as JSON for backup or sharing. Reset individual labels to their default colors using the reset button (↺).

MECHANISM — LABEL EXTRACTION WITH REAL-TIME COLOR APPLICATION

The script detects ProtonMail labels by finding label containers using selectors (.pm-label, .label-item). From each container, it extracts the label name and current color from the element's computed style or color dot elements. Saved colors are stored locally with the label name as the key. When a color is selected, the script applies it to the label element's background and text color, ensuring proper contrast using the YIQ formula to determine whether to use black or white text for readability. The color application also targets nested elements like label text and color dots. All extraction and color manipulation runs client-side with no network calls.

THE PANEL

The floating panel is fully draggable and remembers its position per domain. Click the minimize button to collapse it to a small bubble, or press Escape to hide it. The panel automatically adjusts to different screen sizes and can be resized to show more content. All settings, including color palettes and saved colors, are saved per domain. The panel integrates smoothly with any page layout using the BGPanel framework, maintaining clean separation from page content.

PLEASE NOTE

This script requires the free BotGentz extension to run. It does not send any data to external servers; all color preferences and settings remain entirely local to your browser using GM_setValue. The script never reads password fields, hidden inputs, or file inputs. It stores only label names and associated color hex codes from publicly visible ProtonMail page content. Label detection depends on the page structure; if labels are not detected, use the "Scan Labels" button to refresh extraction. The script works on ProtonMail pages and detects pages by hostname. Color changes are applied to the ProtonMail interface as CSS style overrides and persist until the page is refreshed or the script is disabled. Data persists across browser sessions and is isolated per browser profile.