Skip to content

About

Chrome extension that adds adjustable black backgrounds to YouTube's transparent player controls

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

117 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

YouTube Player Accessibility

Version Chrome Web Store Microsoft Edge Add-ons License I Ship This

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

Features

  • 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

Installation

Chrome Web Store

  1. Open the Chrome Web Store listing.
  2. Select Add to Chrome.
  3. Confirm by selecting Add extension.
  4. Refresh an open YouTube tab after updating from an older version.

Microsoft Edge Add-ons

  1. Open the Microsoft Edge Add-ons listing.
  2. Select Get, then confirm the installation.
  3. Refresh any open YouTube tabs after installing or updating.

Firefox (temporary installation)

  1. Clone or download this repository.
  2. Run npm run build:firefox.
  3. Open about:debugging#/runtime/this-firefox in Firefox.
  4. Select Load Temporary Add-on… and choose dist/firefox/manifest.json.

Chrome: Install from Source

  1. Download or clone this repository.
  2. Open chrome://extensions/ in Chrome.
  3. Enable Developer mode.
  4. Select Load unpacked.
  5. Select the repository directory.

Usage

  1. Open a YouTube video.
  2. Select the extension icon in the Chrome toolbar.
  3. Keep the master switch enabled and choose a style:
    • Clear Controls: Balanced visibility for everyday viewing.
    • Strong Contrast: Darker controls and clearer buttons.
  4. Enable Keep Controls Visible if native auto-hide makes controls difficult to find.
  5. Expand More Visibility Options to set the background from 0% to 100%.
  6. Select Use Recommended Settings to restore the Clear Controls style at 70%.

Changes apply immediately and persist across browser sessions.

Keyboard Shortcuts

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.

Scope

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.

Compatibility and Migration

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.

Development

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 Chromium

npm 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.

Technical Details

  • Manifest V3
  • storage and activeTab permissions
  • 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

Privacy

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.

Support

Report issues at GitHub Issues. Include the Chrome version, YouTube URL, selected profile, screenshot, and relevant console errors.

License

MIT. See LICENSE.

About

Chrome extension that adds adjustable black backgrounds to YouTube's transparent player controls

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages