Max Subtitle Style Customizer

WHAT IT DOES

Max Subtitle Style Customizer detects subtitle and closed caption elements on the Max (formerly HBO Max) video player and applies custom styles according to your preferences. Adjust font size, text color, background color, font family, subtitle position (top or bottom), and opacity for both text and background. The tool injects CSS styles directly into the page and monitors for changes, ensuring your custom styles persist throughout your viewing session. Whether you need larger text for readability, high-contrast colors for visibility, or a cleaner look, this tool gives you full control over the subtitle appearance.

WHERE IT RUNS

This extension works exclusively on Max at www.max.com. It functions on the video player during content playback, including movies, TV shows, and any content with subtitle or closed caption support. The tool works across all Max regions and adapts to the player's dynamic interface, including shadow DOM elements.

HOW TO USE

Install the extension and start playing any content on Max with subtitles enabled. The tool automatically detects subtitle elements and applies your custom styles. Use the overlay panel to customize your subtitle appearance: adjust font size in pixels (8-48), set text color using hex values, set background color using hex values, choose from multiple font families (Sans-serif, Serif, Monospace, Arial, Georgia, Verdana, Tahoma), select subtitle position (Bottom or Top), and adjust text opacity and background opacity (0-1). Click "Apply Styles" to manually reapply styles after changes, or "Reset to Defaults" to restore the original styles. The status area shows the customizer is active.

TECHNICAL SECTION — SUBTITLE DETECTION AND STYLE INJECTION

The extension uses a multi-strategy detection engine to find subtitle elements on Max's video player. It queries common subtitle selectors including .subtitles, .subtitle, .caption, .captions, and pattern-matching class names. It also scans video elements for text tracks and attempts to locate rendered cue elements. For elements inside shadow DOM (used by some video players), the tool traverses shadow roots to find subtitle containers. Styles are applied directly to each subtitle element and also injected as a global style tag for broader coverage. A MutationObserver monitors the DOM for new subtitle elements, automatically applying styles when they appear. All style preferences are persisted using GM_setValue and restored on page load.

THE PANEL — DRAG / PER-SITE POSITION / SNAP / COLLAPSE / RESIZE / ESCAPE

The overlay panel is fully interactive and designed for seamless multitasking. Drag it anywhere on the screen using the handle at the top of the panel; the position is saved per site so it stays where you left it across sessions. The panel includes a snap-to-edge feature that gently anchors the overlay to the nearest screen edge when released. Click the collapse button to minimize the panel to a compact pill showing the current subtitle style status; expand it again with a single click. Resize the panel vertically by dragging the bottom-right corner to view more controls. Press the Escape key at any time to instantly close the overlay; it reappears on the next page navigation or refresh.

PLEASE NOTE

This extension requires the free BotGentz companion extension to function, as it provides the underlying content script injection and cross-origin communication framework. No personal data, browsing history, or viewing activity is stored, transmitted, or shared. Settings are stored locally in your browser using GM_setValue and are never sent to any external server. The extension does not access or store login credentials, financial data, or personally identifiable information. The tool modifies the appearance of subtitle elements on the page and does not access Max's API or any private data. Max may update its video player interface; the extension includes multiple detection strategies to maintain compatibility, but major redesigns may temporarily affect subtitle detection. The tool only affects subtitle display and does not modify the video player's functionality or content.