A simple music player, focused on audio pipeline, lyric, and Windows experience.
相比于其他播放器功能缺的太多，要品鉴的慎用
- Frontend: WPF / C#
- Backend: C++ 20 / CLI
- Native Libraries: FFmpeg, FAudio, OpenSSL, RapidJSON, cpp-base64, kissfft, uchardet, libiconv, NCNN, doctest(for native unittest)
- Framework: .NET 10.0 (Long Term Support)
- Minimum Supported Windows Version: Windows 10 2004 (build 10.0.19041.0)
- Target Windows Version: Windows 11 24H2 (build 10.0.26100.0)
- Configurable audio output sample rate, from 8kHz (telephone quality) to 192kHz (Hi-Res audio) (only in FAudio shared mode)
- Exclusive audio output and bit-perfect decode-play pipeline (only in WASAPI exclusive mode)
- Play/pause/stop
- Seek bar
- Volume control
- Full ML-based Lrc Parser, GPU-accelerated with high accuracy (support translation, JPN romanization detection)
- LRC encoding sniffing based on uchardet & libiconv
- Extended Lyric display (support ESLyric with karaoke effect)
- Portrait mode & Animated switch
- NCM file decrypt & play
- Windows System Media Transport Controls (SMTC) support
- 10-band equalizer support
- FFT Execution and spectrum analyzer support
- Playing times record & display
- Playlist support (.wppl format, in standard JSON)
- Lyric Intermediate JSON format, fully editor-compatible and high accuracy
- ARM64 Native solutions & executable
Still work in progress. 3rd party libraries are managed by vcpkg.
- UI Refractor (UI, from @Baicaiye)
- Online 3rd Party Music Streaming API Support
- Hi-Fi DSD format support, Compact Disc/HDCD Support, Stricter Bit-Perfect judgement
- Localization Support (this requires WPLRC v3 schema)
- Music Library management, M3U8 playlist import/export, CUE track split
- Lyric search API support, Lyric editor integration, WPLRC edit and LRC import/export
- You can submit your ideas in issues, or contact me directly by email.
- 去你妈的跨平台谁爱做谁做。这个项目就是个人偏执的产物，不爱用就滚去用其他播放器。
You can download the latest build from Github CI/CD, but if you want to build by yourself, follow the instruction below.
- Clone the repository
- Install vcpkg and integrate it with Visual Studio 2026
- You need the following workloads:
Desktop development with C++
Desktop development with .NET
- Execute
vcpkg integrate installin the Developer Powershell
- Open the solution file
WpfMusicPlayer.slnxin Visual Studio
- If you are using Qualcomm 8cx series or X Elite Series CPU, Select the
WpfMusicPlayer.ARM64.slnxsolution file
- Build the solution.
- The build system will automatically download and build the required dependencies using vcpkg.
- FFmpeg may fail to build under non‑English locales.
- You can switch your Visual Studio language to en_US and try rebuilding of this solution.
- On Windows 10, FFmpeg build threads may be scheduled only to E‑cores, causing extremely slow builds.
- Execute the following command:
powercfg -attributes SUB_PROCESSOR 7f2f5cfa-f10c-4823-b5e1-e93ae85f46b5 -ATTRIB_HIDE
powercfg -attributes SUB_PROCESSOR 93b8b6dc-0698-4d1c-9ee4-0644e900c85d -ATTRIB_HIDE
powercfg -attributes SUB_PROCESSOR bae08b81-2d5e-4688-ad6a-13243356654b -ATTRIB_HIDE- the enable the following config inside your control panel's Power Options:
Heterogeneous policy in effect->Use heterogeneous policy 0
Heterogeneous thread scheduling policy->Prefer performant processors
Heterogeneous short running thread scheduling policy->Prefer performant processors
- Copy the built DLLs from x64(ARM64)/Debug(Release) to the same folder as the built executable.
- Now you can launch the main executable.
- Notice: if your audio output sample rate is configured below 44100 Hz, some equalizer band will be disabled, preventing the introduction of high-frequency noise.
- This behavior complies with the Nyquist-Shannon sampling theorem.
- Write a clear issue
- Fork the repository, create your new fix/feature, then PR
您可以通过 GitCode 镜像 访问本项目。
- 看得见这个的应该不需要这条吧？要不下次删了
- See: WPLRC.scheme.md.
- Or you can use the online version: English, 简体中文
- WPLRC v3 work in progress.
- File path:
WpfMusicPlayer/Assets/ApplicationIcon.ico - See: LICENSE.icon.txt
- File Path:
WpfMusicPlayer/lyric_lang_vocab.bin - File Path:
WpfMusicPlayer/lyric_lang_mlp.ncnn.bin - File Path:
WpfMusicPlayer/lyric_lang_mlp.ncnn.param - File Path:
WpfMusicPlayer/song_structure_mlp.ncnn.bin - File Path:
WpfMusicPlayer/song_structure_mlp.ncnn.param - See: README.modelweights.md
If you require:
- higher recognition accuracy,
- a smaller model, or
- a model trained on your own dataset,
- convert the old dlib
.datmodel weight into ncnn format,
you can retrain the network using the scripts provided in the following repository:
- This software is provided under:
SPDX-License-Identifier: MIT
- This project includes third-party components. Their licenses are listed in LICENSE.thirdparty.txt.
FFmpeg can be built under LGPL or GPL, depending on the configuration.
- If you link FFmpeg in LGPL mode, you may distribute the application under MIT without additional requirements.
- If you link FFmpeg in GPL mode, the entire application becomes GPL‑compatible, and you must distribute the full source code of this project together with the executable.
Make sure you understand the implications before distributing a GPL‑linked build.
Distributing a GPL‑linked build does not change the license of this repository.
The upstream source code remains under the MIT License, and contributors may continue to use, modify, and distribute it under MIT.
Only the specific binary distribution that links against GPL‑configured FFmpeg is subject to GPL requirements.
这一坨东西不可能静态链接，所以没有加这个的必要，当然你闲的太无聊真搞出了静态链接的版本，那记得把obj文件公开一下
- Email: lucas150670@petalmail.com
Thanks to all the contributors of this project:
- Zopiclone, code
- steve84966, code
- 白菜叶, UI/UX and logo art
- 大川爱麒麟, smoke test
- 国家超算互联网中心 for cheap AI credit
- Kimi K3 & Kimi Code
- 以上排名不分先后