Awesome Open Source
Awesome Open Source

YouTube Music

GitHub release GitHub license XO code style Build status Known Vulnerabilities GitHub All Releases AUR


Electron wrapper around YouTube Music featuring:

  • Native look & feel, aims at keeping the original interface
  • Framework for custom plugins: change YouTube Music to your needs (style, content, features), enable/disable plugins in one click


You can check out the latest release to quickly find the latest version.

Arch Linux

Install the youtube-music-bin package from the AUR. For AUR installation instructions, take a look at this wiki page.

Available plugins:

  • Ad Blocker: block all ads and tracking out of the box
  • Downloader: download to MP3 directly from the interface (youtube-dl)
  • No Google Login: remove Google login buttons and links from the interface
  • Shortcuts: use your usual shortcuts (media keys, Ctrl/CMD + F…) to control YouTube Music
  • Navigation: next/back navigation arrows directly integrated in the interface, like in your favorite browser
  • Auto confirm when paused: when the "Continue Watching?" modal appears, automatically click "Yes"
  • Hide video player: no video in the interface when playing music
  • Notifications: display a notification when a song starts playing
  • Touchbar: custom TouchBar layout for macOS


git clone
cd youtube-music
yarn start

Build your own plugins

Using plugins, you can:

  • manipulate the app - the BrowserWindow from electron is passed to the plugin handler
  • change the front by manipulating the HTML/CSS

Creating a plugin

Create a folder in plugins/YOUR-PLUGIN-NAME:

  • if you need to manipulate the BrowserWindow, create a file back.js with the following template:
module.exports = win => {
	// win is the BrowserWindow object
  • if you need to change the front, create a file front.js with the following template:
module.exports = () => {
	// This function will be called as a preload script
	// So you can use front features like `document.querySelector`

Common use cases

  • injecting custom CSS: create a style.css file in the same folder then:
const path = require("path");
const { injectCSS } = require("../utils");

// back.js
module.exports = win => {
	injectCSS(win.webContents, path.join(__dirname, "style.css"));
  • changing the HTML:
// front.js
module.exports = () => {
	// Remove the login button
  • communicating between the front and back: can be done using the ipcMain module from electron. See utils.js file and example in navigation plugin.


yarn build

Builds the app for macOS, Linux, and Windows, using electron-builder.


yarn test

Uses Spectron to test the app.


MIT © th-ch

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
javascript (70,997
linux (2,576
windows (1,517
node (1,021
electron (977
music (610
youtube (395
mac (282
music-player (183
macosx (115
desktop-app (101
adblock (92
youtube-dl (83
youtube-downloader (34
adblocker (30
youtube-player (29
blocker (22