Repolode
Submit
pear-devs

pear-devs/pear-desktop

An unofficial, Electron-based desktop app for YouTube Music with a plugin system for custom CSS and behavior changes.

Open-source alternative to:YouTube Music

View on GitHub
Stars
33,818
Forks
2,019
Open issues
733
Last commit
12 hours ago

What is it?

Pear Desktop wraps the YouTube Music web player in a native desktop application for Windows, macOS, and Linux. It is an independent volunteer project and is not affiliated with Google or YouTube.

Beyond the standard player, the app ships with a plugin system. Plugins can modify the Electron BrowserWindow in the main process, inject CSS or HTML into the player page, and communicate between the front and back through IPC. Users can load custom CSS themes from the Options menu to change the app's appearance.

The project is written in TypeScript and built with pnpm and electron-builder. Installers are available through Homebrew, Winget, Scoop, the AUR, and Solus, and developers can run it locally with a single dev command.

Key features

  • 01Runs YouTube Music as a desktop app on Windows, macOS, and Linux.
  • 02Plugin API that can access the Electron window and inject CSS or HTML.
  • 03Custom CSS theme loading from the options menu.
  • 04Frontend-to-backend communication via IPC in plugins.
  • 05Installable through Homebrew, Winget, Scoop, AUR, and Solus.

Use cases

  • Listening to YouTube Music in a standalone window separate from the browser.
  • Restyling the YouTube Music interface with custom CSS themes.
  • Building a plugin that adds features to the YouTube Music player.

Quick start

  1. 1

    Install via Homebrew on macOS

    brew install pear-devs/pear/pear-desktop
  2. 2

    Install via Winget on Windows

    winget install pear-devs.pear-desktop
  3. 3

    Install on Arch Linux from the AUR (see the README for AUR instructions)

Things to know

  • Unofficial app, not affiliated with Google or YouTube.
  • Relies on the YouTube Music web interface, provided as-is with no warranty.

Topics

#electron#music-player#desktop-app#typescript#plugin-system#youtube-music#linux#mac#macosx#music

FAQ

What is pear-desktop?
An unofficial, Electron-based desktop app for YouTube Music with a plugin system for custom CSS and behavior changes. Pear Desktop wraps the YouTube Music web player in a native desktop application for Windows, macOS, and Linux. It is an independent volunteer project and is not affiliated with Google or YouTube.
Is pear-desktop free to use? What license does it have?
pear-desktop is open source under the MIT license. Check the license terms before using it in commercial products.
Is pear-desktop still maintained?
Actively maintained. The last commit to pear-desktop was on Oct 20, 2026.
What can I use pear-desktop for?
Listening to YouTube Music in a standalone window separate from the browser. Restyling the YouTube Music interface with custom CSS themes. Building a plugin that adds features to the YouTube Music player.
How do I install pear-desktop?
Install via Homebrew on macOS: brew install pear-devs/pear/pear-desktop Install via Winget on Windows: winget install pear-devs.pear-desktop Install on Arch Linux from the AUR (see the README for AUR instructions)
Where can I get pear-desktop?
The source code and installation instructions are on GitHub: https://github.com/pear-devs/pear-desktop

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects