{"name":"Pear Desktop: An Electron-based Music Player Extension","description":"Pear Desktop is an open-source, Electron-based application designed to enhance your music player experience with a native look and feel. It offers cross-platform compatibility for Windows, macOS, and Linux, alongside extensive customization options through themes and a robust plugin system. This independent extension provides a dedicated desktop interface for your favorite music.","github":"https://github.com/th-ch/youtube-music","url":"https://osrepos.com/repo/th-ch-youtube-music","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/th-ch-youtube-music","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/th-ch-youtube-music.md","json":"https://osrepos.com/repo/th-ch-youtube-music.json","topics":["desktop-app","electron","music-player","typescript","cross-platform","plugins","themes","music-extension"],"keywords":["desktop-app","electron","music-player","typescript","cross-platform","plugins","themes","music-extension"],"stars":null,"summary":"Pear Desktop is an open-source, Electron-based application designed to enhance your music player experience with a native look and feel. It offers cross-platform compatibility for Windows, macOS, and Linux, alongside extensive customization options through themes and a robust plugin system. This independent extension provides a dedicated desktop interface for your favorite music.","content":"## Introduction\n\nPear Desktop is a powerful, open-source desktop application built with Electron and TypeScript, designed to act as an extension for music players. It provides a dedicated, native-looking interface for your music, offering a seamless experience across various operating systems. With its focus on customization and extensibility, Pear Desktop allows users to personalize their music listening environment through custom themes and a comprehensive plugin system. It supports Windows, macOS, and Linux, making it a versatile choice for music enthusiasts.\n\n## Installation\n\nPear Desktop offers straightforward installation methods across different platforms.\n\n### Arch Linux\n\nInstall the `pear-desktop` package from the AUR. For detailed AUR installation instructions, refer to the [Arch Wiki page](https://wiki.archlinux.org/index.php/Arch_User_Repository#Installing_packages).\n\n### macOS\n\nYou can install the app using Homebrew:\n\nbash\nbrew install pear-devs/pear/pear-desktop\n\n\nIf you install manually and encounter an \"is damaged and can’t be opened\" error, run the following command in your Terminal:\n\nbash\n/usr/bin/xattr -cr /Applications/Pear\\ Desktop.app\n\n\n### Windows\n\nFor Windows, you have several options:\n\n**Using Scoop Package Manager:**\n\nbash\nscoop bucket add extras\nscoop install extras/pear-desktop\n\n\n**Using Winget (Windows 11's official CLI package manager):**\n\nbash\nwinget install pear-devs.pear-desktop\n\n\n**Offline Installation (without a network connection):**\n\n1.  Download the `*.nsis.7z` file for your device architecture (x64, ia32, or arm64) from the [latest release page](https://github.com/pear-devs/pear-desktop/releases/latest).\n2.  Download the installer (`*-Setup.exe`) from the same release page.\n3.  Place both files in the **same directory**.\n4.  Run the installer.\n\n## Examples\n\nPear Desktop's strength lies in its customization capabilities, particularly through themes and plugins.\n\n### Custom Themes\n\nYou can load custom CSS files to change the application's appearance. Navigate to `Options > Visual Tweaks > Themes` within the application.\nExplore predefined themes at [kerichdev/themes-for-ytmdesktop-player](https://github.com/kerichdev/themes-for-ytmdesktop-player).\n\n### Building Your Own Plugins\n\nPear Desktop provides a robust plugin API, allowing you to manipulate the app, change the front-end HTML/CSS, and communicate between the front and back ends.\n\nTo create a plugin, start by creating a folder in `src/plugins/YOUR-PLUGIN-NAME` and an `index.ts` file:\n\ntypescript\nimport style from './style.css?inline'; // import style as inline\n\nimport { createPlugin } from '@/utils';\n\nexport default createPlugin({\n  name: 'Plugin Label',\n  restartNeeded: true, // if value is true, pear-desktop will show a restart dialog\n  config: {\n    enabled: false,\n  }, // your custom config\n  stylesheets: [style], // your custom style\n  renderer() {} // define renderer hook\n});\n\n\nThis example shows how to inject custom CSS. For more advanced interactions, including manipulating the `BrowserWindow` or communicating via IPC, refer to the official documentation and existing plugins in the repository.\n\n## Why Use Pear Desktop?\n\nPear Desktop offers several compelling reasons for music lovers:\n\n*   **Native Look & Feel:** Enjoy a desktop application that integrates seamlessly with your operating system's aesthetics.\n*   **Cross-Platform Compatibility:** Available on Windows, macOS, and Linux, ensuring a consistent experience regardless of your preferred OS.\n*   **Extensive Customization:** Personalize your music player with custom themes to match your style.\n*   **Powerful Plugin System:** Extend functionality and tailor the application to your specific needs by building or installing plugins.\n*   **Open Source:** Benefit from a community-driven project with transparent development and continuous improvements.\n\n## Links\n\n*   **GitHub Repository:** [https://github.com/pear-devs/pear-desktop](https://github.com/pear-devs/pear-desktop)\n*   **Latest Release:** [https://github.com/pear-devs/pear-desktop/releases/latest](https://github.com/pear-devs/pear-desktop/releases/latest)","metrics":{"detailViews":8,"githubClicks":8},"dates":{"published":null,"modified":"2026-02-02T20:01:16.000Z"}}