th-ch

pear-desktop: Use YouTube Music as a Native Desktop App

Pear Desktop is an unofficial Electron app that gives YouTube Music a native desktop experience on Linux, macOS, and Windows. It supports themes and plugins for customizing the app, with community downloads and an MIT license.

View on GitHub Compare
Stars
33.8k
Forks
2k
Stars, last 30 days
+280
Last commit
4 days ago
Contributors
100+

Our take

Activeregular commits and releases

Health score

54/100

How it is scored
Activity
51
Community
91
Issues
54
Pull requests
20

+280 stars in the last 30 days

  • More contributors than 78% of the projects we track

Pear Desktop is an actively maintained, cross-platform Electron wrapper with an extensible plugin system and a broad contributor base, though its issue backlog merits a look before adoption.

Good fit if

  • You use YouTube Music and want a dedicated desktop app on Linux, macOS, or Windows.
  • You want to customize the app through themes or plugins.
  • You value an MIT-licensed project with regular commits, recent releases, and contributions from many people.

Look elsewhere if

  • You need an official Google or YouTube client, since this project is explicitly unofficial.
  • Your workflow depends on prompt closure of reported issues, since recent issue closures have been limited relative to the open backlog.
  • You need a music player that does not rely on YouTube Music.
All health signals
Last commit2026-10-12 (4 days ago)
Commits, last 90 days36
Releases, last 12 months1 (latest v3.12.0, 2026-06-28)
Contributors100+ (top contributor: 23% of commits)
Issues closed, last 90 days12 (typically closed in 11 days)
Pull requests merged, last 90 days0
Project age7 years

Checked on 2026-10-17 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

34,073

Forks

2,051

Change since Nov 16, 2026: +8 stars·+4 forks

Overview

Pear Desktop is an unofficial Electron app that wraps YouTube Music in a desktop experience for Linux, macOS, and Windows. It is aimed at listeners who want to use YouTube Music in a standalone app with a more native look and feel, rather than in a browser tab.

The project also provides a plugin system for changing app behavior and appearance. It is independent of Google and YouTube, and does not claim official affiliation with either.

Key Features

  • Runs on Linux, macOS, and Windows.
  • Supports CSS themes loaded through the app's visual settings.
  • Offers plugins that can alter the interface and interact with Electron's BrowserWindow.
  • Provides plugin hooks for renderer, preload, and backend behavior, with IPC for communication.
  • Offers community translations through Hosted Weblate.
  • Includes Playwright tests and CI workflows.

Use Cases

  • YouTube Music listeners who prefer a standalone desktop window over a browser tab.
  • Users who want to adjust the app's appearance with CSS themes.
  • Developers who want to build plugins that customize the interface or interact with Electron features.
  • Users on Linux, macOS, or Windows who want to install the app through platform package managers or release downloads.

What you need

Detected in the repository

  • Node.js >=22 (from package.json)
  • A test suite and automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

On macOS, install with Homebrew:

brew install pear-devs/pear/pear-desktop

For other platforms and installation options, see the README.

Alternatives

  • nuclear: Nuclear is a source-agnostic streaming music player, while Pear Desktop provides a native app for YouTube Music.
ProjectLanguageLicenseStarsStatus
pear-desktopTypeScriptMIT33.8kActive
nuclearTypeScriptAGPL-3.018.6kActive

Considerations

  • This is an independent, unofficial client, not software endorsed by Google or YouTube; the project provides no guarantee about the service or application.
  • The repository is active, with recent commits and a release in the past year. It has more than 100 contributors and no strong dependence on a single contributor, but its open issue backlog is substantial and recent issue closure activity has been modest.
  • Developing or building the app requires Node.js 22 or later. The repository includes tests and CI.
  • The MIT license permits broad reuse, subject to its license terms. The project itself disclaims liability for use of the software.

Found this useful?

Share it with someone who would like pear-desktop.

Comparisons