This repository is a monorepo for **ytmdesktop2**, an unofficial Electron desktop client for YouTube Music. It wraps the YouTube Music web player and enhances it with deep native OS integration, including system tray controls, media key support, Discord Rich Presence, Last.fm scrobbling, Chromecast streaming, custom CSS/SCSS theming, OBS Studio overlays via a local HTTP/WebSocket API, and an Elgato Stream Deck plugin. The architecture is a monolithic Electron application with a clear separation between the main process (Node.js services, tRPC server), the renderer process (React settings UI), and page-world plugins that interact directly with the YouTube Music DOM. Communication between these layers is handled through a combination of tRPC, typed postMessage bridges, and raw IPC. The codebase demonstrates high craftsmanship in several areas, particularly its multi-provider synced lyrics engine (parsing LRC, TTML, and YouTube captions), its embeddable widget system for OBS, and its robust plugin lifecycle management. While the project is actively maintained and well-structured, it carries significant technical debt from its deep coupling to YouTube Music's internal DOM and APIs, which are subject to change. The coexistence of two major Zod versions and some deprecated migration paths indicate ongoing refactoring. Overall, it is a sophisticated and feature-rich desktop application that effectively bridges a web service with the native desktop environment.