Skip to content

gormanity/ytm-enhancer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

227 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

YTM Enhancer logo

YTM Enhancer

CI Latest release License: MIT Browsers: Chrome, Edge, Firefox Privacy-first: no analytics

YTM Enhancer supercharges YouTube Music to make it the best browser-based media player.

It upgrades YouTube Music in your browser with smarter controls, automation, and visual enhancements, without forcing you into a replacement app or wrapper.

If you love the ubiquity of YouTube Music's service but want a more fully-featured listening experience, this extension is for you.

Why YTM Enhancer

  • Adds missing quality-of-life features from other media players
  • Improves daily listening flow with fewer clicks and better controls
  • Keep YouTube Music in your browser - without compromises
  • Manage multiple YouTube Music tabs, effortlessly switching and controlling playback
  • Private by design: no analytics, no tracking, and no external backend services.
  • Supports all major browsers: Chrome, Edge, and Firefox

Current Modules

Feature Why You Want It
Quick Settings Control playback, switch tabs, and manage now playing from one panel.
Auto Play Open YouTube Music and have playback start automatically when you are ready.
Auto Skip Disliked Automatically skip disliked tracks so your playlists stay great start to finish.
Audio Visualizer Add responsive visualizer overlays and tune the look to match your setup.
Hotkeys Control playback from any app or jump back to YouTube Music instantly.
Mini Player Keep controls and now playing visible in a compact PiP view while multitasking.
Notifications Get desktop updates on track changes and playback resumption with custom detail.
Sleep Timer Stop playback by duration or clock time so your queue does not run all night.

Installation

YTM Enhancer currently installs from source (manual load). Browser web store listings are coming soon.

Prerequisites

  • Node.js 20+
  • pnpm 10+

Chrome / Chromium (Chrome, Brave)

Show Chrome / Chromium installation steps
  1. Clone this repository.
  2. Install dependencies: pnpm install
  3. Build Chrome output: pnpm run build:chrome
  4. Open chrome://extensions.
  5. Enable Developer mode.
  6. Click "Load unpacked".
  7. Select dist/chrome.

Edge

Show Edge installation steps
  1. Clone this repository.
  2. Install dependencies: pnpm install
  3. Build Edge output: pnpm run build:edge
  4. Open edge://extensions.
  5. Enable Developer mode.
  6. Click "Load unpacked".
  7. Select dist/edge.

Firefox

Show Firefox installation steps
  1. Clone this repository.
  2. Install dependencies: pnpm install
  3. Build Firefox output: pnpm run build:firefox
  4. Open about:debugging#/runtime/this-firefox.
  5. Click "Load Temporary Add-on".
  6. Select any file inside dist/firefox (typically manifest.json).

Privacy

YTM Enhancer is private by design. It has no analytics, no tracking, and no external backend services.

Why Each Permission Is Required

Permission Why It Is Needed
activeTab Lets the popup and hotkeys interact with your currently active YouTube Music tab when you trigger extension actions.
alarms Powers time-based automation, including Sleep Timer and background scheduling logic.
notifications Shows native desktop notifications for track changes and related playback events.
scripting Injects and runs extension scripts on YouTube Music to provide feature behavior in-page.
storage Saves your module settings locally in the browser so preferences persist.
https://music.youtube.com/* Limits extension functionality to YouTube Music pages where features are intended to run.
https://lh3.googleusercontent.com/* Loads album art assets used for now-playing and notification UI.

See PRIVACY.md for full details on data handling, permissions, and privacy guarantees.

Development

YTM Enhancer is actively developed and already includes a broad module set.

The architecture is designed so new features can be added as modules without rewriting existing modules.

Contributing

Contributions are encouraged.

If you want to help:

  • Open an issue for bugs, UX problems, or feature requests.
  • Open a PR for fixes and improvements.

See CONTRIBUTING.md for details on the module contribution workflow.

Development Builds

  • Chrome watch build: pnpm run dev:chrome
  • Edge watch build: pnpm run dev:edge
  • Firefox watch build: pnpm run dev:firefox

License

MIT. See LICENSE.

About

A modular, privacy-first extension for enhancing the YouTube Music web app.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors