pear-devs/pear-desktop
35.2
Weak · 7 November 2026
29.4k
lines of production code
TypeScript
primary language
4
measurements over time
What this system is
Features
Add Amuse plugin for song query API
A new Amuse plugin has been added to the application, introducing a local HTTP server (port 9863) that exposes a song query API. This plugin registers a callback to receive current song information and serves it via \/query\ and \/api\ endpoints, formatted to match the Amuse protocol structure. The plugin is disabled by default and requires a restart to enable.
src/plugins/amuse · high confidence
Add Auth Proxy Adapter plugin for configurable proxy settings
Introduces the new auth-proxy-adapter plugin, allowing users to configure an authenticated proxy via hostname and port settings through the application menu. The plugin includes a configuration interface with default values (127.0.0.1:4545) and menu items to prompt users for custom hostname and port values, requiring a restart to apply changes.
src/plugins/auth-proxy-adapter · high confidence
Add Clock plugin with configurable time display
A new Clock plugin has been added to the application, providing a widget that displays the current time. Users can enable the plugin and configure it via the settings menu to toggle the display of seconds and switch between 12-hour and 24-hour time formats. The widget renders a centered time display that updates every second and can be stopped or removed cleanly.
src/plugins/clock · high confidence
Add Custom Output Device plugin for audio routing
A new plugin has been added that allows users to select specific audio output devices for playback. The plugin registers a menu item that opens a prompt listing available audio output devices (retrieved via the Web Audio API's enumerateDevices). When a user selects a device, the application updates its configuration and applies the change to the active audio context using setSinkId, ensuring audio plays through the chosen hardware. The plugin also listens for device connection/disconnection events to keep the device list current.
src/plugins/custom-output-device · high confidence
Add Equalizer plugin with bass-boost preset
A new Equalizer plugin is introduced, allowing users to apply audio filters via the application menu. The plugin currently includes a 'bass-booster' preset that uses a low-shelf filter (80 Hz, Q: 100, +12 dB gain) to enhance low frequencies. Users can toggle this preset on or off through the plugin's menu interface, and the audio processing is applied dynamically when audio becomes playable.
src/plugins/equalizer · high confidence
Add LRC synced lyrics parser with karaoke support
The synced-lyrics plugin now includes a new LRC parser that handles standard timestamped lyrics, metadata tags (such as artist, album, and title), and karaoke-style word-level timing. The parser correctly converts LRC timestamps to milliseconds, applies any defined offset, calculates line durations, and ensures playback starts at zero by inserting an initial empty line if the first timestamp is delayed.
src/plugins/synced-lyrics/parsers · high confidence
Add LumiaStream plugin for media control integration
A new plugin named 'LumiaStream' has been added to the application. It integrates with a local web server running on port 39231 by sending POST requests to /api/media whenever song information changes or playback state (play/pause) is toggled. The plugin requires a restart to take effect and includes internationalization support for its name and description.
src/plugins/lumiastream · high confidence
Add Music Together plugin UI templates
Introduces the user interface templates for the new Music Together plugin, including item, popup, setting, and status views. These HTML files define the layout for the plugin's menu item, navigation bar button with a loading spinner, status display with profile image and connection state, and the settings interface.
src/plugins/music-together/templates · high confidence
Add Music Together plugin for synchronized listening
Introduces the new Music Together plugin, enabling users to host or join shared listening sessions. The plugin provides a peer-to-peer connection layer (via PeerJS) to synchronize the queue and playback state across participants, along with UI components for host/guest menus, connection status, and profile management.
src/plugins/music-together · high confidence
Add Music Together queue management plugin
Introduces the new 'Music Together' plugin located in src/plugins/music-together/queue, which enables users to manage and synchronize music queues. The implementation includes a client module for generating authentication headers via SHA-1 hashing, a queue controller for handling video list synchronization and dispatching state changes, and utility functions for parsing queue item renderers and fetching queue data from the music service.
src/plugins/music-together/queue · high confidence
Add Unobtrusive Player plugin
Introduces a new optional plugin that manages the YouTube Music player page behavior. When enabled, it automatically closes the full-screen player page when the video changes, provided the user has previously initiated playback. The plugin also handles shuffle play interactions and applies CSS styles to hide the player page content while keeping the main interface visible, ensuring a less intrusive experience.
src/plugins/unobtrusive-player · high confidence
Add audio compressor plugin
A new audio compressor plugin has been added to the system, introducing real-time audio dynamics processing. This plugin automatically connects a dynamics compressor node to the audio source when playback begins, applying default settings (threshold: -50, ratio: 12, knee: 40, attack: 0, release: 0.25) to manage audio levels. It includes logic to handle audio context loading and safely manages connections and disconnections to prevent audio glitches or duplicate processing.
src/plugins · high confidence
Add authenticated SOCKS5 proxy adapter plugin
The auth-proxy-adapter backend plugin now provides a SOCKS5 proxy server that supports authentication. It listens for SOCKS5 connections, handles the handshake, and forwards traffic through an upstream proxy configured via system settings, enabling authenticated proxy usage within the application.
src/plugins/auth-proxy-adapter/backend · high confidence
Add configurable global and local keyboard shortcuts with MPRIS support on Linux
The new Shortcuts plugin allows users to define custom global and local keyboard shortcuts for previous, play/pause, and next actions via the application menu. It includes an option to override system media keys and, on Linux, integrates with MPRIS to expose playback controls (play, pause, next, previous, seek, volume, shuffle, repeat) to the desktop environment.
src/plugins/shortcuts · high confidence
Add macOS Touch Bar plugin for music playback controls
A new plugin has been added for macOS that integrates music playback controls into the system Touch Bar. This feature displays the current song title and album art in a scrubber view, alongside buttons for previous track, play/pause, next track, dislike, and like. The plugin is platform-specific to macOS, requires a restart to activate, and is disabled by default in the configuration.
src/plugins/touchbar · high confidence
Add navigation plugin with Material UI 3 back/forward buttons
A new navigation plugin has been added that renders back and forward buttons in the UI using Material UI 3 components (mdui-button-icon, mdui-tooltip). The buttons are inserted into the \#right-content area and utilize LitElementWrapper to render chevron icons, providing users with standard browser navigation controls.
src/plugins/navigation · high confidence
Added Skip Disliked Songs plugin
A new plugin has been introduced that automatically skips songs marked as disliked. It works by monitoring the 'like-status' attribute of the dislike button and programmatically clicking the next track button when a dislike is detected.
src/plugins/skip-disliked-songs · high confidence
Added TypeScript declarations for Kuroshiro and Kuromoji analyzers
TypeScript type definitions have been added for the kuroshiro and kuroshiro-analyzer-kuromoji libraries, enabling type-safe integration of Japanese text conversion features such as romaji, hiragana, and katakana conversion within the application.
src/ts-declarations · high confidence
Ambient Mode plugin adds configurable blur effects and UI settings
The ambient-mode plugin now provides a dedicated configuration menu allowing users to adjust the visual blur effect applied to song images and video backgrounds. Users can fine-tune parameters including blur amount, effect size, opacity, quality, transition smoothness, and frame buffer rate, as well as toggle a fullscreen mode. The plugin also includes CSS fixes to prevent the blur overlay from overlapping with player controls and side panels.
src/plugins/ambient-mode · high confidence
Expanded synced lyrics sources with new providers
The synced lyrics plugin now supports four additional lyric sources: LRCLib, Genius, Musixmatch, and YouTube Music. This expands the available options for retrieving synchronized and plain-text lyrics, giving users more chances to find accurate lyrics for their tracks by leveraging these external services alongside existing capabilities.
src/plugins/synced-lyrics/providers · high confidence
Introduce API Server plugin with HTTPS and authentication configuration
Adds a new API Server plugin that allows users to enable a remote control interface via the application menu. The plugin introduces configuration options for the server hostname and port, authentication strategies (auth-at-first or none), and HTTPS support with custom certificate and key path selection. The server is disabled by default.
src/plugins/api-server · high confidence
Introduce API server authentication, control endpoints, and WebSocket updates
The API server backend now includes a new authentication route at /auth/{id} that issues JWT access tokens, supporting configurable strategies (none or interactive dialog approval) and maintaining a list of authorized clients. A comprehensive control module exposes endpoints for playback management (play, pause, toggle, previous, next), media interaction (like, dislike, seek, go-back, go-forward), and queue operations (add, move, set index). Additionally, a WebSocket endpoint at /api/v1/ws provides real-time player state updates (song info, position, volume, repeat/shuffle state) to connected clients, requiring JWT authentication when the auth strategy is not set to none.
src/plugins/api-server/backend/routes · high confidence
Introduce Do-Not-Track plugin with tracker blocking and ad injection prevention
A new 'do-not-track' plugin is added, providing two modes for user privacy: 'InPlayer' mode, which injects scripts to prevent ad data from appearing in video players (specifically targeting YouTube-like structures), and 'WithBlocklists' mode, which uses the Ghostery adblocker-electron library to block network requests based on configurable filter lists. The plugin includes configuration options to enable/disable the feature, toggle caching of the blocker engine, select the blocking mode, and manage additional or default blocklists. It integrates with the Electron main and preload processes to apply these protections.
src/plugins/do-not-track · high confidence
Introduce Synced Lyrics plugin with provider selection and display customization
Adds a new Synced Lyrics plugin that replaces the default lyrics view with a synchronized, time-coded display. Users can configure a preferred lyrics provider, toggle precise timing, and choose from four line effects (fancy, scale, offset, focus). The plugin also supports romanization, Simplified/Traditional Chinese character conversion, and customizable default text strings for inactive lines.
src/plugins/synced-lyrics · high confidence
Introduce in-app menu plugin with custom title bar and platform-specific defaults
The in-app-menu plugin is now available, providing a custom in-app title bar that replaces the native window controls on non-macOS, non-Windows platforms. The plugin includes a configuration option to hide DOM window controls (specifically exposed in the menu on Linux) and applies CSS adjustments to fix layout issues such as laggy scrolling in large playlists, scrollbar positioning, and mini-player behavior. It registers an IPC handler to bridge Electron's native menu and window controls with the renderer, and sets the default enabled state based on the operating system to ensure compatibility.
src/plugins/in-app-menu · high confidence
Introduce new downloader plugin implementation
The downloader plugin's main logic has been replaced with a new implementation in \src/plugins/downloader/main/index.ts\. This version integrates \youtubei.js\ for YouTube interactions, utilizes \bgutils-js\ to handle backend challenges, and adds support for checking premium status via the UI upgrade button. It also includes new utility functions in \utils.ts\ for folder management, image cropping, and IPC feedback.
src/plugins/downloader/main · high confidence
Introduce plugin system type definitions and configuration utilities
Added a new \src/plugins/utils/common\ module that defines the core TypeScript interfaces for the plugin system, including base \Plugin\, \RendererPlugin\, \MainPlugin\, \PreloadPlugin\, and \MenuPlugin\ types. This change also introduces a \definePluginConfig\ helper function to manage default plugin configurations, establishing the foundational type contract for plugin implementations within the application.
src/plugins/utils/common · high confidence
Introduce strict TypeScript types for the plugin system and player API
The \src/types\ directory now contains a comprehensive set of new TypeScript definition files that formally type the application's plugin architecture and core player interfaces. This includes \contexts.ts\ and \plugins.ts\, which define the \PluginDef\ structure, lifecycle hooks (start, stop, onConfigChange), and environment-specific contexts (Backend, Preload, Renderer, Menu) for plugin development. Additionally, \music-player.ts\ and \player-api-events.ts\ provide strict interfaces for the YouTube player API, covering methods like \cueVideoByPlayerVars\, \setLoopRange\, and event structures such as \PlayerOverlays\ and \AlbumDetails\. Supporting types for UI state (\datahost-get-state.ts\), queue management (\queue.ts\), and video metadata (\video-details.ts\) are also added, replacing loose typing with explicit contracts for the player, queue, and toast services.
src/types · high confidence
Introduces API request and response schemas for the API server
This change adds the Zod validation schemas that define the structure of requests and responses for the API server's endpoints. The new files in the \scheme\ directory formalize the data contracts for features including authentication (JWT payload), media control (seek, go-back, go-forward, set-volume, set-fullscreen, switch-repeat), queue management (add song with insert position, move song, set index), search (with optional params and continuation), and song information retrieval. These schemas ensure that API inputs are validated against expected types and constraints before being processed.
src/plugins/api-server/backend/scheme · high confidence
Introduction of i18n internationalization support
The application now supports internationalization through the new \src/i18n/index.ts\ module. This change initializes the i18next library to load language resources dynamically and provides utilities for changing the application language and translating text, with English set as the default and fallback language.
src/i18n · high confidence
New Scrobbler plugin with Last.fm and ListenBrainz support
A new Scrobbler plugin has been added, allowing users to scrobble playback history to Last.fm and ListenBrainz. The plugin includes configuration options to enable or disable each service, as well as toggles for scrobbling non-music media (like podcasts), using alternative song titles, and using alternative artist names. Users can configure API credentials and tokens directly through the plugin's menu interface.
src/plugins/scrobbler · high confidence
New Transparent Player plugin for window transparency effects
A new plugin has been added that allows users to apply transparency and material effects to the application window. On Windows, it supports Mica, Acrylic, and Tabbed background materials, while macOS supports various vibrancy materials like Window and Fullscreen UI. Users can configure the effect type and adjust the window opacity via a new menu, with CSS styles applied to the player bar, navigation, and other UI elements to match the transparent background.
src/plugins/transparent-player · high confidence
New audio visualizer plugin with multiple rendering modes
A new visualizer plugin has been added to the application, allowing users to overlay audio-reactive graphics on the video player. The plugin supports three distinct visualizer types: Butterchurn (a classic fractal zoom visualizer), Vudio (offering waveform, circlewave, circlebar, and lighting effects), and a custom Wave visualizer (supporting animations like cubes and circles). Users can configure the visualizer type, specific effects, colors, and animation parameters via the plugin menu. The implementation includes TypeScript definitions for the underlying libraries and handles canvas rendering within the player container.
src/plugins/visualizer · high confidence
New performance improvement plugin with CPU Tamer and RM3
A new 'performance-improvement' plugin has been added, which is enabled by default and requires a restart to take effect. This plugin injects two core scripts: 'CPU Tamer', which optimizes browser rendering performance by intercepting animation frames and DOM mutations (selecting the best method based on GPU acceleration availability), and 'RM3', a library that tracks and reuses DOM element operations to reduce overhead. These scripts are bundled into the plugin's renderer to automatically apply these optimizations upon activation.
src/plugins/performance-improvement · high confidence
New plugin to disable video autoplay
A new plugin has been added to allow users to prevent videos from playing automatically. The plugin listens for the 'videodatachange' event and pauses the video when data is loaded. It includes a configuration option to apply this behavior only once, after which the listener is removed. The plugin integrates with the application's internationalization system for its name, description, and menu label.
src/plugins/disable-autoplay · high confidence
New plugin utility module for CSS injection, file checks, and fetch abstraction
A new \src/plugins/utils/main\ module has been introduced, providing core utilities for the plugin system. This includes \css.ts\ for dynamically injecting CSS styles into Electron web contents with support for unregistration, \fetch.ts\ which wraps Electron's \net\ module to provide a standard \fetch\-compatible API, and \fs.ts\ offering a helper to check for file existence. The module also exports type-definition helpers (\defineMainPlugin\, \definePreloadPlugin\, \defineMenuPlugin\) to standardize plugin configuration structures.
src/plugins/utils/main · high confidence
New provider modules for app controls, song info, and protocol handling
The application introduces a new set of provider modules in src/providers to manage core functionality. app-controls.ts handles IPC for restarting, reloading, and path resolution. song-controls.ts and protocol-handler.ts establish a robust control interface for playback, queue management, and volume, supporting both direct calls and protocol commands. song-info.ts and song-info-front.ts manage song metadata extraction, image fetching, and real-time state synchronization (playback, shuffle, repeat, like status) via IPC and DOM observers. Additional providers include decorators.ts for utility functions like caching and debouncing, extracted-data.ts for defining starting page mappings, prompt-options.ts for UI styling, and dom-elements.ts for specific UI element selection.
src/providers · high confidence
New utility functions for plugin lifecycle, DOM waiting, and security policies
The src/utils directory now includes several new helper modules: custom-element.ts provides a factory for creating anonymous SolidJS custom elements; index.ts introduces core plugin lifecycle management functions (createPlugin, createBackend, createPreload, createRenderer, startPlugin, stopPlugin) that handle context binding, execution timing, and i18n-based logging; trusted-types.ts implements a wrapper for registering a default Trusted Types policy to mitigate XSS risks when creating HTML/script content; wait-for-element.ts adds a utility to poll for DOM elements with configurable retry intervals; and testing.ts exposes an environment check helper. These changes enhance the plugin system's robustness, security, and developer experience.
src/utils · high confidence
New video-toggle and quality-changer plugins added
This change introduces two new plugins to the application. The video-toggle plugin allows users to control the visibility and layout of the video player in the music interface, offering options to use a custom toggle button, the native YouTube Music switcher, or to disable the switcher entirely, with additional settings to force-hide the video panel and align the custom button. The quality-changer plugin adds a new button to the player controls that lets users select from available audio quality levels via a dialog, updating the playback quality accordingly.
src/plugins/video-toggle · high confidence
Removals
Adblocker plugin removed
The adblocker plugin has been removed from the application. This change deletes the plugin's source files (including the blocker logic, ad detection, and buffer generation scripts) and its associated configuration, meaning the application no longer includes ad-blocking capabilities.
plugins/adblocker · high confidence
Removal of legacy navigation plugin implementation
The navigation plugin's core implementation files (actions.js, back.js, and front.js) have been removed. This eliminates the previous mechanism for injecting forward/back buttons into the UI and handling navigation actions via the old channel-based communication model.
plugins/navigation · high confidence
Removal of legacy plugin store and helper modules
The application has removed the \store/index.js\ and \store/plugins.js\ files, which previously managed plugin state (such as navigation, shortcuts, adblocker, and no-google-login) and provided helper functions for enabling or disabling plugins. This change eliminates the legacy storage mechanism and plugin management logic from the store layer, likely as part of a broader refactoring to simplify configuration or migrate to a different persistence strategy.
store · high confidence
Removal of legacy shortcut registration and YouTube-specific key mappings
The \back.js\ and \youtube.js\ files in the shortcuts plugin have been removed. This eliminates the previous implementation that registered global and local shortcuts (such as MediaPlayPause, MediaNextTrack, and MediaPreviousTrack) and mapped specific keyboard inputs (Space, j, k, /) for YouTube control via \webContents.sendInputEvent\. Users will no longer have these specific legacy shortcut behaviors available in this plugin location.
plugins/shortcuts · high confidence
Removal of no-google-login plugin
The no-google-login plugin has been completely removed from the application. This eliminates the functionality that previously hid Google login buttons and specific navigation elements (such as the 'Liked' tab) on YouTube Music by deleting the associated backend script, frontend logic, and CSS styles.
plugins/no-google-login · high confidence
Removal of shared plugin utility module
The shared utility module (plugins/utils.js) has been removed from the codebase. This module previously provided helper functions for plugin development, including DOM element creation from HTML strings or files, path resolution for templates, IPC action triggering and listening, file existence checks, and CSS injection logic. Its removal suggests these capabilities are either being refactored into individual plugins, moved to a different location, or replaced by alternative implementations.
plugins · high confidence
Removed legacy navigation template files
The \back.html\ and \forward.html\ template files within the navigation plugin have been deleted. These files previously defined the HTML structure for the previous and next page navigation controls, including their associated icons and click handlers. Their removal indicates that the navigation UI no longer relies on these specific static template definitions.
plugins/navigation/templates · high confidence
Architecture
Migrate application source code to the src directory
The application's source code has been reorganized into the src directory, introducing a new entry point structure with src/index.ts for the main process and src/renderer.ts for the UI. This change includes new configuration files for the build system (src/pear-desktop.ts, src/index.html), a dedicated tray management module (src/tray.ts), and a new menu system (src/menu.ts) that supports plugin-based customization. The migration also adds comprehensive TypeScript type definitions for the environment and external libraries, such as custom Electron prompts, navigation history, and YouTube web components, ensuring type safety across the new codebase layout.
src · high confidence
Behavioural changes
API server backend restructured with HTTPS support and JWT security
The API server backend has been reorganized into a modular structure (main.ts, api-version.ts, types.ts) and now supports HTTPS with custom certificate configuration. Security has been enhanced by requiring the 'alg' option in JWT middleware and implementing authorization checks for WebSocket connections. The server also exposes repeat mode, volume state, and like/dislike status via API endpoints and websockets, with Swagger documentation available at /swagger.
src/plugins/api-server/backend · high confidence
Add custom ESLint camelcase rule plugin
The tools directory now includes a new \eslint-core-plugin.mjs\ file that defines a custom ESLint rule for enforcing camelcase naming conventions. This plugin provides logic to detect and report identifiers that do not follow camelcase standards, supporting options to ignore destructuring, imports, and globals, as well as allowing specific patterns. This change is part of the broader migration from ESLint to oxlint, where this plugin serves as a compatibility layer or custom rule implementation for the linting configuration.
tools · high confidence
Added offline error page and updated application assets
The application now includes a dedicated offline error page (\assets/error.html\) that displays a 'Cannot load Pear Desktop' message with a retry button when the internet connection is lost. Additionally, the application icon has been updated to a new SVG version (\assets/icon.svg\), and the Material Design UI (MDUI) component library styles (\assets/mdui.css\) have been added to support the interface.
assets · high confidence
Album Actions plugin rewritten in SolidJS with new UI components
The Album Actions plugin has been migrated from raw HTML to JSX using the SolidJS framework. This change introduces dedicated UI components (LikeButton, DislikeButton, UnLikeButton, UnDislikeButton) that render interactive buttons for managing playlist likes and dislikes. The plugin now uses SolidJS signals to manage the visibility and styling of these buttons, allowing for dynamic updates when users interact with the playlist, such as toggling like/dislike states or loading full lists.
src/plugins/album-actions · high confidence
Album Color Theme plugin now applies dynamic theming across the entire UI
The album-color-theme plugin has been rewritten to extract dominant colors from album artwork and apply them as CSS variables throughout the application. This change extends the theme beyond the player to include the navigation bar, sidebar, and background elements, ensuring consistent color integration across all pages. Users can now configure the color mixing ratio and toggle seekbar theming via the plugin menu, while the underlying logic handles both light and dark mode adaptations automatically.
src/plugins/album-color-theme · high confidence
Audio visualizer implementations migrated to new plugin API
The visualizer components (Butterchurn, Vudio, and Wave) have been refactored to implement the new plugin API, introducing a shared abstract \Visualizer\ base class that standardizes audio node management and lifecycle methods like \resize\ and \destroy\. This change removes the previous requirement for application restarts when switching visualizers and ensures consistent cleanup of audio sources and animation frames across all three visualization modes.
src/plugins/visualizer/visualizers · high confidence
Blur navigation bar plugin migrated to new plugin API
The blur-nav-bar plugin has been rewritten to use the new plugin system, replacing the previous implementation with a modular structure that leverages the new \createPlugin\ utility and supports internationalization for its name and description. The plugin now injects CSS styles using the \CSSStyleSheet\ API to apply a blur effect and semi-transparent background to the navigation bar and tabs, and it correctly handles enabling and disabling these styles via the new \start\ and \stop\ lifecycle hooks.
src/plugins/blur-nav-bar · high confidence
Captions selector plugin rewritten with new plugin API and SolidJS UI
The captions selector plugin has been completely rewritten to use the new plugin system, introducing a backend/renderer architecture. The user-facing UI is now built with SolidJS (TSX) instead of raw HTML, providing a captions settings button in the player controls that opens a native prompt to select or disable caption tracks. The plugin now supports configuration options for auto-loading the last selected caption and disabling captions entirely, with i18n support for all user-visible strings.
src/plugins/captions-selector · high confidence
Crossfade plugin migrated to new plugin API with i18n support
The crossfade plugin has been rewritten to use the new plugin API, moving its source code into the src/plugins/crossfade directory. This update introduces internationalization (i18n) for the plugin's name, description, and configuration menu labels, ensuring they are properly localized. The plugin now exposes configuration options for fade-in/fade-out durations, the timing for starting the crossfade, and the scaling algorithm (linear, logarithmic, or custom dB), all accessible via a localized settings prompt. Additionally, the internal volume fading logic has been refactored into a dedicated VolumeFader class to handle media element volume transitions more robustly.
src/plugins/crossfade · high confidence
Discord Rich Presence plugin refactored with improved state management and new display options
The Discord plugin has been restructured into a modular service-based architecture (constants, service, timer manager, utils) to centralize logic and improve reliability. This update introduces throttled progress updates (15s throttle, 5s debounce) to reduce RPC spam, adds an inactivity timeout to clear activity when music is paused, and allows users to configure which field (title, artist, or application name) is displayed in the status. It also fixes Hangul character padding issues, adds URLs for songs and artists in the rich presence, and includes a 'Play on YouTube Music' button option.
src/plugins/discord · high confidence
Downloader plugin restructured with new finish-action settings and context menu integration
The downloader plugin has been rewritten to use the new plugin API and SolidJS (TSX), introducing a 'Download on finish' configuration that lets users automatically trigger a download after a specified time or percentage completion. The plugin now adds a download button directly to the context menu for songs, albums, and playlists, and supports customizable audio presets (including MP3, Source, and Custom) via FFmpeg arguments.
src/plugins/downloader · high confidence
Downloader template migrated to JSX
The download button template in the downloader plugin has been converted from raw HTML to JSX (TSX), enabling the use of SolidJS-style component syntax for rendering the download UI.
src/plugins/downloader/templates · high confidence
Exponential volume plugin now uses i18n and fixes volume desync
The exponential-volume plugin has been updated to support internationalization, with its name and description now retrieved via the i18n system. Additionally, a bug causing volume desynchronization has been fixed by implementing a synchronization loop that ensures the player's volume state remains consistent with the exponential scaling logic.
src/plugins/exponential-volume · medium confidence
In-app menu renderer is rewritten with new UI components
The in-app menu renderer has been refactored to use a new set of SolidJS components (IconButton, MenuButton, Panel, PanelItem, TitleBar, WindowController). This introduces a redesigned menu interface with improved positioning logic using floating-ui, custom animations, and a new visual style including backdrop blur and specific hover/active states. The window controller now provides explicit minimize, maximize, and close buttons within the title bar area.
src/plugins/in-app-menu/renderer · high confidence
Migrate plugin UI templates to JSX (SolidJS)
The UI templates for the captions selector, picture-in-picture, and playback speed plugins have been converted from raw HTML to JSX (TSX) using SolidJS syntax. This change updates the component definitions for the captions settings button, the picture-in-picture menu item, and the playback speed slider to use JSX expressions, ensuring consistent rendering and integration with the SolidJS framework.
src/plugins/captions-selector/templates, src/plugins/picture-in-picture/templates, src/plugins/playback-speed/components · high confidence
New Vite plugin infrastructure for code splitting and context-aware plugin loading
The build system now uses three new Vite plugins in the vite-plugins directory to improve modularity and performance. The i18n-importer plugin dynamically generates a virtual module to lazy-load internationalization resource files. The plugin-importer plugin generates virtual modules that handle plugin discovery and loading, using dynamic imports for the renderer and static imports for the preload context to ensure compatibility. The plugin-loader plugin performs static analysis on plugin source files to strip out context-specific properties (backend, preload, renderer, menu) based on the current build mode, enabling effective code splitting by ensuring each context only includes the necessary plugin code.
vite-plugins · high confidence
New renderer utility functions for DOM parsing and element creation
The \src/plugins/utils/renderer\ module now exports helper functions to safely parse HTML strings into DOM elements (\ElementFromHtml\) and create image elements from source URLs (\ImageElementFromSrc\), replacing previous raw HTML injection methods with a safer DOMParser-based approach. Additionally, new detection utilities (\isMusicOrVideoTrack\, \isAlbumOrPlaylist\, \isPlayerMenu\) have been added to identify specific YouTube Music UI components, enabling more precise context-aware rendering for plugin features.
src/plugins/utils/renderer · high confidence
Notifications plugin rewritten with platform-specific interactive and native modes
The notifications plugin has been completely rewritten to support distinct behaviors on Windows and Linux. On Windows, it now offers an 'interactive' mode that generates rich toast notifications with customizable XML templates (including logo, hero, and banner styles) and media control buttons (play, pause, next, previous), configurable via the plugin menu. On Linux, it uses standard native notifications with configurable urgency levels (low, normal, critical). The plugin also introduces new configuration options such as \trayControls\, \hideButtonText\, \refreshOnPlayPause\, and \unpauseNotification\, and ensures proper internationalization for plugin names, descriptions, and menu items.
src/plugins/notifications · high confidence
Picture-in-Picture plugin migrated to new architecture with native support
The Picture-in-Picture plugin has been rewritten to use the new plugin API, introducing a modular structure with separate backend, renderer, and menu handlers. This update adds support for native browser Picture-in-Picture mode via the 'useNativePiP' configuration option, allowing users to toggle PiP using the browser's native API or the app's custom window management. The plugin now features a dedicated menu for configuring options such as 'alwaysOnTop', 'savePosition', 'saveSize', and custom hotkeys, with all labels and descriptions localized via i18n. The renderer uses SolidJS for the PiP button component and implements robust event handling for window state changes, shortcut blocking, and UI adjustments specific to the PiP mode, including CSS improvements for visibility and drag behavior.
src/plugins/picture-in-picture · high confidence
Playback speed plugin migrated to SolidJS and new plugin API
The playback speed plugin has been rewritten to use the new plugin API and SolidJS (TSX) instead of raw HTML. This change introduces a new slider component for adjusting playback speed, supports internationalization (i18n) for the plugin name, description, and UI labels, and improves the menu detection logic to ensure the slider is correctly inserted into the player menu. The plugin now uses a MutationObserver to handle dynamic menu changes and ensures the playback rate is updated when the video element's rate changes.
src/plugins/playback-speed · high confidence
Plugin loader refactored into distinct lifecycle modules
The plugin loading logic in src/loader has been restructured into four separate modules (main.ts, menu.ts, preload.ts, renderer.ts) to handle specific plugin types and contexts. This change introduces distinct lifecycle management for backend, menu, preload, and renderer plugins, including dedicated functions for force-loading and force-unloading each type. The refactoring also updates the context creation for each plugin type to use specific interfaces (BackendContext, MenuContext, PreloadContext, RendererContext) and improves error handling and logging for plugin initialization and unloading failures.
src/loader · high confidence
Precise Volume plugin migrated to new plugin API with enhanced volume controls
The Precise Volume plugin has been rewritten to use the new plugin architecture, introducing a configuration menu for custom volume step sizes, local arrow key shortcuts, and global system shortcuts. The plugin now persists the last used volume level across sessions and provides a visual volume HUD overlay that adjusts its position based on the video player state. It also enables volume control via mouse wheel on both the player bar and the video element itself.
src/plugins/precise-volume · high confidence
Restructured configuration system with new defaults and migration logic
The application's configuration has been reorganized into a new modular structure under src/config, introducing a centralized defaults file (defaults.ts) that defines the schema for window settings, user options, and plugins. This change includes a new plugin configuration module (plugins.ts) for managing plugin states and options, and a store module (store.ts) that implements version-specific migrations to handle legacy settings. Notable migrations include renaming 'plugins.discord.listenAlong' to 'plugins.discord.playOnYouTubeMusic', migrating 'plugins.lastfm' data into the new 'plugins.scrobbler' structure, and removing deprecated plugins like 'plugins.visualizer' and 'plugins.picture-in-picture'.
src/config · high confidence
Scrobbler services now support alternative song titles and artists
The scrobbler plugin (Last.fm and Listenbrainz) now respects user-configured alternative titles and artists when sending playback data. If the 'alternativeTitles' and 'alternativeArtist' options are enabled and alternative metadata is available, the service will use those values instead of the default track title and artist name, improving compatibility with services that expect specific naming conventions.
src/plugins/scrobbler/services · high confidence
Skip Silences plugin now uses configurable audio analysis thresholds
The Skip Silences plugin has been rewritten to use a configurable audio analysis engine. Users can now control the silence detection sensitivity via the \threshold\ (set to -100 dB by default) and \smoothing\ parameters, and the plugin supports an \onlySkipBeginning\ configuration option to restrict skipping to the start of media. The implementation listens for audio playback events and automatically seeks forward when silence is detected, with the ability to restart the plugin if configuration changes require it.
src/plugins/skip-silences · high confidence
Synced Lyrics plugin rewritten in SolidJS with new UI components
The Synced Lyrics plugin's renderer has been migrated from raw HTML to JSX using the SolidJS framework, introducing a suite of new components including ErrorDisplay, LoadingKaomoji, NotFoundKaomoji, LyricsPicker, SyncedLine, and PlainLyrics. This rewrite enables improved user experience features such as animated loading indicators, better error handling with retry options, and a provider picker that allows users to select or star preferred lyrics sources. The new implementation also supports romanization display for lyrics and integrates with the Material Design UI components for a more consistent look.
src/plugins/synced-lyrics/renderer/components · high confidence
Synced Lyrics renderer rewritten with Solid.js and virtual scrolling
The Synced Lyrics plugin renderer has been completely rewritten to use Solid.js for the UI, replacing the previous implementation. This change introduces virtual scrolling via the 'virtua' library to handle large lyric lists more efficiently, and adds a reactive owner setup to manage component lifecycles. The renderer now supports multiple lyric providers, caching search results, and includes built-in romanization for Chinese, Japanese, Korean, Thai, Hindi, and Bengali lyrics, along with simplified/traditional Chinese conversion. The UI also features configurable line effects (fancy, scale, offset, focus) and a lyrics picker that appears based on scroll position and mouse interaction.
src/plugins/synced-lyrics/renderer · high confidence
Taskbar media control plugin now adapts icon colors to system theme
The taskbar media control plugin on Windows now dynamically switches between black and white icon sets for the previous, play/pause, and next buttons based on the current system theme (light or dark). This ensures the media control buttons in the taskbar thumbnail remain visible and aesthetically consistent regardless of whether the user is in light or dark mode, replacing the previous static icon usage.
src/plugins/taskbar-mediacontrol · high confidence
Tuna OBS plugin now sends alternative titles, tags, and song URLs
The Tuna OBS plugin has been updated to include additional metadata in the data sent to OBS, specifically alternative titles, tags, and the song's URL. This enhancement allows for richer display information in OBS scenes. The plugin also implements a 'lite mode' to handle connection issues gracefully and ensures the TCP socket is kept alive for reuse.
src/plugins/tuna-obs · high confidence
Fixes
Apply patches to resolve dependency compatibility and runtime issues
This update applies several patches to third-party dependencies to fix build and runtime errors. The \kuromoji\ library is patched to support modern Node.js environments (including \setImmediate\ and \util.types\), prevent infinite loops in iterators, and filter out \\_\proto\\_\ keys for security. The \electron-is\ library is extended to detect FreeBSD. The \mdui\ library is patched to remove React-specific type definitions and declare \solid-js\ as a peer dependency, aligning it with the project's framework. Finally, the \@malept/flatpak-bundler\ patch improves error reporting by including command arguments and output in rejection messages.
patches · high confidence
Test coverage
Added Playwright test for app launch and visibility; Added tests for segment sorting logic.
Dependencies
Migrate build tooling from Rollup to Rolldown and ESLint to Oxlint
The project's build and linting infrastructure has been updated to use newer, faster tools. The Vite configuration now uses the \rolldownOptions\ field (replacing the deprecated \rollupOptions\) to leverage the Rolldown bundler, and the linting system has migrated from ESLint to Oxlint, with new \.oxlintrc.json\ and \.oxfmtrc.json\ configuration files defining the rules and formatting preferences. This change is part of a broader effort to improve build performance and code quality enforcement.
(repo-wide) · high confidence
Routine dependency updates across the project
This release includes routine updates to various dependencies, including TypeScript, Vite, Electron, and ESLint, to keep the project up to date with the latest versions and improvements.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 38 → 35 (-2.4)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 47 → 47 (+0.1)
- Architecture 59 → 59 (-0.5)
- Maturity 57 → 56 (-1.0)
- Readiness 26 → 21 (-5.1)
- Security 62 → 61 (-0.8)
- Accessibility 40 → 40 (+0.0)
- Performance 60 → 60 (+0.0)
Resolved (45)
- High CVE: [GHSA redacted] (pnpm-lock.yaml)
- High CVE: [GHSA redacted] (pnpm-lock.yaml)
- High CVE: [GHSA redacted] (pnpm-lock.yaml)
- High CVE: [GHSA redacted] (pnpm-lock.yaml)
- High CVE: [GHSA redacted] (pnpm-lock.yaml)
- High CVE: [GHSA redacted] (pnpm-lock.yaml)
- Medium CVE: [GHSA redacted] (pnpm-lock.yaml)
- Off-boarding risk: anonymized user #1
- Outdated (npm): @ffmpeg.wasm/core-mt
- Outdated (npm): @ffmpeg.wasm/main
- Outdated (npm): @floating-ui/dom
- Outdated (npm): @ghostery/adblocker-electron
- Outdated (npm): @ghostery/adblocker-electron-preload
- Outdated (npm): @hono/node-server
- Outdated (npm): @hono/zod-openapi
- Outdated (npm): @hono/zod-validator
- Outdated (npm): @jellybrick/dbus-next
- Outdated (npm): @jellybrick/mpris-service
- Outdated (npm): @mdui/icons
- Outdated (npm): @xhayper/discord-rpc
- …and 25 more
New (25)
- Dependency hygiene PARTLY measured — npm pinning read, dependency currency not (registry.npmjs.org unreachable)
- High CVE: [GHSA redacted] (pnpm-lock.yaml)
- High CVE: [GHSA redacted] (pnpm-lock.yaml)
- High CVE: [GHSA redacted] (pnpm-lock.yaml)
- High CVE: [GHSA redacted] (pnpm-lock.yaml)
- High CVE: [GHSA redacted] (package.json)
- High CVE: [GHSA redacted] (package.json)
- Medium CVE: [GHSA redacted] (package.json)
- Medium CVE: [GHSA redacted] (pnpm-lock.yaml)
- Off-boarding risk: anonymized user #1
- connectionID spells ID where 72 names in the project spell it Id (src/plugins/music-together/types.ts)
- getPlaylistID spells ID where 72 names in the project spell it Id (src/plugins/downloader/main/index.ts)
- doc comments repeat the names (src/plugins/crossfade/fader.ts)
- redundant comment (src/index.ts)
- redundant comment (src/plugins/crossfade/fader.ts)
- redundant comment (src/plugins/crossfade/fader.ts)
- redundant comment (src/plugins/notifications/interactive.ts)
- redundant comment (src/plugins/notifications/main.ts)
- redundant comment (src/plugins/precise-volume/renderer.ts)
- redundant comment (src/plugins/precise-volume/renderer.ts)
- …and 5 more
Changes since last survey
- 6 commits — 6 feature/other, 0 fixes
By area
- src/i18n — 6 commits
Notable commits
- change: chore(i18n): Translated using Weblate (Arabic)
- change: chore(i18n): Translated using Weblate (Czech)
- change: chore(i18n): Translated using Weblate (German)
- change: chore(i18n): Translated using Weblate (Italian)
- change: chore(i18n): Translated using Weblate (Lithuanian)
- change: chore(i18n): Translated using Weblate (Slovenian)
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
pear-devs/pear-desktop was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 7 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 3337446b448454125ad261099a25f6b10fbb8cb6 — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-110e4fee044f.