Files
BetterLyrics/README.md
2025-06-19 22:24:38 -04:00

5.6 KiB
Raw Blame History

BetterLyrics

Your smooth dynamic local lyrics display built with WinUI 3

Highlighted features

  • Dynamic blur album art as background
  • Smooth lyrics fade in/out, zoom in/out effects
  • Smooth user interface change from song to song
  • Gradient Karaoke effect on every single character
  • Immersive desktop lyrics

This project is still under development now, bugs and unexpected behaviors may be existed in the latest dev branch.

Customize in your way

We provide more than one setting item to better align with your preference

  • Theme (light, dark, follow system)

  • Backdrop (none, mica, acrylic, transparent)

  • Album art as background (dynamic, blur amount, opacity)

  • Lyrics (alignment, font size, font color (picked from album art accent color) line spacing, opacity, blur amount, dynamic glow effect)

  • Language (English, Simplified Chinese, Traditional Chinese)

Screenshots

alt text

alt text

alt text

alt text

alt text

alt text

alt text

alt text

alt text

Demonstration

Watch our introduction video「BetterLyrics 阶段性开发成果展示」(uploaded on 31 May 2025) on Bilibili here.

Try it now

Stable version

Easiest way to get it. Unlimited free trail or purchase (there is no difference between free and paid version, if you like you can purchase to support me)

Or alternatively get it from Google Drive (see release page for the link)

Please note you are downloading ".zip" file, for guide on how to install it, please kindly follow this doc.

Latest dev version

You can git clone this project and build it yourself.

Setup your app

This project relies on listening messages from SMTC. So technically, as long as you are using the music apps (like

  • Spotify
  • Groove Music
  • Apple Music
  • Windows Media Player
  • VLC Media Player
  • QQ 音乐
  • 酷狗音乐
  • 酷我音乐

) which support SMTC, then possibly (I didn't test all of themif you find one fail to listen to, you can open an issue) all you need to do is just load your local music/lyrics lib and you are good to go.

Future work

  • Watching file changes When you downloading lyrics (using some other tools or your own scripts) while listening to new musics (non-existed on your local disks), this app can automatically load those new files.

Please note: we are not planning support directly load lyrics files via some music software APIs due to copyright issues.

Many thanks to

Inspired by

Third-party libraries that this project uses

CommunityToolkit.Labs.WinUI.MarqueeText
CommunityToolkit.Labs.WinUI.OpacityMaskView
CommunityToolkit.Mvvm
CommunityToolkit.WinUI.Behaviors
CommunityToolkit.WinUI.Controls.Primitives
CommunityToolkit.WinUI.Controls.Segmented
CommunityToolkit.WinUI.Controls.SettingsControls
CommunityToolkit.WinUI.Converters
CommunityToolkit.WinUI.Extensions
CommunityToolkit.WinUI.Helpers
CommunityToolkit.WinUI.Media
Microsoft.Extensions.DependencyInjection
Microsoft.Extensions.Logging
Microsoft.Graphics.Win2D
Microsoft.Windows.SDK.BuildTools
Microsoft.WindowsAppSDK
Microsoft.Xaml.Behaviors.WinUI.Managed
Newtonsoft.Json
Serilog.Extensions.Logging
Serilog.Sinks.File
sqlite-net-pcl
System.Drawing.Common
System.Text.Encoding.CodePages
Ude.NetStandard
WinUIEx
z440.atl.core

Star History

Star History Chart

Any issues and PRs are welcomed

If you find a bug please file it in issues or if you have any ideas feel free to share it here.