Hysen Labs
Open-source project
Zencok/BakaMusic avatar
Zencok

BakaMusic

一个插件化、定制化、无广告的免费音乐播放器

127 stars5 forksTypeScriptAGPL-3.0
DEEP OPEN-SOURCE ANALYSIS

A plugin based ad free music player for the desktop

BakaMusic is a cross platform desktop music player built with Electron, React, and TypeScript that plays local media and connects to content services through user installed plugins.

Playback and format support

BakaMusic uses a unified native playback core where audio and music videos are both rendered by libmpv plus LibreMPEG. This gives wide compatibility with local music and video formats and also supports remote HTTP, HLS, custom request headers, and multiple quality levels. The player reports support for spatial audio such as Dolby Atmos and surround media like AC-4 and AC-3, as well as Dolby Vision and HDR10 music video recognition and native rendering. On Windows, macOS, and Linux the app can play music videos with quality switching, speed control, fullscreen, and download, while playback state syncs to Windows SMTC, macOS MediaPlayer, and Linux MPRIS2.

Plugin and theme ecosystem

The application deliberately ships without any built in online source. Instead it relies on a dual plugin ecosystem: full BakaMusic plugins and imported LX source scripts that act as playback interfaces. Plugins can extend search, playlists, charts, lyrics, audio quality, music videos, sharing, and song recognition. Plugins run in an isolated controlled process where network, storage, and media access are managed by the app boundary. Theming uses V2 theme packs built from a config file, an index stylesheet, and optional image or iframe resources, with a default theme that follows the system light or dark setting.

Lyrics and local library

Lyrics are a first class feature with support for TTML, LRC, YRC, QRC, and ESLRC formats, including word by word display, translations, romanization, Ruby annotations, background vocals, duet mode, desktop lyrics, and a mini mode. The local library offers media scanning with album, artist, and folder browsing, resumable batch downloads, tag and cover writing, lyric saving, and optional post download transcoding. Personalization covers glass and flat interfaces, auto following light or dark themes, playlist and listening statistics, WebDAV backups, and three interface languages: Simplified Chinese, Traditional Chinese, and English.

Editorial conclusion

BakaMusic is distributed under the AGPL-3.0-only license and publishes installers for Windows, macOS, and Linux that already bundle the libmpv runtime so no separate player is needed.

DEEP OPEN-SOURCE ANALYSIS

Official sources

Community notes

Community notes