How pear-devs/pear-desktop works
Pear Desktop is an Electron desktop experience for YouTube Music, extended through plugins that can alter the native window and renderer UI. The principal flow is user interaction in the desktop player, player-control and song-data providers, then optional plugin features or external integrations. Plugin definitions span backend, preload, renderer and menu lifecycles; persisted configuration governs activation. The README documents the plugin capabilities and lifecycle, while sampled source confirms main-process plugin loading and selected provider/integration wiring; unsampled plugin internals are represented only at their supported directory paths.
Main entry points: loader/main.ts Plugin lifecycle · index.ts Electron shell · menu.ts Native menus · backend/main.ts Control API
Components 22
Desktop runtime
- Electron shell
src/index.ts - App configuration
src/config/store.ts - Native menus
src/menu.ts
Player providers
- Player data bridge
src/providers/song-info-front.ts - Song metadata
src/providers/song-info.ts - Song controls
src/providers/song-controls.ts - App controls
src/providers/app-controls.ts
Plugin platform
- Plugin lifecycle
src/loader/main.ts - Plugin definitions
src/types/plugins.ts - Plugin contexts
src/types/contexts.ts
Player extensions
- Control API
src/plugins/api-server/backend/main.ts - API routes
src/plugins/api-server/backend/routes/index.ts - Synced lyrics
src/plugins/synced-lyrics - Shared listening
src/plugins/music-together - Music downloader
src/plugins/downloader - Audio enhancements
src/plugins/equalizer
External integrations
- Rich presence
src/plugins/discord/discord-service.ts - Scrobbling
src/plugins/scrobbler - Discord service
src/plugins/discord/discord-service.ts - Scrobble services
src/plugins/scrobbler/services
Other components
- Desktop user
- YouTube Music
Connections 22
- Desktop user → Electron shell: uses
README.md - YouTube Music → Electron shell: provides player
- Electron shell → Plugin lifecycle: loads plugins
src/index.ts - Plugin lifecycle → Plugin definitions: loads definitions
src/loader/main.ts - Plugin lifecycle → App configuration: reads settings
src/loader/main.ts - Plugin lifecycle → Plugin contexts: creates contexts
src/loader/main.ts - Desktop user → Native menus: configures features
README.md - Native menus → Plugin lifecycle: loads menu plugins
src/menu.ts - Player data bridge → Song metadata: sends player data
src/providers/song-info-front.ts - Electron shell → App controls: registers controls
src/index.ts - Control API → API routes: registers routes
src/plugins/api-server/backend/main.ts - API routes → Song controls: dispatches controls
- Plugin lifecycle → Control API: activates extension
- Plugin lifecycle → Synced lyrics: activates extension
- Plugin lifecycle → Shared listening: activates extension
- Plugin lifecycle → Music downloader: activates extension
- Plugin lifecycle → Audio enhancements: activates extension
- Plugin lifecycle → Rich presence: activates extension
- Plugin lifecycle → Scrobbling: activates extension
- Rich presence → Discord service: updates presence
src/plugins/discord/main.ts - Discord service → Song metadata: reads metadata
src/plugins/discord/discord-service.ts - Scrobbling → Scrobble services: uses services
src/plugins/scrobbler/main.ts