A privacy-first Chrome and Firefox extension that makes YouTube player controls easier to see, click, and keep visible. Choose a clear control style, keep controls visible when needed, or customize the dark background strength.
Install from Chrome Web Store · Install from Microsoft Edge Add-ons · Changelog · Privacy Policy · Contributing
- Two control styles: Clear Controls and Strong Contrast
- Adjustable dark background behind player controls
- Optional always-visible player controls
- Bigger progress bar with a larger, easier-to-grab handle
- Any highlight color for the progress bar, icons and time display, with an optional fade into a second color
- A choice of progress-bar handle icons — Round, Star, Heart, Lightning and Music note
- Keep a video's own player colors when it ships its own progress bar theme
- Easier-to-read subtitles with a solid dark background and white or yellow text
- Larger mouse pointer over the video
- Keyboard shortcuts with on-player confirmation (HUD)
- A first-install welcome page showing the difference and how to adjust controls
- Master switch that removes all extension styling
- Settings synchronized through Chrome Sync
- No accounts, analytics, tracking, or external requests
- CSS-only visual changes without moving or cloning YouTube elements
- Open the Chrome Web Store listing.
- Select Add to Chrome.
- Confirm by selecting Add extension.
- Refresh an open YouTube tab after updating from an older version.
- Open the Microsoft Edge Add-ons listing.
- Select Get, then confirm the installation.
- Refresh any open YouTube tabs after installing or updating.
- Clone or download this repository.
- Run
npm run build:firefox. - Open
about:debugging#/runtime/this-firefoxin Firefox. - Select Load Temporary Add-on… and choose
dist/firefox/manifest.json.
- Download or clone this repository.
- Open
chrome://extensions/in Chrome. - Enable Developer mode.
- Select Load unpacked.
- Select the repository directory.
- Open a YouTube video.
- Select the extension icon in the Chrome toolbar.
- Keep the master switch enabled and choose a style:
- Clear Controls: Balanced visibility for everyday viewing.
- Strong Contrast: Darker controls and clearer buttons.
- Enable Keep Controls Visible if native auto-hide makes controls difficult to find.
- Expand More Visibility Options to set the background from 0% to 100%.
- Select Use Recommended Settings to restore the Clear Controls style at 70%.
Changes apply immediately and persist across browser sessions.
| Shortcut | Action |
|---|---|
Alt+Shift+Y |
Toggle all control enhancements on or off |
Alt+Shift+J |
Cycle between Clear Controls and Strong Contrast |
Alt+Shift+V |
Toggle Keep Controls Visible |
Each press shows a small confirmation on the player, and the style hint reflects the assigned shortcut. Shortcuts can be rebound at chrome://extensions/shortcuts.
The extension styles only existing YouTube player UI:
- top and bottom control bars;
- player buttons, icons, and timestamps;
- settings menus and panels;
- text tooltips and chapter titles.
It leaves seek-preview thumbnails untouched and only changes progress-bar thickness when the Bigger progress bar option is on. It does not move, clone, or replace YouTube controls and does not modify video content. The only element it adds is one small on-player status overlay (.ytoc-hud) that confirms keyboard commands.
Version 2.0 migrates settings to schema v3, preserving existing preferences and adding the new progress bar, highlight color, and pointer options with their defaults. Existing installations keep their prior values.
The release targets desktop Chrome and Chromium-based browsers on youtube.com, including embedded YouTube players. Firefox 128 and later use the generated Firefox package; Microsoft Edge uses the Chrome package unchanged. YouTube interface experiments may require selector updates.
Requires Node.js with the built-in node:test runner.
npm install
npm test # unit tests (settings model, locale catalogs)
npm run check # syntax checks + tests
npm run build # release ZIP in dist/
npm run build:firefox # Firefox package in dist/firefox/
npm run smoke # Playwright end-to-end test in Chromiumnpm run check validates JavaScript syntax and runs settings migration and locale tests. npm run smoke loads the unpacked extension in Chromium and verifies styling end to end — it needs xvfb-run -a on machines without a display.
- Manifest V3
storageandactiveTabpermissions- host access restricted to
https://www.youtube.com/* - versioned settings schema stored in
chrome.storage.sync - namespaced
data-ytoc-*attributes and--ytoc-*CSS properties - background script handles only keyboard commands and update bookkeeping — no remote code or external network calls
The extension runs only on YouTube, stores only its settings through Chrome Sync, and does not collect browsing or viewing data. See the Privacy Policy for details.
Report issues at GitHub Issues. Include the Chrome version, YouTube URL, selected profile, screenshot, and relevant console errors.
MIT. See LICENSE.