Reading the repo

Opening the box…

How to set up pear-desktop (pear-devs/pear-desktop) · gitmanual

Assembly instructions

pear-devs/pear-desktop

Pear 🍐 is extension for music player

Node.jsVite#desktop-app#electron#linux#mac

Difficulty: Easy
Time: about 5 min
Stars: ★ 33,979
Activity: Updated this month
License: MIT
Open issues: 765
Got it running: Be the first
Looked up: 4 h ago

Saved setup from 4 h ago

Start here

In the browser ↗Open in GitHub CodespacesThe repo ships a dev container, so nothing to install.

Will it work on my device?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Checking for

Download for macOS

3.12.0 · 6/28/2026 ↗

YouTube-Music-3.12.0-arm64.dmg

dmg · Apple Silicon · 124.1 MB · 45,136 downloads · best match

Download

Drag the app into Applications.

curl -LO "https://github.com/pear-devs/pear-desktop/releases/download/v3.12.0/YouTube-Music-3.12.0-arm64.dmg"
open "YouTube-Music-3.12.0-arm64.dmg"

Other macOS downloads (1)

YouTube-Music-3.12.0.dmg

dmg · 125.1 MB · 5,233 downloads

Download

Drag the app into Applications.

curl -LO "https://github.com/pear-devs/pear-desktop/releases/download/v3.12.0/YouTube-Music-3.12.0.dmg"
open "YouTube-Music-3.12.0.dmg"

Install with a package manager

Homebrew

brew install pear-devs/pear/pear-desktop

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

Claude reads the 10 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Node.js >=22runtime
1×pnpm package manager

Share this manual

Good to know

Monorepo (workspaces) — install from the repo root.
Dev Container config found — you can open it in VS Code Dev Containers or GitHub Codespaces for a zero-setup environment.

package.json scripts (28)

postinstallpnpm install-electron
testpnpm playwright test
test:debugpnpm cross-env DEBUG=pw:*,-pw:test:protocol playwright test
buildpnpm electron-vite build
vite:inspectpnpm clean && electron-vite build --mode development && pnpm exec serve .vite-inspect
startpnpm electron-vite preview
start:debugpnpm cross-env ELECTRON_ENABLE_LOGGING=1 pnpm start
devpnpm cross-env NODE_ENV=development NODE_OPTIONS=--enable-source-maps electron-vite dev --watch
dev:rendererpnpm cross-env NODE_ENV=development NODE_OPTIONS=--enable-source-maps electron-vite dev
dev:debugpnpm cross-env ELECTRON_ENABLE_LOGGING=1 pnpm dev
cleanpnpm del-cli dist && pnpm del-cli pack && pnpm del-cli .vite-inspect
distpnpm clean && pnpm build && pnpm electron-builder --win --mac --linux -p never
dist:linuxpnpm clean && pnpm build && pnpm electron-builder --linux -p never
dist:linux:deb-arm64pnpm clean && pnpm build && pnpm electron-builder --linux deb:arm64 -p never
dist:linux:rpm-arm64pnpm clean && pnpm build && pnpm electron-builder --linux rpm:arm64 -p never
dist:macpnpm clean && pnpm build && pnpm electron-builder --mac dmg:x64 -p never
dist:mac:arm64pnpm clean && pnpm build && pnpm electron-builder --mac dmg:arm64 -p never
dist:winpnpm clean && pnpm build && pnpm electron-builder --win -p never
dist:win:x64pnpm clean && pnpm build && pnpm electron-builder --win nsis-web:x64 -p never
lintpnpm oxlint --type-aware src
formatpnpm oxfmt --write src
format:checkpnpm oxfmt --check src
changelogpnpm dlx auto-changelog
release:linuxpnpm clean && pnpm build && pnpm electron-builder --linux -p always -c.snap.publish=github
release:macpnpm clean && pnpm build && pnpm electron-builder --mac -p always

Files we read (10)

.devcontainer/devcontainer.json

.github/workflows/build.yml

.github/workflows/dependency-review.yml

.github/workflows/issue-triage.yml

.github/workflows/pr-build-artifacts.yml

.github/workflows/reviewdog.yml

.github/workflows/winget-cla.yml

README.md

package.json

pnpm-workspace.yaml

Branch master · 415 files in the repo