# moekoemusic/moekoemusic

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/moekoemusic-moekoemusic).**

5,052 stars · 341 forks · Vue · gpl-2.0

## Links

- GitHub: https://github.com/MoeKoeMusic/MoeKoeMusic
- Homepage: https://Music.MoeKoe.cn
- awesome-repositories: https://awesome-repositories.com/repository/moekoemusic-moekoemusic.md

## Topics

`javascript` `kugou` `linux` `macos` `moekoe` `music` `vue3` `windows`

## Description

MoeKoeMusic is a cross-platform desktop music player that functions as a client for NetEase Cloud Music. It provides music streaming with synchronized lyrics display, theme customization, and a plugin system for extending functionality.

The application is built on Electron to run on Windows, macOS, and Linux. It features real-time WebSocket streaming of playback state and synchronized lyrics, a plugin system that loads external modules, and dynamic theme customization through CSS variables. Authentication with NetEase Cloud Music accounts supports login via QR code, phone, or password, along with automatic claiming of daily VIP benefits. Remote control via WebSocket and the ability to switch data sources or configure a custom backend endpoint further distinguish it from simpler players.

Standard features include playback controls with keyboard shortcuts, high-fidelity audio streaming, music search, playlist management, daily personalized recommendations, and synchronized lyrics display with copy-to-clipboard. The player also supports audio output device switching and automatically pauses when the system device changes.

## Tags

### Graphics & Multimedia

- [Cross-Platform Media Players](https://awesome-repositories.com/f/graphics-multimedia/cross-platform-media-players.md) — A cross-platform desktop music player that runs on Windows, macOS, and Linux with a consistent feature set.
- [NetEase Cloud Music Clients](https://awesome-repositories.com/f/graphics-multimedia/desktop-music-clients/netease-cloud-music-clients.md) — A desktop client for NetEase Cloud Music that provides high-fidelity streaming, plugin extensibility, and real-time lyrics via WebSocket.
- [High-Fidelity Audio Streaming](https://awesome-repositories.com/f/graphics-multimedia/audio-music/audio-playback/high-fidelity-audio-streaming.md) — Plays audio at high quality for an immersive listening experience without compression. ([source](https://music.moekoe.cn/about.html))
- [Music Discovery](https://awesome-repositories.com/f/graphics-multimedia/music-discovery.md) — Looks up songs and artists by keyword to find and play desired tracks. ([source](https://music.moekoe.cn/quick-start.html))
- [Lyric Synchronization](https://awesome-repositories.com/f/graphics-multimedia/playback-timing-control/lyric-synchronization.md) — An application that displays and streams synchronized song lyrics in real time alongside audio playback via WebSocket.
- [WebSocket Lyric Streaming](https://awesome-repositories.com/f/graphics-multimedia/playback-timing-control/lyric-synchronization/websocket-lyric-streaming.md) — Streams playback status updates and synchronized lyrics to the application in real time via WebSocket. ([source](https://music.moekoe.cn/websocket-api.html))
- [Synchronized Lyric Displays](https://awesome-repositories.com/f/graphics-multimedia/synchronized-lyric-displays.md) — Displays synchronized lyrics for the currently playing track in the player interface. ([source](https://music.moekoe.cn/quick-start.html))
- [WebSocket Music Controllers](https://awesome-repositories.com/f/graphics-multimedia/websocket-music-controllers.md) — Provides a WebSocket interface so external applications can send commands to control the application or extend its behavior. ([source](https://music.moekoe.cn/development.html))

### Operating Systems & Systems Programming

- [Chromium-Based Desktop Shells](https://awesome-repositories.com/f/operating-systems-systems-programming/desktop-environment-frameworks/desktop-environment-components/desktop-application-frameworks/chromium-based-desktop-shells.md) — Uses the Electron framework to package a web application as a native desktop shell for Windows, macOS, and Linux.
- [Platform Support](https://awesome-repositories.com/f/operating-systems-systems-programming/platform-development-integration/platform-support.md) — Runs seamlessly on Windows, macOS, and Linux with a consistent feature set and user experience. ([source](https://music.moekoe.cn/about.html))

### Part of an Awesome List

- [Desktop](https://awesome-repositories.com/f/awesome-lists/media/music-players/desktop.md) — A desktop music player with support for theme switching, accent colors, custom fonts, and keyboard shortcuts.
- [Music Streaming and Management](https://awesome-repositories.com/f/awesome-lists/media/music-streaming-and-management.md) — Streams songs from remote sources with synchronized lyrics, playlists, and playback controls on desktop.

### Development Tools & Productivity

- [Plugin & Integration Systems](https://awesome-repositories.com/f/development-tools-productivity/plugin-integration-systems.md) — Provides a plugin system that loads external modules to extend core functionality without modifying the application. ([source](https://cdn.jsdelivr.net/gh/moekoemusic/moekoemusic@main/README.md))
- [Extensible Media Players](https://awesome-repositories.com/f/development-tools-productivity/extensible-media-players.md) — A music player that can be expanded with plugins to add new features and integrations without modifying core code.

### Networking & Communication

- [Third-Party Music Service Authentication](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-automation/account-authentication-gateways/account-authentication/third-party-music-service-authentication.md) — Authenticates with third-party music services via standard OAuth flows to synchronize playlists and user data.
- [Account Authentication](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-automation/account-authentication-gateways/account-authentication.md) — Authenticates with an online music account to sync playlists and favorites across devices. ([source](https://music.moekoe.cn/quick-start.html))

### User Interface & Experience

- [Playback Controls](https://awesome-repositories.com/f/user-interface-experience/playback-controllers/playback-automation/playback-controls.md) — Manages playback actions such as play, pause, skip, and volume from a persistent control bar. ([source](https://music.moekoe.cn/quick-start.html))
- [Dynamic CSS Variable Theme Engines](https://awesome-repositories.com/f/user-interface-experience/font-configurations/font-configurators/dynamic-css-variable-theme-engines.md) — Applies theme and font changes by dynamically swapping CSS variables and loading web fonts in real time.
- [Visual Themes](https://awesome-repositories.com/f/user-interface-experience/visual-theme-configurations/visual-themes.md) — Enables users to toggle between light and dark modes, select accent colors, and personalize the interface layout. ([source](https://music.moekoe.cn/quick-start.html))
- [Theme Customization](https://awesome-repositories.com/f/user-interface-experience/visual-theme-configurations/visual-themes/theme-customization.md) — Enables users to customize the visual theme with light/dark modes, accent colors, and custom fonts.

### Web Development

- [Playback State and Lyrics WebSocket Streams](https://awesome-repositories.com/f/web-development/websocket-integrations/real-time-sync-engines/playback-state-and-lyrics-websocket-streams.md) — Streams playback state and synchronized lyrics to connected clients over persistent WebSocket connections.

### Data & Databases

- [Music Service Switching](https://awesome-repositories.com/f/data-databases/data-sources/music-service-switching.md) — Ships a feature to switch between official and concept music data sources within the player. ([source](https://music.moekoe.cn/guide/data-source.html))
- [User Playlist Managers](https://awesome-repositories.com/f/data-databases/user-data-management/user-playlist-managers.md) — Allows users to create, organize, and manage custom playlists and save favorite songs for quick retrieval. ([source](https://music.moekoe.cn/quick-start.html))

### Programming Languages & Runtimes

- [Runtime Plugin Module Injectors](https://awesome-repositories.com/f/programming-languages-runtimes/dynamic-module-loaders/runtime-plugin-module-injectors.md) — Loads external JavaScript modules at runtime to inject new features without modifying the core application.

### Security & Cryptography

- [Daily VIP Benefit Claim Automation](https://awesome-repositories.com/f/security-cryptography/account-management/vip/daily-vip-benefit-claim-automation.md) — Authenticates with an account using QR code, phone, or password and automatically claims daily VIP benefits. ([source](https://cdn.jsdelivr.net/gh/moekoemusic/moekoemusic@main/README.md))

### Software Engineering & Architecture

- [Plugin Extenders](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/extensibility/plugin-architectures/developer-authoring-interfaces/custom-module-implementations/module-functionality-extenders/plugin-extenders.md) — Loads external JavaScript modules at runtime to inject new features without modifying the core application.
