$ show Venipa/ytmdesktop2
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.
The LLM identified 4 files worth highlighting for reuse:
A comprehensive, multi-provider synced lyrics engine. It includes robust parsers for LRC (including enhanced word-timestamp format) and TTML formats, a provider abstraction layer (Better Lyrics, LRCLib, Unison, YouTube captions) with orchestrated search and fallback logic, and a clean store for managing state. This module is well-tested, isolated, and could be extracted as a standalone library for any application needing synced lyrics parsing and fetching.
A reusable widget system designed for OBS Studio overlays. It provides a set of React components (Card, Badge, Ticker, Fullscreen, Stack, Text) that render track information and cover art. The system includes a clever query-string flag serializer for configuration and a clean layout abstraction. This pattern is highly reusable for any application needing customizable, embeddable UI components for streaming or display purposes.
A typed, asynchronous postMessage bridge for secure communication between Electron's isolated preload script and the page-world renderer. It features automatic retry logic for late listeners and a clean command/response pattern. This is a non-trivial, well-tested solution to a common Electron challenge, providing a safe and reliable IPC channel that can be extracted for any Electron project requiring page-world interaction.
A robust keyboard shortcut parser and validator. It handles platform-aware display names, reserved key denylists, duplicate detection, and complex modifier combinations. This module is a self-contained utility with comprehensive tests, making it an ideal candidate for extraction into any desktop application that needs a reliable shortcut configuration system.