Skip to content

TwilightLemon/Lemon-App

Repository files navigation

Lemon App

Enjoy what you like

C# WPF Release GitHub Repo stars

🐱 Introduction

A delicate and modern music player for Windows that syncs your playlists from NetEase Cloud Music and QQ Music — with stunning UI and animated lyrics.

  • 🎵 Playlist Sync: Login to your QQ Music and NetEase Cloud Music account and sync your personal playlists (only content accessible by your own account).
  • 🌈 Modern UI Design: Built with fluent-style acrylic and Mica effects (only available on Windows 11). Fully supports light and dark mode.
  • 🪄 Animated Lyrics: Enjoy rich lyric effects with word-by-word highlights and smooth progress animations — inspired by Apple Music and Lyricify.
  • 🚧 Actively Developed: Currently in pre-release. Some pages are still under construction. Contributions are welcome!

📦 Installation

Download the lastest release here: Releases. Or build from source manually.

Requirements

  • .NET 8.0 SDK
  • ✅ WebView2 Runtime (for Windows 10 users, required for login)
  • ✅ Visual Studio 2022+ with WPF development tools
  • ✅ Windows 10+ (Windows 11 recommended)

Build Steps

git clone https://github.com/TwilightLemon/Lemon-App.git
cd Lemon-App
dotnet build

🎨 Usage

Login to QQ Music

Due to the resistance of source API, you need to login to your QQ Music account to access most of the features. So you need to login first, then bind your NetEase Cloud Music account to sync playlists if needed.

Start to Use

HomePage Playlist LyricPage-Dark LyricPage-Light

Storage Location

The application data is stored in the following directory:

  • User Data: %APPDATA%\LemonAppNew logs, settings, and cached data.
  • Resource Cache: VOL:\LemonApp where VOL is usually the second drive of your system. This folder contains cached resources like album covers, lyrics and media files etc.
  • Download Location: %USERPROFILE%\Music\Lemon App is the default download location.

More to Explore

  • Quick Access: Fix playlists, artists, albums, and rankings to the title bar for quick access.
  • Desktop Lyrics: Enable desktop lyrics to display lyrics on your desktop. Plus, embed lyrics in your desktop wallpaper(Experimental).
  • Download Music: Download music with high quality.
  • Custom Themes: Highly customizable themes. You can use system accent color or calculated color from album cover. Acrylic and Mica effects are supported.

📄 LICENSE

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.

Third-Party Libraries

This project uses the following third-party libraries. We acknowledge and thank all contributors of these amazing tools.

Library Description License
EleCho.WpfSuite WPF layout panels, controls, value converters, markup extensions, transitions and utilities MIT
Newtonsoft.Json JSON parsing library MIT
CommunityToolkit.Mvvm MVVM framework helpers MIT
Lyricify Lyrics Helper Syllable Lyric Parser Apache-2.0 license
BASS and Bass.NET Audio library for music playback non-commercial use
... ... ...

For each library, please refer to its own repository and license file for detailed terms.

Disclaimer

See full Disclaimer

🌐 Contributing

We welcome contributions to Lemon App! If you have ideas, bug reports, or feature requests, please open an issue or submit a pull request.

About

Online music player for Windows with stunning UI and animated lyrics

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages