Merge pull request #19 from jayfunc/dev

github actions

.github/workflows/pages.yml

@@ -0,0 +1,69 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+# Sample workflow for building and deploying a Jekyll site to GitHub Pages
+name: Deploy Jekyll site to Pages
+
+on:
+  push:
+    branches: ["dev", "stable"]
+    paths:
+      - "docs/**"
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow one concurrent deployment
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: docs
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+          cache-version: 0
+          working-directory: "${{ github.workspace }}/docs"
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v5
+      - name: Build with Jekyll
+        # Outputs to the './_site' directory by default
+        run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
+        env:
+          JEKYLL_ENV: production
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_site/
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/releases-to-discord.yml

@@ -0,0 +1,20 @@
+on:
+  release:
+    types: [published, edited]
+
+jobs:
+  github-releases-to-discord:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+      - name: GitHub Releases to Discord
+        uses: SethCohen/github-releases-to-discord@v1
+        with:
+          webhook_url: ${{ secrets.WEBHOOK_URL }}
+          color: "2105893"
+          username: "Release Changelog"
+          avatar_url: "https://cdn.discordapp.com/avatars/487431320314576937/bd64361e4ba6313d561d54e78c9e7171.png"
+          content: "||@everyone||"
+          footer_title: "Changelog"
+          reduce_headings: true

BetterLyrics.WinUI3/BetterLyrics.WinUI3 (Package)/Package.appxmanifest

@@ -5,50 +5,62 @@
   xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
   xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
   xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
+  xmlns:uap5="http://schemas.microsoft.com/appx/manifest/uap/windows10/5"
   xmlns:uap18="http://schemas.microsoft.com/appx/manifest/uap/windows10/18"
   IgnorableNamespaces="uap rescap uap18">
 
-  <Identity
-    Name="37412.BetterLyrics"
-    Publisher="CN=Zhe"
-    Version="1.0.4.0" />
+	<Identity
+	  Name="37412.BetterLyrics"
+	  Publisher="CN=E1428B0E-DC1D-4EA4-ACB1-4556569D5BA9"
+	  Version="1.0.11.0" />
 
-  <mp:PhoneIdentity PhoneProductId="ca4a4830-fc19-40d9-b823-53e2bff3d816" PhonePublisherId="00000000-0000-0000-0000-000000000000"/>
+	<mp:PhoneIdentity PhoneProductId="ca4a4830-fc19-40d9-b823-53e2bff3d816" PhonePublisherId="00000000-0000-0000-0000-000000000000"/>
 
-  <Properties>
-    <DisplayName>BetterLyrics</DisplayName>
-    <PublisherDisplayName>founchoo</PublisherDisplayName>
-    <Logo>Images\StoreLogo.png</Logo>
-  </Properties>
+	<Properties>
+		<DisplayName>BetterLyrics</DisplayName>
+		<PublisherDisplayName>founchoo</PublisherDisplayName>
+		<Logo>Images\StoreLogo.png</Logo>
+	</Properties>
 
-  <Dependencies>
-    <TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.19041.0" MaxVersionTested="10.0.26100.0" />
-    <TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.19041.0" MaxVersionTested="10.0.26100.0" />
-  </Dependencies>
+	<Dependencies>
+		<TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.19041.0" MaxVersionTested="10.0.26100.0" />
+		<TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.19041.0" MaxVersionTested="10.0.26100.0" />
+	</Dependencies>
 
-  <Resources>
-	  <Resource Language="en-US"/>
-	  <Resource Language="zh-CN"/>
-	  <Resource Language="zh-TW"/>
-  </Resources>
+	<Resources>
+		<Resource Language="en-US"/>
+		<Resource Language="zh-CN"/>
+		<Resource Language="zh-TW"/>
+		<Resource Language="ja-JP"/>
+		<Resource Language="ko-KR"/>
+	</Resources>
 
-  <Applications>
-    <Application Id="App"
-      Executable="$targetnametoken$.exe"
-      EntryPoint="$targetentrypoint$">
-      <uap:VisualElements
-        DisplayName="BetterLyrics"
-        Description="BetterLyrics.WinUI3 (Package)"
-        BackgroundColor="transparent"
-        Square150x150Logo="Images\Square150x150Logo.png"
-        Square44x44Logo="Images\Square44x44Logo.png">
-        <uap:DefaultTile Wide310x150Logo="Images\Wide310x150Logo.png"  Square71x71Logo="Images\SmallTile.png" Square310x310Logo="Images\LargeTile.png"/>
-        <uap:SplashScreen Image="Images\SplashScreen.png" />
-      </uap:VisualElements>
-    </Application>
-  </Applications>
+	<Applications>
+		<Application Id="App"
+		  Executable="$targetnametoken$.exe"
+		  EntryPoint="$targetentrypoint$">
+			<uap:VisualElements
+			  DisplayName="BetterLyrics"
+			  Description="BetterLyrics.WinUI3 (Package)"
+			  BackgroundColor="transparent"
+			  Square150x150Logo="Images\Square150x150Logo.png"
+			  Square44x44Logo="Images\Square44x44Logo.png">
+				<uap:DefaultTile Wide310x150Logo="Images\Wide310x150Logo.png"  Square71x71Logo="Images\SmallTile.png" Square310x310Logo="Images\LargeTile.png"/>
+				<uap:SplashScreen Image="Images\SplashScreen.png" />
+			</uap:VisualElements>
+			<Extensions>
+				<uap5:Extension
+				  Category="windows.startupTask">
+					<uap5:StartupTask
+					  TaskId="AutoStartup"
+					  Enabled="false"
+					  DisplayName="BetterLyrics" />
+				</uap5:Extension>
+			</Extensions>
+		</Application>
+	</Applications>
 
-  <Capabilities>
-    <rescap:Capability Name="runFullTrust" />
-  </Capabilities>
+	<Capabilities>
+		<rescap:Capability Name="runFullTrust" />
+	</Capabilities>
 </Package>

BetterLyrics.WinUI3/BetterLyrics.WinUI3/App.xaml

@@ -45,13 +45,16 @@
             <converter:ColorToBrushConverter x:Key="ColorToBrushConverter" />
             <converter:MatchedLocalFilesPathToVisibilityConverter x:Key="MatchedLocalFilesPathToVisibilityConverter" />
             <converter:IntToCornerRadius x:Key="IntToCornerRadius" />
+            <converter:CornerRadiusToDoubleConverter x:Key="CornerRadiusToDoubleConverter" />
+            <converter:LyricsSearchProviderToDisplayNameConverter x:Key="LyricsSearchProviderToDisplayNameConverter" />
+            <converter:AlbumArtSearchProviderToDisplayNameConverter x:Key="AlbumArtSearchProviderToDisplayNameConverter" />
             <converters:BoolToVisibilityConverter x:Key="BoolToVisibilityConverter" />
             <converters:BoolNegationConverter x:Key="BoolNegationConverter" />
             <converters:ColorToDisplayNameConverter x:Key="ColorToDisplayNameConverter" />
 
             <x:Double x:Key="SettingsCardSpacing">4</x:Double>
 
-            <!--  Style (inc. the correct spacing) of a section header  -->
+            <!--  Style  -->
             <Style
                 x:Key="SettingsSectionHeaderTextBlockStyle"
                 BasedOn="{StaticResource BodyStrongTextBlockStyle}"
@@ -61,14 +64,16 @@
                 </Style.Setters>
             </Style>
             <Style x:Key="TitleBarButtonStyle" TargetType="Button">
-                <Setter Property="VerticalAlignment" Value="Stretch" />
+                <Setter Property="VerticalAlignment" Value="Top" />
                 <Setter Property="CornerRadius" Value="4" />
                 <Setter Property="BorderThickness" Value="0" />
-                <Setter Property="Padding" Value="16,0" />
+                <Setter Property="Padding" Value="16,9,16,11" />
+                <Setter Property="Margin" Value="0" />
                 <Setter Property="Background" Value="Transparent" />
             </Style>
             <Style x:Key="GhostButtonStyle" TargetType="Button">
                 <Setter Property="VerticalAlignment" Value="Stretch" />
+                <Setter Property="Padding" Value="8" />
                 <Setter Property="CornerRadius" Value="4" />
                 <Setter Property="BorderThickness" Value="0" />
                 <Setter Property="Background" Value="Transparent" />
@@ -84,11 +89,14 @@
                 <Setter Property="CornerRadius" Value="4" />
                 <Setter Property="VerticalAlignment" Value="Stretch" />
                 <Setter Property="BorderThickness" Value="0" />
+                <Setter Property="Padding" Value="8" />
                 <Setter Property="Background" Value="Transparent" />
             </Style>
 
             <!--  Dimensions  -->
 
+            <!--  Fonts  -->
+            <FontFamily x:Key="IconFontFamily">Segoe Fluent Icons, Segoe MDL2 Assets</FontFamily>
         </ResourceDictionary>
     </Application.Resources>
 </Application>

BetterLyrics.WinUI3/BetterLyrics.WinUI3/App.xaml.cs

@@ -1,10 +1,8 @@
-using System.Text;
-using BetterInAppLyrics.WinUI3.ViewModels;
+// 2025/6/23 by Zhe Fang
+
+using BetterLyrics.WinUI3.Enums;
 using BetterLyrics.WinUI3.Helper;
-using BetterLyrics.WinUI3.Rendering;
-using BetterLyrics.WinUI3.Services.Database;
-using BetterLyrics.WinUI3.Services.Playback;
-using BetterLyrics.WinUI3.Services.Settings;
+using BetterLyrics.WinUI3.Services;
 using BetterLyrics.WinUI3.ViewModels;
 using BetterLyrics.WinUI3.Views;
 using CommunityToolkit.Mvvm.DependencyInjection;
@@ -14,31 +12,27 @@ using Microsoft.UI.Dispatching;
 using Microsoft.UI.Xaml;
 using Microsoft.Windows.ApplicationModel.Resources;
 using Serilog;
-using WinUIEx;
-
-// To learn more about WinUI, the WinUI project structure,
-// and more about our project templates, see: http://aka.ms/winui-project-info.
+using ShadowViewer.Controls;
+using System;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
 
 namespace BetterLyrics.WinUI3
 {
-    /// <summary>
-    /// Provides application-specific behavior to supplement the default Application class.
-    /// </summary>
     public partial class App : Application
     {
+
         private readonly ILogger<App> _logger;
 
         public static new App Current => (App)Application.Current;
-
-        public static ResourceLoader? ResourceLoader { get; private set; }
-
         public static DispatcherQueue? DispatcherQueue { get; private set; }
         public static DispatcherQueueTimer? DispatcherQueueTimer { get; private set; }
+        public static ResourceLoader? ResourceLoader { get; private set; }
+
+        public NotificationPanel? LyricsWindowNotificationPanel { get; set; }
+        public NotificationPanel? SettingsWindowNotificationPanel { get; set; }
 
-        /// <summary>
-        /// Initializes the singleton application object.  This is the first line of authored code
-        /// executed, and as such is the logical equivalent of main() or WinMain().
-        /// </summary>
         public App()
         {
             this.InitializeComponent();
@@ -48,19 +42,31 @@ namespace BetterLyrics.WinUI3
             ResourceLoader = new ResourceLoader();
 
             Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);
-            Helper.AppInfo.EnsureDirectories();
+            PathHelper.EnsureDirectories();
             ConfigureServices();
 
-            _logger = Ioc.Default.GetService<ILogger<App>>()!;
+            _logger = Ioc.Default.GetRequiredService<ILogger<App>>();
 
             UnhandledException += App_UnhandledException;
+            AppDomain.CurrentDomain.UnhandledException += CurrentDomain_UnhandledException;
+            AppDomain.CurrentDomain.FirstChanceException += CurrentDomain_FirstChanceException;
+            TaskScheduler.UnobservedTaskException += TaskScheduler_UnobservedTaskException;
+        }
+
+        protected override void OnLaunched(LaunchActivatedEventArgs args)
+        {
+            WindowHelper.OpenOrShowWindow<LyricsWindow>();
+            var lyricsWindow = WindowHelper.GetWindowByWindowType<LyricsWindow>();
+            if (lyricsWindow == null) return;
+
+            lyricsWindow.AutoSelectLyricsMode();
         }
 
         private static void ConfigureServices()
         {
             Log.Logger = new LoggerConfiguration()
-                .MinimumLevel.Debug()
-                .WriteTo.File(Helper.AppInfo.LogFilePattern, rollingInterval: RollingInterval.Day)
+                .MinimumLevel.Is(Serilog.Events.LogEventLevel.Verbose)
+                .WriteTo.File(PathHelper.LogFilePattern, rollingInterval: RollingInterval.Day)
                 .CreateLogger();
 
             // Register services
@@ -73,34 +79,41 @@ namespace BetterLyrics.WinUI3
                     })
                     // Services
                     .AddSingleton<ISettingsService, SettingsService>()
-                    .AddSingleton<IDatabaseService, DatabaseService>()
                     .AddSingleton<IPlaybackService, PlaybackService>()
+                    .AddSingleton<IAlbumArtSearchService, AlbumArtSearchService>()
+                    .AddSingleton<ILyricsSearchService, LyricsSearchService>()
+                    .AddSingleton<ILibWatcherService, LibWatcherService>()
+                    .AddSingleton<ITranslateService, TranslateService>()
                     // ViewModels
-                    .AddTransient<HostWindowViewModel>()
-                    .AddSingleton<SettingsViewModel>()
+                    .AddSingleton<LyricsWindowViewModel>()
+                    .AddSingleton<SettingsWindowViewModel>()
+                    .AddSingleton<SystemTrayViewModel>()
+                    .AddSingleton<SettingsPageViewModel>()
                     .AddSingleton<LyricsPageViewModel>()
                     .AddSingleton<LyricsRendererViewModel>()
-                    .AddSingleton<LyricsSettingsControlViewModel>()
                     .BuildServiceProvider()
             );
         }
 
-        private void App_UnhandledException(
-            object sender,
-            Microsoft.UI.Xaml.UnhandledExceptionEventArgs e
-        )
+        private void App_UnhandledException(object sender, Microsoft.UI.Xaml.UnhandledExceptionEventArgs e)
         {
             _logger.LogError(e.Exception, "App_UnhandledException");
             e.Handled = true;
         }
 
-        /// <summary>
-        /// Invoked when the application is launched.
-        /// </summary>
-        /// <param name="args">Details about the launch request and process.</param>
-        protected override void OnLaunched(LaunchActivatedEventArgs args)
+        private void CurrentDomain_FirstChanceException(object? sender, System.Runtime.ExceptionServices.FirstChanceExceptionEventArgs e)
         {
-            WindowHelper.OpenLyricsWindow();
+            _logger.LogError(e.Exception, "CurrentDomain_FirstChanceException");
+        }
+
+        private void CurrentDomain_UnhandledException(object sender, System.UnhandledExceptionEventArgs e)
+        {
+            _logger.LogError(e.ExceptionObject.ToString(), "CurrentDomain_UnhandledException");
+        }
+
+        private void TaskScheduler_UnobservedTaskException(object? sender, UnobservedTaskExceptionEventArgs e)
+        {
+            _logger.LogError(e.Exception, "TaskScheduler_UnobservedTaskException");
         }
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/BetterLyrics.WinUI3.csproj

@@ -11,7 +11,17 @@
     <LangVersion>preview</LangVersion>
   </PropertyGroup>
   <ItemGroup>
-    <None Remove="Assets\CustomTransform.bin" />
+    <Compile Remove="ViewModels\Lyrics\**" />
+    <Content Remove="ViewModels\Lyrics\**" />
+    <EmbeddedResource Remove="ViewModels\Lyrics\**" />
+    <None Remove="ViewModels\Lyrics\**" />
+    <Page Remove="ViewModels\Lyrics\**" />
+    <PRIResource Remove="ViewModels\Lyrics\**" />
+  </ItemGroup>
+  <ItemGroup>
+    <None Remove="Assets\Core14.profile.xml" />
+    <None Remove="Controls\SystemTray.xaml" />
+    <None Remove="Views\SettingsWindow.xaml" />
   </ItemGroup>
   <ItemGroup>
     <Content Include="Logo.ico" />
@@ -31,27 +41,29 @@
     <PackageReference Include="CommunityToolkit.WinUI.Extensions" Version="8.2.250402" />
     <PackageReference Include="CommunityToolkit.WinUI.Helpers" Version="8.2.250402" />
     <PackageReference Include="CommunityToolkit.WinUI.Media" Version="8.2.250402" />
+    <PackageReference Include="Dubya.WindowsMediaController" Version="2.5.5" />
     <PackageReference Include="H.NotifyIcon.WinUI" Version="2.3.0" />
+    <PackageReference Include="Lyricify.Lyrics.Helper-NativeAot" Version="0.1.4-alpha.5" />
     <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="9.0.6" />
     <PackageReference Include="Microsoft.Extensions.Logging" Version="9.0.6" />
     <PackageReference Include="Microsoft.Graphics.Win2D" Version="1.3.2" />
     <PackageReference Include="Microsoft.Windows.SDK.BuildTools" Version="10.0.26100.4188" />
     <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.7.250606001" />
-    <PackageReference Include="Microsoft.Xaml.Behaviors.WinUI.Managed" Version="3.0.0" />
-    <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
+    <PackageReference Include="Nito.AsyncEx.Tasks" Version="5.1.2" />
+    <PackageReference Include="NTextCat" Version="0.3.65" />
     <PackageReference Include="Serilog.Extensions.Logging" Version="9.0.2" />
     <PackageReference Include="Serilog.Sinks.File" Version="7.0.0" />
-    <PackageReference Include="sqlite-net-pcl" Version="1.9.172" />
+    <PackageReference Include="ShadowViewer.Controls.Notification" Version="1.2.1" />
+    <PackageReference Include="SixLabors.ImageSharp" Version="3.1.10" />
     <PackageReference Include="System.Drawing.Common" Version="9.0.6" />
     <PackageReference Include="System.Text.Encoding.CodePages" Version="9.0.6" />
+    <PackageReference Include="TagLibSharp" Version="2.3.0" />
     <PackageReference Include="Ude.NetStandard" Version="1.2.0" />
-    <PackageReference Include="WinUIEx" Version="2.5.1" />
-    <PackageReference Include="z440.atl.core" Version="6.25.0" />
-  </ItemGroup>
-  <ItemGroup>
-    <Content Update="Assets\AI - 甜度爆表.mp3">
-      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
-    </Content>
+    <PackageReference Include="Vanara.PInvoke.Gdi32" Version="4.1.6" />
+    <PackageReference Include="Vanara.PInvoke.Shell32" Version="4.1.6" />
+    <PackageReference Include="Vanara.PInvoke.User32" Version="4.1.6" />
+    <PackageReference Include="WinUIEx" Version="2.6.0" />
+    <PackageReference Include="z440.atl.core" Version="7.0.0" />
   </ItemGroup>
   <ItemGroup>
     <Page Update="Rendering\InAppLyricsRenderer.xaml">
@@ -63,9 +75,19 @@
       <Generator>MSBuild:Compile</Generator>
     </Page>
   </ItemGroup>
+  <!--Disable Trimming for Specific Packages-->
   <ItemGroup>
-    <Folder Include="Controls\" />
-    <Folder Include="ViewModels\Lyrics\" />
+    <TrimmerRootAssembly Include="TagLibSharp" />
+  </ItemGroup>
+  <ItemGroup>
+    <Page Update="Views\SettingsWindow.xaml">
+      <Generator>MSBuild:Compile</Generator>
+    </Page>
+  </ItemGroup>
+  <ItemGroup>
+    <Page Update="Controls\SystemTray.xaml">
+      <Generator>MSBuild:Compile</Generator>
+    </Page>
   </ItemGroup>
   <!-- Publish Properties -->
   <PropertyGroup>

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/SystemTray.xaml

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<UserControl
+    x:Class="BetterLyrics.WinUI3.Controls.SystemTray"
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+    xmlns:local="using:BetterLyrics.WinUI3.Controls"
+    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+    xmlns:tb="using:H.NotifyIcon"
+    xmlns:ui="using:CommunityToolkit.WinUI"
+    mc:Ignorable="d">
+
+    <tb:TaskbarIcon
+        x:Name="TrayIcon"
+        x:FieldModifier="public"
+        ContextMenuMode="SecondWindow"
+        IconSource="ms-appx:///Assets/Logo.ico"
+        NoLeftClickDelay="True"
+        ToolTipText="{x:Bind ViewModel.ToolTipText, Mode=OneWay}">
+        <tb:TaskbarIcon.ContextFlyout>
+            <MenuFlyout
+                AreOpenCloseAnimationsEnabled="True"
+                LightDismissOverlayMode="On"
+                ShowMode="TransientWithDismissOnPointerMoveAway">
+                <MenuFlyoutItem x:Uid="SystemTraySettings" Command="{x:Bind ViewModel.OpenSettingsCommand}" />
+                <MenuFlyoutItem x:Uid="SystemTrayExit" Command="{x:Bind ViewModel.ExitAppCommand}" />
+                <MenuFlyoutItem
+                    x:Uid="SystemTrayUnlock"
+                    Command="{x:Bind ViewModel.UnlockWindowCommand}"
+                    Visibility="{x:Bind ViewModel.IsLyricsWindowLocked, Mode=OneWay, Converter={StaticResource BoolToVisibilityConverter}}" />
+            </MenuFlyout>
+        </tb:TaskbarIcon.ContextFlyout>
+    </tb:TaskbarIcon>
+</UserControl>

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/SystemTray.xaml.cs

@@ -0,0 +1,17 @@
+using BetterLyrics.WinUI3.ViewModels;
+using CommunityToolkit.Mvvm.DependencyInjection;
+using Microsoft.UI.Xaml.Controls;
+
+namespace BetterLyrics.WinUI3.Controls
+{
+    public sealed partial class SystemTray : UserControl
+    {
+        public SystemTrayViewModel ViewModel => (SystemTrayViewModel)DataContext;
+
+        public SystemTray()
+        {
+            InitializeComponent();
+            DataContext = Ioc.Default.GetService<SystemTrayViewModel>();
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Converter/AlbumArtSearchProviderToDisplayNameConverter.cs

@@ -0,0 +1,33 @@
+using BetterLyrics.WinUI3.Enums;
+using Microsoft.UI.Xaml.Data;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Converter
+{
+    public class AlbumArtSearchProviderToDisplayNameConverter : IValueConverter
+    {
+        public object Convert(object value, Type targetType, object parameter, string language)
+        {
+            if (value is AlbumArtSearchProvider provider)
+            {
+                return provider switch
+                {
+                    AlbumArtSearchProvider.Local => App.ResourceLoader!.GetString("AlbumArtSearchLocalProvider"),
+                    AlbumArtSearchProvider.SMTC => App.ResourceLoader!.GetString("AlbumArtSearchSMTCProvider"),
+                    AlbumArtSearchProvider.iTunes => "iTunes",
+                    _ => throw new Exception($"Unknown AlbumArtSearchProvider: {provider}"),
+                };
+            }
+            throw new ArgumentException("Value must be of type AlbumArtSearchProvider", nameof(value));
+        }
+
+        public object ConvertBack(object value, Type targetType, object parameter, string language)
+        {
+            throw new NotImplementedException();
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Converter/ColorToBrushConverter.cs

@@ -1,15 +1,13 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
+// 2025/6/23 by Zhe Fang
+
+using System;
 using Microsoft.UI.Xaml.Data;
 using Microsoft.UI.Xaml.Media;
 using Windows.UI;
 
 namespace BetterLyrics.WinUI3.Converter
 {
-    public class ColorToBrushConverter : IValueConverter
+    public partial class ColorToBrushConverter : IValueConverter
     {
         public object Convert(object value, Type targetType, object parameter, string language)
         {

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Converter/CornerRadiusToDoubleConverter.cs

@@ -0,0 +1,22 @@
+using System;
+using Microsoft.UI.Xaml.Data;
+
+namespace BetterLyrics.WinUI3.Converter
+{
+    internal partial class CornerRadiusToDoubleConverter : IValueConverter
+    {
+        public object Convert(object value, Type targetType, object parameter, string language)
+        {
+            if (value is Microsoft.UI.Xaml.CornerRadius cornerRadius)
+            {
+                return (double)cornerRadius.TopLeft;
+            }
+            return .0;
+        }
+
+        public object ConvertBack(object value, Type targetType, object parameter, string language)
+        {
+            throw new NotImplementedException();
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Converter/EnumToIntConverter.cs

@@ -1,14 +1,11 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-using Microsoft.UI.Xaml;
+// 2025/6/23 by Zhe Fang
+
+using System;
 using Microsoft.UI.Xaml.Data;
 
 namespace BetterLyrics.WinUI3.Converter
 {
-    internal class EnumToIntConverter : IValueConverter
+    internal partial class EnumToIntConverter : IValueConverter
     {
         public object Convert(object value, Type targetType, object parameter, string language)
         {

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Converter/IntToCornerRadius.cs

@@ -1,14 +1,11 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-using BetterLyrics.WinUI3.ViewModels;
+// 2025/6/23 by Zhe Fang
+
+using System;
 using Microsoft.UI.Xaml.Data;
 
 namespace BetterLyrics.WinUI3.Converter
 {
-    public class IntToCornerRadius : IValueConverter
+    public partial class IntToCornerRadius : IValueConverter
     {
         public object Convert(object value, Type targetType, object parameter, string language)
         {

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Converter/LyricsSearchProviderToDisplayNameConverter.cs

@@ -0,0 +1,37 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using BetterLyrics.WinUI3.Enums;
+using Microsoft.UI.Xaml.Data;
+
+namespace BetterLyrics.WinUI3.Converter
+{
+    public partial class LyricsSearchProviderToDisplayNameConverter : IValueConverter
+    {
+        public object Convert(object value, Type targetType, object parameter, string language)
+        {
+            if (value is LyricsSearchProvider provider)
+            {
+                return provider switch
+                {
+                    LyricsSearchProvider.LrcLib => App.ResourceLoader!.GetString("LyricsSearchProviderLrcLib"),
+                    LyricsSearchProvider.QQ => App.ResourceLoader!.GetString("LyricsSearchProviderQQ"),
+                    LyricsSearchProvider.Netease => App.ResourceLoader!.GetString("LyricsSearchProviderNetease"),
+                    LyricsSearchProvider.Kugou => App.ResourceLoader!.GetString("LyricsSearchProviderKugou"),
+                    LyricsSearchProvider.AmllTtmlDb => App.ResourceLoader!.GetString("LyricsSearchProviderAmllTtmlDb"),
+                    LyricsSearchProvider.LocalLrcFile => App.ResourceLoader!.GetString("LyricsSearchProviderLocalLrcFile"),
+                    LyricsSearchProvider.LocalMusicFile => App.ResourceLoader!.GetString("LyricsSearchProviderLocalMusicFile"),
+                    LyricsSearchProvider.LocalEslrcFile => App.ResourceLoader!.GetString("LyricsSearchProviderEslrcFile"),
+                    LyricsSearchProvider.LocalTtmlFile => App.ResourceLoader!.GetString("LyricsSearchProviderTtmlFile"),
+                    _ => "",
+                };
+            }
+            return "";
+        }
+
+        public object ConvertBack(object value, Type targetType, object parameter, string language)
+        {
+            throw new NotImplementedException();
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Converter/MatchedLocalFilesPathToVisibilityConverter.cs

@@ -1,10 +1,12 @@
-using System;
+// 2025/6/23 by Zhe Fang
+
+using System;
 using Microsoft.UI.Xaml;
 using Microsoft.UI.Xaml.Data;
 
 namespace BetterLyrics.WinUI3.Converter
 {
-    public class MatchedLocalFilesPathToVisibilityConverter : IValueConverter
+    public partial class MatchedLocalFilesPathToVisibilityConverter : IValueConverter
     {
         public object Convert(object value, Type targetType, object parameter, string language)
         {

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/AlbumArtSearchProvider.cs

@@ -6,10 +6,10 @@ using System.Threading.Tasks;
 
 namespace BetterLyrics.WinUI3.Enums
 {
-    public enum LyricsAlignmentType
+    public enum AlbumArtSearchProvider
     {
-        Left,
-        Center,
-        Right,
+        Local,
+        SMTC,
+        iTunes,
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/AutoStartWindowType.cs

@@ -1,8 +1,4 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
+// 2025/6/23 by Zhe Fang
 
 namespace BetterLyrics.WinUI3.Enums
 {
@@ -10,5 +6,6 @@ namespace BetterLyrics.WinUI3.Enums
     {
         StandardMode,
         DockMode,
+        DesktopMode,
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/BackdropType.cs

@@ -1,8 +1,4 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
+// 2025/6/23 by Zhe Fang
 
 namespace BetterLyrics.WinUI3.Enums
 {

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/EasingType.cs

@@ -0,0 +1,20 @@
+// 2025/6/23 by Zhe Fang
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    public enum EasingType
+    {
+        Linear,
+        SmoothStep,
+        EaseInOutSine,
+        EaseInOutQuad,
+        EaseInOutCubic,
+        EaseInOutQuart,
+        EaseInOutQuint,
+        EaseInOutExpo,
+        EaseInOutCirc,
+        EaseInOutBack,
+        EaseInOutElastic,
+        EaseInOutBounce,
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/Language.cs

@@ -1,4 +1,6 @@
-using System;
+// 2025/6/23 by Zhe Fang
+
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Text;
@@ -12,5 +14,7 @@ namespace BetterLyrics.WinUI3.Enums
         English,
         SimplifiedChinese,
         TraditionalChinese,
+        Japanese,
+        Korean,
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LineMaskType.cs

@@ -6,9 +6,9 @@ using System.Threading.Tasks;
 
 namespace BetterLyrics.WinUI3.Enums
 {
-    public enum LyricsType
+    public enum LineMaskType
     {
-        InAppLyrics,
-        DesktopLyrics,
+        Glow,
+        Highlight,
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LineRenderingType.cs

@@ -0,0 +1,11 @@
+// 2025/6/23 by Zhe Fang
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    public enum LineRenderingType
+    {
+        CurrentChar,
+        LineStartToCurrentChar,
+        CurrentLine
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LocalSearchTargetProps.cs

@@ -0,0 +1,10 @@
+// 2025/6/23 by Zhe Fang
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    public enum LocalSearchTargetProps
+    {
+        LyricsOnly,
+        LyricsAndAlbumArt,
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsDisplayType.cs

@@ -1,4 +1,6 @@
-namespace BetterLyrics.WinUI3.Enums
+// 2025/6/23 by Zhe Fang
+
+namespace BetterLyrics.WinUI3.Enums
 {
     public enum LyricsDisplayType
     {

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsFontColorType.cs

@@ -1,14 +1,11 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
+// 2025/6/23 by Zhe Fang
 
 namespace BetterLyrics.WinUI3.Enums
 {
     public enum LyricsFontColorType
     {
-        Default,
-        Dominant,
+        AdaptiveColored,
+        AdaptiveGrayed,
+        Custom,
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsFontWeight.cs

@@ -1,8 +1,6 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
+// 2025/6/23 by Zhe Fang
+
+using System;
 using Microsoft.UI.Text;
 using Windows.UI.Text;
 
@@ -40,11 +38,7 @@ namespace BetterLyrics.WinUI3.Enums
                 LyricsFontWeight.ExtraBold => FontWeights.ExtraBold,
                 LyricsFontWeight.Black => FontWeights.Black,
                 LyricsFontWeight.ExtraBlack => FontWeights.ExtraBlack,
-                LyricsFontWeight _ => throw new ArgumentOutOfRangeException(
-                    nameof(weight),
-                    weight,
-                    null
-                ),
+                LyricsFontWeight _ => throw new ArgumentOutOfRangeException(nameof(weight), weight, null),
             };
         }
     }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsFormat.cs

@@ -0,0 +1,71 @@
+// 2025/6/23 by Zhe Fang
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    public enum LyricsFormat
+    {
+        Lrc,
+        Eslrc,
+        Ttml,
+        Qrc,
+        Krc,
+        NotSpecified,
+    }
+
+    public static class LyricsFormatExtensions
+    {
+        public static LyricsFormat? DetectFormat(this string content)
+        {
+            if (string.IsNullOrWhiteSpace(content))
+                return null;
+
+            // TTML: 检查 <tt ... xmlns="http://www.w3.org/ns/ttml"
+            if (System.Text.RegularExpressions.Regex.IsMatch(
+                    content,
+                    @"<tt\b[^>]*\bxmlns\s*=\s*[""']http://www\.w3\.org/ns/ttml[""']",
+                    System.Text.RegularExpressions.RegexOptions.IgnoreCase))
+            {
+                return LyricsFormat.Ttml;
+            }
+            // KRC: 检测主内容格式 [start,duration]<offset,duration,0>字...
+            else if (System.Text.RegularExpressions.Regex.IsMatch(
+                         content,
+                         @"^\[\d+,\d+\](<\d+,\d+,0>.+)+",
+                         System.Text.RegularExpressions.RegexOptions.Multiline))
+            {
+                return LyricsFormat.Krc;
+            }
+            // QRC: 检测主内容格式 [start,duration]字(offset,duration)
+            else if (System.Text.RegularExpressions.Regex.IsMatch(
+                         content,
+                         @"^\[\d+,\d+\].*?\(\d+,\d+\)",
+                         System.Text.RegularExpressions.RegexOptions.Multiline))
+            {
+                return LyricsFormat.Qrc;
+            }
+            // 标准LRC和增强型LRC
+            else if (System.Text.RegularExpressions.Regex.IsMatch(content, @"\[\d{1,2}:\d{2}") ||
+                     System.Text.RegularExpressions.Regex.IsMatch(content, @"<\d{1,2}:\d{2}\.\d{2,3}>"))
+            {
+                return LyricsFormat.Lrc;
+            }
+            else
+            {
+                return null;
+            }
+        }
+
+        public static string ToFileExtension(this LyricsFormat format)
+        {
+            return format switch
+            {
+                LyricsFormat.Lrc => ".lrc",
+                LyricsFormat.Qrc => ".qrc",
+                LyricsFormat.Krc => ".krc",
+                LyricsFormat.Eslrc => ".eslrc",
+                LyricsFormat.Ttml => ".ttml",
+                _ => ".*",
+            };
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsGlowEffectScope.cs

@@ -1,15 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace BetterLyrics.WinUI3.Enums
-{
-    public enum LyricsGlowEffectScope
-    {
-        WholeLyrics,
-        CurrentLine,
-        CurrentChar,
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsHighlightType.cs

@@ -1,8 +0,0 @@
-namespace BetterLyrics.WinUI3.Enums
-{
-    public enum LyricsHighlightType
-    {
-        LineByLine,
-        CharByChar,
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsPlayingState.cs

@@ -1,26 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace BetterLyrics.WinUI3.Enums
-{
-    public enum LyricsPlayingState
-    {
-        /// <summary>
-        /// Not played yet, will be playing in the future
-        /// </summary>
-        NotPlayed,
-
-        /// <summary>
-        /// Playing
-        /// </summary>
-        Playing,
-
-        /// <summary>
-        /// Has already played
-        /// </summary>
-        Played,
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsSearchProvider.cs

@@ -0,0 +1,65 @@
+// 2025/6/23 by Zhe Fang
+
+using BetterLyrics.WinUI3.Helper;
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    public enum LyricsSearchProvider
+    {
+        QQ,
+        Kugou,
+        Netease,
+        LrcLib,
+        AmllTtmlDb,
+        LocalMusicFile,
+        LocalLrcFile,
+        LocalEslrcFile,
+        LocalTtmlFile,
+    }
+
+    public static class LyricsSearchProviderExtensions
+    {
+        public static string GetCacheDirectory(this LyricsSearchProvider provider)
+        {
+            return provider switch
+            {
+                LyricsSearchProvider.LrcLib => PathHelper.LrcLibLyricsCacheDirectory,
+                LyricsSearchProvider.QQ => PathHelper.QQLyricsCacheDirectory,
+                LyricsSearchProvider.Netease => PathHelper.NeteaseLyricsCacheDirectory,
+                LyricsSearchProvider.Kugou => PathHelper.KugouLyricsCacheDirectory,
+                LyricsSearchProvider.AmllTtmlDb => PathHelper.AmllTtmlDbLyricsCacheDirectory,
+                _ => throw new System.ArgumentOutOfRangeException(nameof(provider)),
+            };
+        }
+
+        public static LyricsFormat GetLyricsFormat(this LyricsSearchProvider provider)
+        {
+            return provider switch
+            {
+                LyricsSearchProvider.LrcLib => LyricsFormat.Lrc,
+                LyricsSearchProvider.QQ => LyricsFormat.Qrc,
+                LyricsSearchProvider.Kugou => LyricsFormat.Krc,
+                LyricsSearchProvider.Netease => LyricsFormat.Lrc,
+                LyricsSearchProvider.AmllTtmlDb => LyricsFormat.Ttml,
+                LyricsSearchProvider.LocalLrcFile => LyricsFormat.Lrc,
+                LyricsSearchProvider.LocalEslrcFile => LyricsFormat.Eslrc,
+                LyricsSearchProvider.LocalTtmlFile => LyricsFormat.Ttml,
+                _ => LyricsFormat.NotSpecified,
+            };
+        }
+
+        public static bool IsLocal(this LyricsSearchProvider provider)
+        {
+            return provider
+                is LyricsSearchProvider.LocalMusicFile
+                    or LyricsSearchProvider.LocalLrcFile
+                    or LyricsSearchProvider.LocalEslrcFile
+                    or LyricsSearchProvider.LocalTtmlFile;
+        }
+
+        public static bool IsRemote(this LyricsSearchProvider provider)
+        {
+            return !provider.IsLocal();
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/TextAlignmentType.cs

@@ -0,0 +1,28 @@
+// 2025/6/23 by Zhe Fang
+
+using Microsoft.Graphics.Canvas.Text;
+using System;
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    public enum TextAlignmentType
+    {
+        Left,
+        Center,
+        Right,
+    }
+
+    public static class LyricsAlignmentTypeExtensions
+    {
+        public static CanvasHorizontalAlignment ToCanvasHorizontalAlignment(this TextAlignmentType alignmentType)
+        {
+            return alignmentType switch
+            {
+                TextAlignmentType.Left => CanvasHorizontalAlignment.Left,
+                TextAlignmentType.Center => CanvasHorizontalAlignment.Center,
+                TextAlignmentType.Right => CanvasHorizontalAlignment.Right,
+                _ => throw new ArgumentOutOfRangeException(nameof(alignmentType), alignmentType, null),
+            };
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/TitleBarType.cs

@@ -1,31 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace BetterLyrics.WinUI3.Enums
-{
-    public enum TitleBarType
-    {
-        Compact,
-        Extended,
-    }
-
-    public static class TitleBarTypeExtensions
-    {
-        public static double GetHeight(this TitleBarType titleBarType)
-        {
-            return titleBarType switch
-            {
-                TitleBarType.Compact => 32.0,
-                TitleBarType.Extended => 48.0,
-                _ => throw new ArgumentOutOfRangeException(
-                    nameof(titleBarType),
-                    titleBarType,
-                    null
-                ),
-            };
-        }
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/WindowPixelSampleMode.cs

@@ -0,0 +1,9 @@
+namespace BetterLyrics.WinUI3.Enums
+{
+    public enum WindowPixelSampleMode
+    {
+        BelowWindow,
+        WindowArea,
+        WindowEdge,
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Events/AlbumArtChangedEventArgs.cs

@@ -0,0 +1,16 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using Windows.Graphics.Imaging;
+using Windows.UI;
+
+namespace BetterLyrics.WinUI3.Events
+{
+    public class AlbumArtChangedEventArgs : EventArgs
+    {
+        public SoftwareBitmap? AlbumArtSwBitmap { get; set; } = null;
+        public Color? AlbumArtAccentColor { get; set; } = null;
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Events/IsPlayingChangedEventArgs.cs

@@ -1,8 +1,6 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
+// 2025/6/23 by Zhe Fang
+
+using System;
 
 namespace BetterLyrics.WinUI3.Events
 {

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Events/LibChangedEventArgs.cs

@@ -0,0 +1,18 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Events
+{
+    public class LibChangedEventArgs(string folder, string filePath, WatcherChangeTypes changeType) : EventArgs
+    {
+        public WatcherChangeTypes ChangeType { get; } = changeType;
+        public string FilePath { get; } = filePath;
+        public string Folder { get; } = folder;
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Events/MediaSourceProvidersInfoEventArgs.cs

@@ -0,0 +1,14 @@
+using BetterLyrics.WinUI3.Models;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Events
+{
+    public class MediaSourceProvidersInfoEventArgs(List<MediaSourceProviderInfo> sessionIds):EventArgs
+    {
+        public List<MediaSourceProviderInfo> MediaSourceProviersInfo { get; set; } = sessionIds;
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Events/PositionChangedEventArgs.cs

@@ -1,8 +1,6 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
+// 2025/6/23 by Zhe Fang
+
+using System;
 
 namespace BetterLyrics.WinUI3.Events
 {

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Events/SongInfoChangedEventArgs.cs

@@ -1,8 +1,6 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
+// 2025/6/23 by Zhe Fang
+
+using System;
 using BetterLyrics.WinUI3.Models;
 
 namespace BetterLyrics.WinUI3.Events

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/AnimationHelper.cs

@@ -1,13 +0,0 @@
-using System;
-using Microsoft.UI.Xaml;
-using Microsoft.UI.Xaml.Media.Animation;
-
-namespace BetterLyrics.WinUI3.Helper
-{
-    public static class AnimationHelper
-    {
-        public const int StackedNotificationsShowingDuration = 3900;
-        public const int StoryboardDefaultDuration = 200;
-        public const int DebounceDefaultDuration = 200;
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/AppInfo.cs

@@ -1,62 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace BetterLyrics.WinUI3.Helper
-{
-    using System;
-    using System.IO;
-    using Windows.ApplicationModel;
-    using Windows.Storage;
-
-    public static class AppInfo
-    {
-        // App Metadata
-        public const string AppName = "BetterLyrics";
-        public const string AppDisplayName = "Better Lyrics";
-        public const string AppAuthor = "Zhe Fang";
-        public const string GithubUrl = "https://github.com/jayfunc/BetterLyrics";
-        public static string AppVersion
-        {
-            get
-            {
-                var version = Package.Current.Id.Version;
-                return $"{version.Major}.{version.Minor}.{version.Build}.{version.Revision}";
-            }
-        }
-
-        // Environment Info
-        public static bool IsDebug =>
-#if DEBUG
-            true;
-#else
-            false;
-#endif
-
-        // Base Folders
-        private static string LocalFolder => ApplicationData.Current.LocalFolder.Path;
-        public static string CacheFolder => ApplicationData.Current.LocalCacheFolder.Path;
-        public static string AssetsFolder => Path.Combine(Package.Current.InstalledPath, "Assets");
-
-        // Data Files
-        private static string DatabaseFileName => "database.db";
-        public static string DatabasePath => Path.Combine(LocalFolder, DatabaseFileName);
-
-        public static string LogDirectory => Path.Combine(CacheFolder, "logs");
-        public static string LogFilePattern => Path.Combine(LogDirectory, "log-.txt");
-
-        private static string TestMusicFileName => "AI - 甜度爆表.mp3";
-        public static string TestMusicPath => Path.Combine(AssetsFolder, TestMusicFileName);
-
-        private static string CustomShaderFileName => "CustomTransform.bin";
-        public static string CustomShaderPath => Path.Combine(AssetsFolder, CustomShaderFileName);
-
-        public static void EnsureDirectories()
-        {
-            Directory.CreateDirectory(LogDirectory);
-            Directory.CreateDirectory(LocalFolder);
-        }
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/CollectionHelper.cs

@@ -1,18 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace BetterLyrics.WinUI3.Helper
-{
-    public static class CollectionHelper
-    {
-        public static T? SafeGet<T>(this IList<T> list, int index)
-        {
-            if (list == null || index < 0 || index >= list.Count)
-                return default;
-            return list[index];
-        }
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/ColorHelper.cs

@@ -1,24 +1,58 @@
-using System;
+// 2025/6/23 by Zhe Fang
+
+using BetterLyrics.WinUI3.Enums;
+using Microsoft.UI;
+using Microsoft.UI.Xaml;
+using System;
 using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
+using System.Drawing;
+using System.Drawing.Imaging;
+using Vanara.PInvoke;
 using Windows.UI;
 
+using Color = Windows.UI.Color;
+
 namespace BetterLyrics.WinUI3.Helper
 {
     public static class ColorHelper
     {
-        public static Windows.UI.Color ToWindowsUIColor(this System.Drawing.Color color)
+        public static ElementTheme GetElementThemeFromBackgroundColor(Color backgroundColor)
         {
-            return Windows.UI.Color.FromArgb(color.A, color.R, color.G, color.B);
+            // 计算亮度（YIQ公式）
+            double yiq =
+                ((backgroundColor.R * 299) + (backgroundColor.G * 587) + (backgroundColor.B * 114))
+                / 1000.0;
+            return yiq >= 128 ? ElementTheme.Light : ElementTheme.Dark;
         }
 
-        public static Color GetInterpolatedColor(
-            float progress,
-            Color startColor,
-            Color targetColor
-        )
+        public static Color GetForegroundColor(Color background)
+        {
+            // 转为 HSL
+            var hsl = CommunityToolkit.WinUI.Helpers.ColorHelper.ToHsl(background);
+            double h = hsl.H;
+            double s = hsl.S;
+            double l = hsl.L;
+
+            // 目标亮度与背景错开，但不极端
+            double targetL;
+            if (l >= 0.7)
+                targetL = 0.35; // 背景很亮，前景适中偏暗
+            else if (l <= 0.3)
+                targetL = 0.75; // 背景很暗，前景适中偏亮
+            else
+                targetL = l > 0.5 ? l - 0.35 : l + 0.35; // 其余情况适度错开
+
+            // 保持色相，适当提升饱和度
+            double targetS = Math.Min(1.0, s + 0.2);
+
+            // 转回 Color
+            var fg = CommunityToolkit.WinUI.Helpers.ColorHelper.FromHsl(h, targetS, targetL);
+
+            // 保持不透明
+            return Color.FromArgb(255, fg.R, fg.G, fg.B);
+        }
+
+        public static Color GetInterpolatedColor(float progress, Color startColor, Color targetColor)
         {
             byte Lerp(byte a, byte b) => (byte)(a + (progress * (b - a)));
             return Color.FromArgb(
@@ -28,5 +62,183 @@ namespace BetterLyrics.WinUI3.Helper
                 Lerp(startColor.B, targetColor.B)
             );
         }
+
+        public static Color ToColor(this int argb)
+        {
+            byte a = (byte)(argb >> 24);
+            byte r = (byte)(argb >> 16);
+            byte g = (byte)(argb >> 8);
+            byte b = (byte)argb;
+
+            // 还原非预乘分量
+            if (a == 0)
+                return Color.FromArgb(0, 0, 0, 0);
+
+            // 预乘解码
+            // 这里 a+1 是编码时的分母
+            int ap1 = a + 1;
+            r = (byte)Math.Min(255, (r * 255 + (ap1 / 2)) / ap1);
+            g = (byte)Math.Min(255, (g * 255 + (ap1 / 2)) / ap1);
+            b = (byte)Math.Min(255, (b * 255 + (ap1 / 2)) / ap1);
+
+            return Color.FromArgb(a, r, g, b);
+        }
+
+        public static Color ToColor(this System.Drawing.Color color)
+        {
+            return Color.FromArgb(color.A, color.R, color.G, color.B);
+        }
+
+        public static Color WithAlpha(this Color color, byte alpha)
+        {
+            return Color.FromArgb(alpha, color.R, color.G, color.B);
+        }
+
+        public static Color WithBrightness(this Color color, double brightness)
+        {
+            // 确保亮度因子在合理范围内
+            brightness = Math.Max(0, Math.Min(1, brightness));
+
+            var hsl = CommunityToolkit.WinUI.Helpers.ColorHelper.ToHsl(color);
+            double h = hsl.H;
+            double s = hsl.S;
+
+            return CommunityToolkit.WinUI.Helpers.ColorHelper.FromHsl(h, s, brightness);
+        }
+
+        public static System.Drawing.Color GetAccentColor(IntPtr myHwnd, WindowPixelSampleMode mode)
+        {
+            if (!User32.GetWindowRect(myHwnd, out RECT myRect)) return System.Drawing.Color.Transparent;
+
+            switch (mode)
+            {
+                case WindowPixelSampleMode.BelowWindow:
+                    {
+                        int screenWidth = User32.GetSystemMetrics(User32.SystemMetric.SM_CXSCREEN);
+                        int sampleHeight = 1;
+                        int sampleY = myRect.Bottom + 1;
+                        return GetAverageColorFromScreenRegion(0, sampleY, screenWidth, sampleHeight);
+                    }
+                case WindowPixelSampleMode.WindowArea:
+                    {
+                        int width = myRect.Right - myRect.Left;
+                        int height = myRect.Bottom - myRect.Top;
+                        if (width <= 0 || height <= 0)
+                            return System.Drawing.Color.Transparent;
+                        // 采集窗口区域的平均色
+                        return GetAverageColorFromScreenRegion(myRect.Left, myRect.Top, width, height);
+                    }
+                case WindowPixelSampleMode.WindowEdge:
+                    {
+                        int width = myRect.Right - myRect.Left;
+                        int height = myRect.Bottom - myRect.Top;
+                        if (width <= 0 || height <= 0)
+                            return System.Drawing.Color.Transparent;
+
+                        var edgeThickness = new Thickness(36, 0, 36, 0);
+                        List<System.Drawing.Color> edgeColors = [];
+
+                        // Top edge
+                        if (edgeThickness.Top > 0 && edgeThickness.Top < height)
+                            edgeColors.Add(
+                                GetAverageColorFromScreenRegion(
+                                    myRect.Left,
+                                    myRect.Top,
+                                    width,
+                                    (int)edgeThickness.Top
+                                )
+                            );
+                        // Bottom edge
+                        if (edgeThickness.Bottom > 0 && edgeThickness.Bottom < height)
+                            edgeColors.Add(
+                                GetAverageColorFromScreenRegion(
+                                    myRect.Left,
+                                    myRect.Bottom - (int)edgeThickness.Bottom,
+                                    width,
+                                    (int)edgeThickness.Bottom
+                                )
+                            );
+                        // Left edge
+                        if (edgeThickness.Left > 0 && edgeThickness.Left < width)
+                            edgeColors.Add(
+                                GetAverageColorFromScreenRegion(
+                                    myRect.Left,
+                                    myRect.Top + (int)edgeThickness.Top,
+                                    (int)edgeThickness.Left,
+                                    height - (int)edgeThickness.Top - (int)edgeThickness.Bottom
+                                )
+                            );
+                        // Right edge
+                        if (edgeThickness.Right > 0 && edgeThickness.Right < width)
+                            edgeColors.Add(
+                                GetAverageColorFromScreenRegion(
+                                    myRect.Right - (int)edgeThickness.Right,
+                                    myRect.Top + (int)edgeThickness.Top,
+                                    (int)edgeThickness.Right,
+                                    height - (int)edgeThickness.Top - (int)edgeThickness.Bottom
+                                )
+                            );
+
+                        // 合并四边平均色
+                        if (edgeColors.Count == 0)
+                            return System.Drawing.Color.Transparent;
+                        long r = 0,
+                            g = 0,
+                            b = 0;
+                        foreach (var c in edgeColors)
+                        {
+                            r += c.R;
+                            g += c.G;
+                            b += c.B;
+                        }
+                        return System.Drawing.Color.FromArgb(
+                            255,
+                            (int)(r / edgeColors.Count),
+                            (int)(g / edgeColors.Count),
+                            (int)(b / edgeColors.Count)
+                        );
+                    }
+                default:
+                    return System.Drawing.Color.Transparent;
+            }
+        }
+
+        private static System.Drawing.Color GetAverageColorFromScreenRegion(int x, int y, int width, int height)
+        {
+            using Bitmap bmp = new(width, height, PixelFormat.Format32bppArgb);
+            using Graphics gDest = Graphics.FromImage(bmp);
+
+            IntPtr hdcDest = gDest.GetHdc();
+            IntPtr hdcSrc = (nint)User32.GetDC(IntPtr.Zero); // Entire screen
+
+            Gdi32.BitBlt(hdcDest, 0, 0, width, height, hdcSrc, x, y, Gdi32.RasterOperationMode.SRCCOPY);
+
+            gDest.ReleaseHdc(hdcDest);
+            User32.ReleaseDC(IntPtr.Zero, hdcSrc);
+
+            return ComputeAverageColor(bmp);
+        }
+
+        private static System.Drawing.Color ComputeAverageColor(Bitmap bmp)
+        {
+            long r = 0, g = 0, b = 0;
+            int count = 0;
+
+            for (int y = 0; y < bmp.Height; y++)
+            {
+                for (int x = 0; x < bmp.Width; x++)
+                {
+                    System.Drawing.Color pixel = bmp.GetPixel(x, y);
+                    r += pixel.R;
+                    g += pixel.G;
+                    b += pixel.B;
+                    count++;
+                }
+            }
+
+            if (count == 0) return System.Drawing.Color.Transparent;
+            return System.Drawing.Color.FromArgb((int)(r / count), (int)(g / count), (int)(b / count));
+        }
+
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/DesktopModeHelper.cs

@@ -0,0 +1,114 @@
+using BetterLyrics.WinUI3.Enums;
+using BetterLyrics.WinUI3.Services;
+using CommunityToolkit.Mvvm.DependencyInjection;
+using Microsoft.UI.Windowing;
+using Microsoft.UI.Xaml;
+using System;
+using System.Collections.Generic;
+using System.Runtime.InteropServices;
+using Vanara.PInvoke;
+using WinRT.Interop;
+using WinUIEx;
+
+namespace BetterLyrics.WinUI3.Helper
+{
+    public static class DesktopModeHelper
+    {
+        private static readonly ISettingsService _settingsService = Ioc.Default.GetRequiredService<ISettingsService>();
+
+        private static readonly Dictionary<IntPtr, bool> _originalTopmostStates = [];
+        private static readonly Dictionary<IntPtr, (double X, double Y, double Width, double Height)> _originalWindowBounds = [];
+        private static readonly Dictionary<IntPtr, WindowStyle> _originalWindowStyles = [];
+
+        private delegate nint WndProcDelegate(nint hWnd, uint msg, nint wParam, nint lParam);
+
+        public static void Disable(Window window)
+        {
+            IntPtr hwnd = WindowNative.GetWindowHandle(window);
+
+            // <20>ָ<EFBFBD>TopMost״̬
+            if (_originalTopmostStates.TryGetValue(hwnd, out var wasTopMost))
+            {
+                window.SetIsAlwaysOnTop(wasTopMost);
+                _originalTopmostStates.Remove(hwnd);
+            }
+
+            // <20>ָ<EFBFBD><D6B8><EFBFBD><EFBFBD><EFBFBD>λ<EFBFBD>úʹ<C3BA>С
+            if (_originalWindowBounds.TryGetValue(hwnd, out var bounds))
+            {
+                window.AppWindow.MoveAndResize(
+                    new Windows.Graphics.RectInt32(
+                        (int)bounds.X,
+                        (int)bounds.Y,
+                        (int)bounds.Width,
+                        (int)bounds.Height
+                    )
+                );
+                _originalWindowBounds.Remove(hwnd);
+            }
+
+            window.SetIsShownInSwitchers(true);
+        }
+
+        public static void Enable(Window window)
+        {
+            IntPtr hwnd = WindowNative.GetWindowHandle(window);
+
+            // <20><>¼ԭʼ<D4AD><CABC><EFBFBD><EFBFBD>λ<EFBFBD>úʹ<C3BA>С
+            if (!_originalWindowBounds.ContainsKey(hwnd))
+            {
+                _originalWindowBounds[hwnd] = (
+                    window.AppWindow.Position.X,
+                    window.AppWindow.Position.Y,
+                    window.AppWindow.Size.Width,
+                    window.AppWindow.Size.Height
+                );
+            }
+
+            // <20>Ӵ洢<D3B4><E6B4A2><EFBFBD><EFBFBD>ȡĿ<C8A1><C4BF><EFBFBD><EFBFBD><EFBFBD>ߺ<EFBFBD>λ<EFBFBD><CEBB>
+            int targetWidth = _settingsService.DesktopWindowWidth;
+            int targetHeight = _settingsService.DesktopWindowHeight;
+            int targetX = _settingsService.DesktopWindowLeft;
+            int targetY = _settingsService.DesktopWindowTop;
+
+            // <20><><EFBFBD>ô<EFBFBD><C3B4>ڴ<EFBFBD>С<EFBFBD><D0A1>λ<EFBFBD><CEBB>
+            window.AppWindow.MoveAndResize(
+                new Windows.Graphics.RectInt32(targetX, targetY, targetWidth, targetHeight)
+            );
+
+            // <20><><EFBFBD><EFBFBD>ԭTopMost״̬
+            if (!_originalTopmostStates.ContainsKey(hwnd))
+                _originalTopmostStates[hwnd] = window.GetIsAlwaysOnTop();
+
+            // <20><><EFBFBD>ô<EFBFBD><C3B4><EFBFBD><EFBFBD>ö<EFBFBD>
+            window.SetIsAlwaysOnTop(true);
+
+            window.SetIsShownInSwitchers(false);
+        }
+
+        public static void SetClickThrough(Window window, bool enable)
+        {
+            IntPtr hwnd = WindowNative.GetWindowHandle(window);
+            int exStyle = User32.GetWindowLong(hwnd, User32.WindowLongFlags.GWL_EXSTYLE);
+            if (enable)
+            {
+                // <20><><EFBFBD><EFBFBD>ԭ<EFBFBD><D4AD>ʽ
+                if (!_originalWindowStyles.ContainsKey(hwnd))
+                    _originalWindowStyles[hwnd] = window.GetWindowStyle();
+
+                window.ToggleWindowStyle(true, WindowStyle.Popup | WindowStyle.Visible);
+                User32.SetWindowLong(hwnd, User32.WindowLongFlags.GWL_EXSTYLE, exStyle | (int)User32.WindowStylesEx.WS_EX_TRANSPARENT | (int)User32.WindowStylesEx.WS_EX_LAYERED);
+            }
+            else
+            {
+                User32.SetWindowLong(hwnd, User32.WindowLongFlags.GWL_EXSTYLE, exStyle & ~(int)User32.WindowStylesEx.WS_EX_TRANSPARENT);
+                // <20>ָ<EFBFBD><D6B8><EFBFBD>ʽ
+                if (_originalWindowStyles.TryGetValue(hwnd, out var style))
+                {
+                    window.SetWindowStyle(style);
+                    _originalWindowStyles.Remove(hwnd);
+                }
+            }
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/DockHelper.cs

@@ -1,220 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Drawing;
-using System.Linq;
-using System.Runtime.InteropServices;
-using System.Text;
-using System.Threading.Tasks;
-using Microsoft.UI.Xaml;
-using WinRT.Interop;
-using WinUIEx;
-
-namespace BetterLyrics.WinUI3.Helper
-{
-    public static class DockHelper
-    {
-        private static readonly HashSet<IntPtr> _registered = [];
-
-        private static readonly Dictionary<IntPtr, RECT> _originalPositions = [];
-
-        private static readonly Dictionary<IntPtr, WindowStyle> _originalWindowStyle = [];
-
-        public static void Disable(Window window)
-        {
-            window.SetIsShownInSwitchers(true);
-            window.ExtendsContentIntoTitleBar = true;
-
-            IntPtr hwnd = WindowNative.GetWindowHandle(window);
-
-            window.SetWindowStyle(_originalWindowStyle[hwnd]);
-            _originalWindowStyle.Remove(hwnd);
-
-            if (_originalPositions.TryGetValue(hwnd, out var rect))
-            {
-                SetWindowPos(
-                    hwnd,
-                    IntPtr.Zero,
-                    rect.left,
-                    rect.top,
-                    rect.right - rect.left,
-                    rect.bottom - rect.top,
-                    SWP_NOACTIVATE | SWP_NOOWNERZORDER | SWP_SHOWWINDOW
-                );
-                _originalPositions.Remove(hwnd);
-            }
-
-            window.SetIsAlwaysOnTop(false);
-
-            UnregisterAppBar(hwnd);
-        }
-
-        public static void Enable(Window window, int appBarHeight)
-        {
-            window.SetIsShownInSwitchers(false);
-            window.ExtendsContentIntoTitleBar = false;
-
-            IntPtr hwnd = WindowNative.GetWindowHandle(window);
-
-            if (!_originalWindowStyle.ContainsKey(hwnd))
-            {
-                _originalWindowStyle[hwnd] = window.GetWindowStyle();
-            }
-            window.SetWindowStyle(WindowStyle.Popup | WindowStyle.Visible);
-
-            if (!_originalPositions.ContainsKey(hwnd))
-            {
-                if (GetWindowRect(hwnd, out var rect))
-                {
-                    _originalPositions[hwnd] = rect;
-                }
-            }
-
-            RegisterAppBar(hwnd, appBarHeight);
-
-            int screenWidth = GetSystemMetrics(SM_CXSCREEN);
-            int screenHeight = GetSystemMetrics(SM_CYSCREEN);
-            SetWindowPos(
-                hwnd,
-                IntPtr.Zero,
-                0,
-                0,
-                screenWidth,
-                appBarHeight,
-                SWP_NOACTIVATE | SWP_NOOWNERZORDER | SWP_SHOWWINDOW
-            );
-
-            window.SetIsAlwaysOnTop(true);
-        }
-
-        [DllImport("user32.dll", SetLastError = true)]
-        private static extern bool GetWindowRect(IntPtr hWnd, out RECT lpRect);
-
-        #region AppBar registration
-        private const uint ABM_NEW = 0x00000000;
-        private const uint ABM_REMOVE = 0x00000001;
-        private const uint ABM_SETPOS = 0x00000003;
-        private const int ABE_TOP = 1;
-
-        [StructLayout(LayoutKind.Sequential)]
-        private struct APPBARDATA
-        {
-            public int cbSize;
-            public IntPtr hWnd;
-            public uint uCallbackMessage;
-            public uint uEdge;
-            public RECT rc;
-            public int lParam;
-        }
-
-        [StructLayout(LayoutKind.Sequential)]
-        private struct RECT
-        {
-            public int left,
-                top,
-                right,
-                bottom;
-        }
-
-        [DllImport("shell32.dll", SetLastError = true)]
-        private static extern uint SHAppBarMessage(uint dwMessage, ref APPBARDATA pData);
-
-        private static void RegisterAppBar(IntPtr hwnd, int height)
-        {
-            if (_registered.Contains(hwnd))
-                return;
-
-            APPBARDATA abd = new()
-            {
-                cbSize = Marshal.SizeOf<APPBARDATA>(),
-                hWnd = hwnd,
-                uEdge = ABE_TOP,
-                rc = new RECT
-                {
-                    left = 0,
-                    top = 0,
-                    right = GetSystemMetrics(SM_CXSCREEN),
-                    bottom = height,
-                },
-            };
-
-            SHAppBarMessage(ABM_NEW, ref abd);
-            SHAppBarMessage(ABM_SETPOS, ref abd);
-
-            _registered.Add(hwnd);
-        }
-
-        private static void UnregisterAppBar(IntPtr hwnd)
-        {
-            if (!_registered.Contains(hwnd))
-                return;
-
-            APPBARDATA abd = new() { cbSize = Marshal.SizeOf<APPBARDATA>(), hWnd = hwnd };
-
-            SHAppBarMessage(ABM_REMOVE, ref abd);
-            _registered.Remove(hwnd);
-        }
-        #endregion
-
-        #region Win32 Helper and Constants
-
-        private const int SWP_NOACTIVATE = 0x0010;
-        private const int SWP_NOOWNERZORDER = 0x0200;
-        private const int SWP_SHOWWINDOW = 0x0040;
-
-        private const int SM_CXSCREEN = 0;
-        private const int SM_CYSCREEN = 0;
-
-        [DllImport("user32.dll")]
-        private static extern int GetSystemMetrics(int nIndex);
-
-        [DllImport("user32.dll", SetLastError = true)]
-        private static extern bool SetWindowPos(
-            IntPtr hWnd,
-            IntPtr hWndInsertAfter,
-            int X,
-            int Y,
-            int cx,
-            int cy,
-            uint uFlags
-        );
-
-        /// <summary>
-        /// 更改已注册 AppBar 的高度。
-        /// </summary>
-        /// <param name="window">目标窗口</param>
-        /// <param name="newHeight">新的高度</param>
-        public static void UpdateAppBarHeight(IntPtr hwnd, int newHeight)
-        {
-            if (!_registered.Contains(hwnd))
-                return;
-
-            APPBARDATA abd = new()
-            {
-                cbSize = Marshal.SizeOf<APPBARDATA>(),
-                hWnd = hwnd,
-                uEdge = ABE_TOP,
-                rc = new RECT
-                {
-                    left = 0,
-                    top = 0,
-                    right = GetSystemMetrics(SM_CXSCREEN),
-                    bottom = newHeight,
-                },
-            };
-
-            SHAppBarMessage(ABM_SETPOS, ref abd);
-
-            // 同步窗口实际高度
-            SetWindowPos(
-                hwnd,
-                IntPtr.Zero,
-                0,
-                0,
-                GetSystemMetrics(SM_CXSCREEN),
-                newHeight,
-                SWP_NOACTIVATE | SWP_NOOWNERZORDER | SWP_SHOWWINDOW
-            );
-        }
-        #endregion
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/DockModeHelper.cs

@@ -0,0 +1,158 @@
+using Microsoft.UI.Xaml;
+using System;
+using System.Collections.Generic;
+using System.Drawing;
+using System.Linq;
+using System.Runtime.InteropServices;
+using System.Text;
+using System.Threading.Tasks;
+using Vanara.PInvoke;
+using WinRT.Interop;
+using WinUIEx;
+
+namespace BetterLyrics.WinUI3.Helper
+{
+    public static class DockModeHelper
+    {
+        private static readonly HashSet<IntPtr> _registered = [];
+        private static readonly Dictionary<IntPtr, RECT> _originalPositions = [];
+        private static readonly Dictionary<IntPtr, WindowStyle> _originalWindowStyle = [];
+
+        public static void Disable(Window window)
+        {
+            window.SetIsShownInSwitchers(true);
+            window.ExtendsContentIntoTitleBar = true;
+            window.SetIsAlwaysOnTop(false);
+
+            IntPtr hwnd = WindowNative.GetWindowHandle(window);
+
+            window.SetWindowStyle(_originalWindowStyle[hwnd]);
+            _originalWindowStyle.Remove(hwnd);
+
+            if (_originalPositions.TryGetValue(hwnd, out var rect))
+            {
+                User32.SetWindowPos(
+                    hwnd,
+                    IntPtr.Zero,
+                    rect.Left,
+                    rect.Top,
+                    rect.Right - rect.Left,
+                    rect.Bottom - rect.Top,
+                    User32.SetWindowPosFlags.SWP_SHOWWINDOW
+                );
+                _originalPositions.Remove(hwnd);
+            }
+
+            UnregisterAppBar(hwnd);
+        }
+
+        public static void Enable(Window window, int appBarHeight)
+        {
+            window.SetIsShownInSwitchers(false);
+            window.ExtendsContentIntoTitleBar = false;
+            window.SetIsAlwaysOnTop(true);
+
+            IntPtr hwnd = WindowNative.GetWindowHandle(window);
+
+            if (!_originalWindowStyle.ContainsKey(hwnd))
+            {
+                _originalWindowStyle[hwnd] = window.GetWindowStyle();
+            }
+            window.SetWindowStyle(WindowStyle.Popup | WindowStyle.Visible);
+
+            if (!_originalPositions.ContainsKey(hwnd))
+            {
+                if (User32.GetWindowRect(hwnd, out var rect))
+                {
+                    _originalPositions[hwnd] = rect;
+                }
+            }
+
+            RegisterAppBar(hwnd, appBarHeight);
+
+            int screenWidth = User32.GetSystemMetrics(User32.SystemMetric.SM_CXSCREEN);
+            int screenHeight = User32.GetSystemMetrics(User32.SystemMetric.SM_CYSCREEN);
+            User32.SetWindowPos(
+                hwnd,
+                IntPtr.Zero,
+                0,
+                0,
+                screenWidth,
+                appBarHeight,
+                User32.SetWindowPosFlags.SWP_SHOWWINDOW
+            );
+        }
+
+        private static void RegisterAppBar(IntPtr hwnd, int height)
+        {
+            if (_registered.Contains(hwnd)) return;
+
+            Shell32.APPBARDATA abd = new()
+            {
+                cbSize = (uint)Marshal.SizeOf<Shell32.APPBARDATA>(),
+                hWnd = hwnd,
+                uEdge = Shell32.ABE.ABE_TOP,
+                rc = new RECT
+                {
+                    Left = 0,
+                    Top = 0,
+                    Right = User32.GetSystemMetrics(User32.SystemMetric.SM_CXSCREEN),
+                    Bottom = height,
+                },
+            };
+
+            Shell32.SHAppBarMessage(Shell32.ABM.ABM_NEW, ref abd);
+            Shell32.SHAppBarMessage(Shell32.ABM.ABM_SETPOS, ref abd);
+
+            _registered.Add(hwnd);
+        }
+
+        private static void UnregisterAppBar(IntPtr hwnd)
+        {
+            if (!_registered.Contains(hwnd))
+                return;
+
+            Shell32.APPBARDATA abd = new()
+            {
+                cbSize = (uint)Marshal.SizeOf<Shell32.APPBARDATA>(),
+                hWnd = hwnd
+            };
+
+            Shell32.SHAppBarMessage(Shell32.ABM.ABM_REMOVE, ref abd);
+            _registered.Remove(hwnd);
+        }
+
+        public static void UpdateAppBarHeight(IntPtr hwnd, int newHeight)
+        {
+            if (!_registered.Contains(hwnd))
+                return;
+
+            Shell32.APPBARDATA abd = new()
+            {
+                cbSize = (uint)Marshal.SizeOf<Shell32.APPBARDATA>(),
+                hWnd = hwnd,
+                uEdge = Shell32.ABE.ABE_TOP,
+                rc = new RECT
+                {
+                    Left = 0,
+                    Top = 0,
+                    Right = User32.GetSystemMetrics(User32.SystemMetric.SM_CXSCREEN),
+                    Bottom = newHeight,
+                },
+            };
+
+            Shell32.SHAppBarMessage(Shell32.ABM.ABM_SETPOS, ref abd);
+
+            // 同步窗口实际高度
+            User32.SetWindowPos(
+                hwnd,
+                IntPtr.Zero,
+                0,
+                0,
+                User32.GetSystemMetrics(User32.SystemMetric.SM_CXSCREEN),
+                newHeight,
+                User32.SetWindowPosFlags.SWP_SHOWWINDOW
+            );
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/EasingHelper.cs

@@ -1,4 +1,6 @@
-using System;
+// 2025/6/23 by Zhe Fang
+
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Text;
@@ -8,43 +10,103 @@ namespace BetterLyrics.WinUI3.Helper
 {
     public class EasingHelper
     {
-        /// <summary>
-        /// No easing
-        /// </summary>
-        public static float Linear(float t) => t;
-
-        /// <summary>
-        /// Accelerating from 0
-        /// </summary>
-        public static float EaseInQuad(float t) => t * t;
-
-        /// <summary>
-        /// Decelerating to 0
-        /// </summary>
-        public static float EaseOutQuad(float t) => t * (2 - t);
-
-        /// <summary>
-        /// Acceleration until halfway then deceleration
-        /// </summary>
+        public static float EaseInOutSine(float t)
+        {
+            return -(MathF.Cos(MathF.PI * t) - 1f) / 2f;
+        }
         public static float EaseInOutQuad(float t)
         {
             return t < 0.5f ? 2 * t * t : -1 + (4 - 2 * t) * t;
         }
 
-        /// <summary>
-        /// Smoother transition than linear
-        /// </summary>
-        public static float SmoothStep(float t)
+        public static float EaseInOutCubic(float t)
         {
-            return t * t * (3 - 2 * t);
+            return t < 0.5f ? 4 * t * t * t : 1 - MathF.Pow(-2 * t + 2, 3) / 2;
+        }
+        public static float EaseInOutQuart(float t)
+        {
+            return t < 0.5f ? 8 * t * t * t * t : 1 - MathF.Pow(-2 * t + 2, 4) / 2;
         }
 
-        /// <summary>
-        /// Even smoother transition with continuous first and second derivatives
-        /// </summary>
-        public static float SmootherStep(float t)
+        public static float EaseInOutQuint(float t)
         {
-            return t * t * t * (t * (6 * t - 15) + 10);
+            return t < 0.5f ? 16 * t * t * t * t * t : 1 - MathF.Pow(-2 * t + 2, 5) / 2;
         }
+
+        public static float EaseInOutExpo(float t)
+        {
+            return t == 0
+              ? 0
+              : t == 1
+              ? 1
+              : t < 0.5 ? MathF.Pow(2, 20 * t - 10) / 2
+              : (2 - MathF.Pow(2, -20 * t + 10)) / 2;
+        }
+
+        public static float EaseInOutCirc(float t)
+        {
+            return t < 0.5f
+              ? (1 - MathF.Sqrt(1 - MathF.Pow(2 * t, 2))) / 2
+              : (MathF.Sqrt(1 - MathF.Pow(-2 * t + 2, 2)) + 1) / 2;
+        }
+
+        public static float EaseInOutBack(float t)
+        {
+            float c1 = 1.70158f;
+            float c2 = c1 * 1.525f;
+
+            return t < 0.5
+              ? (MathF.Pow(2 * t, 2) * ((c2 + 1) * 2 * t - c2)) / 2
+              : (MathF.Pow(2 * t - 2, 2) * ((c2 + 1) * (t * 2 - 2) + c2) + 2) / 2;
+        }
+
+        public static float EaseInOutElastic(float t)
+        {
+            if (t == 0 || t == 1) return t;
+            float p = 0.3f;
+            float s = p / 4;
+            return t < 0.5f
+              ? -(MathF.Pow(2, 20 * t - 10) * MathF.Sin((20 * t - 11.125f) * (2 * MathF.PI) / p)) / 2
+              : (MathF.Pow(2, -20 * t + 10) * MathF.Sin((20 * t - 11.125f) * (2 * MathF.PI) / p)) / 2 + 1;
+        }
+
+        private static float EaseOutBounce(float t)
+        {
+            if (t < 4 / 11f)
+            {
+                return (121 * t * t) / 16f;
+            }
+            else if (t < 8 / 11f)
+            {
+                return (363 / 40f * t * t) - (99 / 10f * t) + 17 / 5f;
+            }
+            else if (t < 9 / 10f)
+            {
+                return (4356 / 361f * t * t) - (35442 / 1805f * t) + 16061 / 1805f;
+            }
+            else
+            {
+                return (54 / 5f * t * t) - (513 / 25f * t) + 268 / 25f;
+            }
+        }
+
+        public static float EaseInOutBounce(float t)
+        {
+            if (t < 0.5f)
+            {
+                return (1 - EaseOutBounce(1 - 2 * t)) / 2;
+            }
+            else
+            {
+                return (1 + EaseOutBounce(2 * t - 1)) / 2;
+            }
+        }
+
+        public static float SmoothStep(float t)
+        {
+            return t * t * (3f - 2f * t);
+        }
+
+        public static float Linear(float t) => t;
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/FileHelper.cs

@@ -0,0 +1,82 @@
+// 2025/6/23 by Zhe Fang
+
+using BetterLyrics.WinUI3.Enums;
+using System;
+using System.IO;
+using System.Text;
+using Ude;
+
+namespace BetterLyrics.WinUI3.Helper
+{
+    public class FileHelper
+    {
+        public static Encoding GetEncoding(string filename)
+        {
+            var bytes = File.ReadAllBytes(filename);
+            var cdet = new CharsetDetector();
+            cdet.Feed(bytes, 0, bytes.Length);
+            cdet.DataEnd();
+            var encoding = cdet.Charset;
+            if (encoding == null)
+            {
+                return Encoding.UTF8;
+            }
+            return Encoding.GetEncoding(encoding);
+        }
+
+        public static string SanitizeFileName(string fileName, char replacement = '_')
+        {
+            var invalidChars = Path.GetInvalidFileNameChars();
+            var sb = new StringBuilder(fileName.Length);
+            foreach (var c in fileName)
+            {
+                sb.Append(Array.IndexOf(invalidChars, c) >= 0 ? replacement : c);
+            }
+            return sb.ToString();
+        }
+
+        public static string? ReadLyricsCache(string title, string artist, LyricsFormat format, string cacheFolderPath)
+        {
+            var cacheFilePath = Path.Combine(cacheFolderPath, SanitizeFileName($"{artist} - {title}{format.ToFileExtension()}"));
+            if (File.Exists(cacheFilePath))
+            {
+                return File.ReadAllText(cacheFilePath);
+            }
+            return null;
+        }
+
+        public static byte[]? ReadAlbumArtCache(string album, string artist, string format, string cacheFolderPath)
+        {
+            var cacheFilePath = Path.Combine(cacheFolderPath, SanitizeFileName($"{artist} - {album}{format}"));
+            if (File.Exists(cacheFilePath))
+            {
+                return File.ReadAllBytes(cacheFilePath);
+            }
+            return null;
+        }
+
+        public static void WriteLyricsCache(string title, string artist, string lyrics, LyricsFormat format, string cacheFolderPath)
+        {
+            var cacheFilePath = Path.Combine(cacheFolderPath, SanitizeFileName($"{artist} - {title}{format.ToFileExtension()}"));
+            File.WriteAllText(cacheFilePath, lyrics);
+        }
+
+        public static void WriteAlbumArtCache(string album, string artist, byte[] img, string format, string cacheFolderPath)
+        {
+            var cacheFilePath = Path.Combine(cacheFolderPath, SanitizeFileName($"{artist} - {album}{format}"));
+            File.WriteAllBytes(cacheFilePath, img);
+        }
+
+        public static bool IsSwitchableNormalizedMatch(string fileName, string q1, string q2)
+        {
+            var normFileName = StringHelper.Normalize(fileName.Normalize());
+            var normQ1 = StringHelper.Normalize(q1);
+            var normQ2 = StringHelper.Normalize(q2);
+
+            // 常见两种顺序
+            return normFileName == normQ1 + normQ2
+                || normFileName == normQ2 + normQ1;
+        }
+
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/ForegroundWindowWatcher.cs

@@ -0,0 +1,109 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Runtime.InteropServices;
+using System.Text;
+using System.Threading.Tasks;
+using Microsoft.UI.Xaml;
+using Vanara.PInvoke;
+using Windows.System;
+
+namespace BetterLyrics.WinUI3.Helper
+{
+    public class ForegroundWindowWatcher
+    {
+        private readonly User32.WinEventProc _winEventDelegate;
+        private readonly List<User32.HWINEVENTHOOK> _hooks = new();
+        private HWND _currentForeground = HWND.NULL;
+        private readonly IntPtr _selfHwnd;
+
+        public delegate void WindowChangedHandler(HWND hwnd);
+        private readonly WindowChangedHandler _onWindowChanged;
+
+        private readonly DispatcherTimer _timer;
+
+        public ForegroundWindowWatcher(IntPtr selfHwnd, WindowChangedHandler onWindowChanged)
+        {
+            _selfHwnd = selfHwnd;
+            _onWindowChanged = onWindowChanged;
+            _winEventDelegate = new User32.WinEventProc(WinEventProc);
+
+            _timer = new DispatcherTimer();
+            _timer.Interval = TimeSpan.FromSeconds(1);
+            _timer.Tick += Timer_Tick;
+        }
+
+        public void Start()
+        {
+            // Hook: foreground changes and minimize end
+            _hooks.Add(
+                User32.SetWinEventHook(
+                    User32.EventConstants.EVENT_SYSTEM_FOREGROUND,
+                    User32.EventConstants.EVENT_SYSTEM_MINIMIZEEND,
+                    HINSTANCE.NULL,
+                    _winEventDelegate,
+                    0,
+                    0,
+                    User32.WINEVENT.WINEVENT_OUTOFCONTEXT
+                )
+            );
+
+            // Hook: window move/resize (location change)
+            _hooks.Add(
+                User32.SetWinEventHook(
+                    User32.EventConstants.EVENT_OBJECT_LOCATIONCHANGE,
+                    User32.EventConstants.EVENT_OBJECT_LOCATIONCHANGE,
+                    HINSTANCE.NULL,
+                    _winEventDelegate,
+                    0,
+                    0,
+                    User32.WINEVENT.WINEVENT_OUTOFCONTEXT
+                )
+            );
+
+            _timer.Start();
+        }
+
+        public void Stop()
+        {
+            foreach (var hook in _hooks)
+                User32.UnhookWinEvent(hook);
+
+            _hooks.Clear();
+
+            _timer.Stop();
+        }
+
+        private void Timer_Tick(object? sender, object e)
+        {
+            if (_currentForeground != HWND.NULL)
+            {
+                _onWindowChanged?.Invoke(_currentForeground);
+            }
+        }
+
+        private void WinEventProc(
+            User32.HWINEVENTHOOK hWinEventHook,
+            uint eventType,
+            HWND hwnd,
+            int idObject,
+            int idChild,
+            uint dwEventThread,
+            uint dwmsEventTime
+        )
+        {
+            if (hwnd == IntPtr.Zero)
+                return;
+
+            if (eventType == User32.EventConstants.EVENT_SYSTEM_FOREGROUND)
+            {
+                _currentForeground = hwnd;
+                _onWindowChanged?.Invoke(hwnd);
+            }
+            else if ((eventType == User32.EventConstants.EVENT_OBJECT_LOCATIONCHANGE || eventType == User32.EventConstants.EVENT_SYSTEM_MINIMIZEEND) && hwnd == _currentForeground)
+            {
+                _onWindowChanged?.Invoke(hwnd);
+            }
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/ForegroundWindowWatcherHelper.cs

@@ -1,142 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Runtime.InteropServices;
-using System.Text;
-using System.Threading.Tasks;
-using Microsoft.UI.Xaml;
-
-namespace BetterLyrics.WinUI3.Helper
-{
-    public class ForegroundWindowWatcherHelper
-    {
-        private readonly WinEventDelegate _winEventDelegate;
-        private readonly List<IntPtr> _hooks = new();
-        private IntPtr _currentForeground = IntPtr.Zero;
-        private readonly IntPtr _selfHwnd;
-        private readonly DispatcherTimer _pollingTimer;
-        private DateTime _lastEventTime = DateTime.MinValue;
-        private const int ThrottleIntervalMs = 100;
-
-        public delegate void WindowChangedHandler(IntPtr hwnd);
-        private readonly WindowChangedHandler _onWindowChanged;
-
-        private const uint EVENT_SYSTEM_FOREGROUND = 0x0003;
-        private const uint EVENT_SYSTEM_MINIMIZEEND = 0x0017;
-        private const uint EVENT_OBJECT_LOCATIONCHANGE = 0x800B;
-        private const uint WINEVENT_OUTOFCONTEXT = 0x0000;
-
-        public ForegroundWindowWatcherHelper(IntPtr selfHwnd, WindowChangedHandler onWindowChanged)
-        {
-            _selfHwnd = selfHwnd;
-            _onWindowChanged = onWindowChanged;
-            _winEventDelegate = new WinEventDelegate(WinEventProc);
-
-            _pollingTimer = new DispatcherTimer { Interval = TimeSpan.FromMilliseconds(200) };
-            _pollingTimer.Tick += (_, _) =>
-            {
-                if (_currentForeground != IntPtr.Zero && _currentForeground != _selfHwnd)
-                    _onWindowChanged?.Invoke(_currentForeground);
-            };
-        }
-
-        public void Start()
-        {
-            // Hook: foreground changes and minimize end
-            _hooks.Add(
-                SetWinEventHook(
-                    EVENT_SYSTEM_FOREGROUND,
-                    EVENT_SYSTEM_MINIMIZEEND,
-                    IntPtr.Zero,
-                    _winEventDelegate,
-                    0,
-                    0,
-                    WINEVENT_OUTOFCONTEXT
-                )
-            );
-
-            // Hook: window move/resize (location change)
-            _hooks.Add(
-                SetWinEventHook(
-                    EVENT_OBJECT_LOCATIONCHANGE,
-                    EVENT_OBJECT_LOCATIONCHANGE,
-                    IntPtr.Zero,
-                    _winEventDelegate,
-                    0,
-                    0,
-                    WINEVENT_OUTOFCONTEXT
-                )
-            );
-
-            _pollingTimer.Start();
-        }
-
-        public void Stop()
-        {
-            foreach (var hook in _hooks)
-                UnhookWinEvent(hook);
-
-            _hooks.Clear();
-            _pollingTimer.Stop();
-        }
-
-        private void WinEventProc(
-            IntPtr hWinEventHook,
-            uint eventType,
-            IntPtr hwnd,
-            int idObject,
-            int idChild,
-            uint dwEventThread,
-            uint dwmsEventTime
-        )
-        {
-            if (hwnd == IntPtr.Zero || hwnd == _selfHwnd)
-                return;
-
-            var now = DateTime.Now;
-            if ((now - _lastEventTime).TotalMilliseconds < ThrottleIntervalMs)
-                return;
-
-            _lastEventTime = now;
-
-            if (eventType == EVENT_SYSTEM_FOREGROUND)
-            {
-                _currentForeground = hwnd;
-                _onWindowChanged?.Invoke(hwnd);
-            }
-            else if (
-                (eventType == EVENT_OBJECT_LOCATIONCHANGE || eventType == EVENT_SYSTEM_MINIMIZEEND)
-                && hwnd == _currentForeground
-            )
-            {
-                _onWindowChanged?.Invoke(hwnd);
-            }
-        }
-
-        #region WinAPI
-        private delegate void WinEventDelegate(
-            IntPtr hWinEventHook,
-            uint eventType,
-            IntPtr hwnd,
-            int idObject,
-            int idChild,
-            uint dwEventThread,
-            uint dwmsEventTime
-        );
-
-        [DllImport("user32.dll")]
-        private static extern IntPtr SetWinEventHook(
-            uint eventMin,
-            uint eventMax,
-            IntPtr hmodWinEventProc,
-            WinEventDelegate lpfnWinEventProc,
-            uint idProcess,
-            uint idThread,
-            uint dwFlags
-        );
-
-        [DllImport("user32.dll")]
-        private static extern bool UnhookWinEvent(IntPtr hWinEventHook);
-        #endregion
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/ImageHelper.cs

@@ -1,13 +1,17 @@
-using System;
+// 2025/6/23 by Zhe Fang
+
+using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
+using System.Numerics;
 using System.Runtime.InteropServices.WindowsRuntime;
 using System.Threading.Tasks;
-using Microsoft.UI.Xaml.Media;
+using Microsoft.Graphics.Canvas;
+using Microsoft.Graphics.Canvas.Text;
+using Microsoft.UI;
 using Microsoft.UI.Xaml.Media.Imaging;
 using Windows.Graphics.Imaging;
-using Windows.Storage;
 using Windows.Storage.Streams;
 using Windows.UI;
 
@@ -15,33 +19,7 @@ namespace BetterLyrics.WinUI3.Helper
 {
     public class ImageHelper
     {
-        private static readonly ColorThief _colorThief = new();
-        public const int AccentColorCount = 3;
-
-        public static async Task<InMemoryRandomAccessStream> GetStreamFromBytesAsync(
-            byte[] imageBytes
-        )
-        {
-            if (imageBytes == null || imageBytes.Length == 0)
-                return null;
-
-            InMemoryRandomAccessStream stream = new InMemoryRandomAccessStream();
-            await stream.WriteAsync(imageBytes.AsBuffer());
-
-            return stream;
-        }
-
-        public static async Task<BitmapImage> GetBitmapImageFromBytesAsync(byte[] imageBytes)
-        {
-            var stream = new InMemoryRandomAccessStream();
-            await stream.WriteAsync(imageBytes.AsBuffer());
-            stream.Seek(0);
-
-            var bitmapImage = new BitmapImage();
-            await bitmapImage.SetSourceAsync(stream);
-
-            return bitmapImage;
-        }
+        private const int _accentColorCount = 1;
 
         public static async Task<InMemoryRandomAccessStream> ByteArrayToStream(byte[] bytes)
         {
@@ -52,6 +30,140 @@ namespace BetterLyrics.WinUI3.Helper
             return stream;
         }
 
+        public static async Task<byte[]> CreateTextPlaceholderBytesAsync(string text, int width, int height)
+        {
+            var device = CanvasDevice.GetSharedDevice();
+            var renderTarget = new CanvasRenderTarget(device, width, height, 96);
+
+            // 居中绘制文字
+            using (var ds = renderTarget.CreateDrawingSession())
+            {
+                // 背景色
+                ds.Clear(Colors.LightGray);
+
+                // 文字格式
+                var format = new CanvasTextFormat
+                {
+                    FontSize = Math.Min(width, height) / 6f,
+                    FontWeight = Microsoft.UI.Text.FontWeights.SemiBold,
+                    HorizontalAlignment = CanvasHorizontalAlignment.Center,
+                    VerticalAlignment = CanvasVerticalAlignment.Center,
+                    WordWrapping = CanvasWordWrapping.Wrap,
+                    TrimmingGranularity = CanvasTextTrimmingGranularity.Character,
+                    Options = CanvasDrawTextOptions.Default,
+                };
+
+                // 设定边距
+                float margin = Math.Min(width, height) / 12f;
+                float availableWidth = width - 2 * margin;
+                float availableHeight = height - 2 * margin;
+
+                // 计算合适的字体大小以适应内容区域
+                float fontSize = format.FontSize;
+                float minFontSize = 8f;
+                float maxFontSize = format.FontSize;
+                CanvasTextLayout layout;
+                do
+                {
+                    format.FontSize = fontSize;
+                    layout = new CanvasTextLayout(
+                        ds,
+                        text,
+                        format,
+                        availableWidth,
+                        availableHeight
+                    );
+                    if (
+                        layout.LayoutBounds.Width <= availableWidth
+                        && layout.LayoutBounds.Height <= availableHeight
+                    )
+                        break;
+                    fontSize -= 1f;
+                } while (fontSize >= minFontSize);
+
+                // 居中绘制文字（在内容区域内居中）
+                var bounds = layout.LayoutBounds;
+                var x = margin + (availableWidth - (float)bounds.Width) / 2f - (float)bounds.X;
+                var y = margin + (availableHeight - (float)bounds.Height) / 2f - (float)bounds.Y;
+                ds.DrawTextLayout(layout, new Vector2(x, y), Colors.DarkGray);
+            }
+
+            // 保存为 PNG 并转为 byte[]
+            using (var stream = new InMemoryRandomAccessStream())
+            {
+                await renderTarget.SaveAsync(stream, CanvasBitmapFileFormat.Png);
+                var buffer = new byte[stream.Size];
+                using (var reader = new DataReader(stream.GetInputStreamAt(0)))
+                {
+                    await reader.LoadAsync((uint)stream.Size);
+                    reader.ReadBytes(buffer);
+                }
+                return buffer;
+            }
+        }
+
+        public static List<Color> GetAccentColorsFromByte(byte[] bytes)
+        {
+            // 使用 ImageSharp 读取图片
+            using var image = SixLabors.ImageSharp.Image.Load<SixLabors.ImageSharp.PixelFormats.Rgba32>(bytes);
+
+            // 简单聚类法：统计所有像素出现频率，取出现最多的前 AccentColorCount 个颜色
+            var colorCount = new Dictionary<SixLabors.ImageSharp.PixelFormats.Rgba32, int>();
+
+            for (int y = 0; y < image.Height; y++)
+            {
+                for (int x = 0; x < image.Width; x++)
+                {
+                    var color = image[x, y];
+                    // 可选：忽略透明像素
+                    if (color.A < 32) continue;
+                    if (colorCount.ContainsKey(color))
+                        colorCount[color]++;
+                    else
+                        colorCount[color] = 1;
+                }
+            }
+
+            // 按出现次数排序，取前 AccentColorCount 个
+            var topColors = colorCount
+                .OrderByDescending(kv => kv.Value)
+                .Take(_accentColorCount)
+                .Select(kv => kv.Key)
+                .ToList();
+
+            // 转换为 Windows.UI.Color
+            return topColors
+                .Select(c => Windows.UI.Color.FromArgb(c.A, c.R, c.G, c.B))
+                .ToList();
+        }
+
+
+        //public static async Task<BitmapImage> GetBitmapImageFromBytesAsync(byte[] imageBytes)
+        //{
+        //    var stream = new InMemoryRandomAccessStream();
+        //    await stream.WriteAsync(imageBytes.AsBuffer());
+        //    stream.Seek(0);
+
+        //    var bitmapImage = new BitmapImage();
+        //    await bitmapImage.SetSourceAsync(stream);
+
+        //    return bitmapImage;
+        //}
+
+        //public static async Task<BitmapDecoder> GetDecoderFromByte(byte[] bytes) =>
+        //    await BitmapDecoder.CreateAsync(await ByteArrayToStream(bytes));
+
+        //public static async Task<InMemoryRandomAccessStream> GetStreamFromBytesAsync(byte[] imageBytes)
+        //{
+        //    if (imageBytes == null || imageBytes.Length == 0)
+        //        return null;
+
+        //    InMemoryRandomAccessStream stream = new InMemoryRandomAccessStream();
+        //    await stream.WriteAsync(imageBytes.AsBuffer());
+
+        //    return stream;
+        //}
+
         public static async Task<byte[]> ToByteArrayAsync(IRandomAccessStreamReference streamRef)
         {
             using IRandomAccessStream stream = await streamRef.OpenReadAsync();
@@ -60,16 +172,21 @@ namespace BetterLyrics.WinUI3.Helper
             return memoryStream.ToArray();
         }
 
-        public static async Task<List<Color>> GetAccentColorsFromByte(byte[] bytes) =>
-            [
-                .. (
-                    await _colorThief.GetPalette(await GetDecoderFromByte(bytes), AccentColorCount)
-                ).Select(color =>
-                    Color.FromArgb(color.Color.A, color.Color.R, color.Color.G, color.Color.B)
-                ),
-            ];
-
-        public static async Task<BitmapDecoder> GetDecoderFromByte(byte[] bytes) =>
-            await BitmapDecoder.CreateAsync(await ByteArrayToStream(bytes));
+        public static float GetAverageLuminance(CanvasBitmap bitmap)
+        {
+            var pixels = bitmap.GetPixelBytes();
+            double sum = 0;
+            for (int i = 0; i < pixels.Length; i += 4)
+            {
+                // BGRA
+                byte b = pixels[i];
+                byte g = pixels[i + 1];
+                byte r = pixels[i + 2];
+                // 忽略A
+                double y = 0.299 * r + 0.587 * g + 0.114 * b;
+                sum += y / 255.0;
+            }
+            return (float)(sum / (pixels.Length / 4));
+        }
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/LanguageHelper.cs

@@ -0,0 +1,117 @@
+using BetterLyrics.WinUI3.Helper;
+using CommunityToolkit.Mvvm.DependencyInjection;
+using Lyricify.Lyrics.Helpers.General;
+using NTextCat;
+using System;
+using System.Collections.Generic;
+using System.Globalization;
+using System.Linq;
+
+namespace BetterLyrics.WinUI3.Services
+{
+    public class LanguageHelper
+    {
+        private static readonly RankedLanguageIdentifierFactory _factory = new();
+        private static readonly RankedLanguageIdentifier _identifier;
+        private static readonly ISettingsService _settingsService = Ioc.Default.GetRequiredService<ISettingsService>();
+
+        public static List<Models.LanguageInfo> SupportedTargetLanguages =>
+        [
+            new Models.LanguageInfo("ar", "العربية"),
+            new Models.LanguageInfo("az", "Azərbaycan dili"),
+            new Models.LanguageInfo("zh-Hans", "简体中文"),
+            new Models.LanguageInfo("zh-Hant", "繁體中文"),
+            new Models.LanguageInfo("cs", "Čeština"),
+            new Models.LanguageInfo("da", "Dansk"),
+            new Models.LanguageInfo("nl", "Nederlands"),
+            new Models.LanguageInfo("en", "English"),
+            new Models.LanguageInfo("eo", "Esperanto"),
+            new Models.LanguageInfo("fi", "Suomi"),
+            new Models.LanguageInfo("fr", "Français"),
+            new Models.LanguageInfo("de", "Deutsch"),
+            new Models.LanguageInfo("el", "Ελληνικά"),
+            new Models.LanguageInfo("he", "עברית"),
+            new Models.LanguageInfo("hi", "हिन्दी"),
+            new Models.LanguageInfo("hu", "Magyar"),
+            new Models.LanguageInfo("id", "Bahasa Indonesia"),
+            new Models.LanguageInfo("ga", "Gaeilge"),
+            new Models.LanguageInfo("it", "Italiano"),
+            new Models.LanguageInfo("ja", "日本語"),
+            new Models.LanguageInfo("ko", "한국어"),
+            new Models.LanguageInfo("fa", "فارسی"),
+            new Models.LanguageInfo("pl", "Polski"),
+            new Models.LanguageInfo("pt", "Português"),
+            new Models.LanguageInfo("ru", "Русский"),
+            new Models.LanguageInfo("sk", "Slovenčina"),
+            new Models.LanguageInfo("es", "Español"),
+            new Models.LanguageInfo("sv", "Svenska"),
+            new Models.LanguageInfo("tr", "Türkçe"),
+            new Models.LanguageInfo("uk", "Українська"),
+            new Models.LanguageInfo("vi", "Tiếng Việt"),
+        ];
+
+        static LanguageHelper()
+        {
+            _identifier = _factory.Load(PathHelper.LanguageProfilePath);
+        }
+
+        private static string? ThreeLetterToTwoLetter(string? threeLetterCode)
+        {
+            if (threeLetterCode == null) return null;
+
+            foreach (var ci in CultureInfo.GetCultures(CultureTypes.AllCultures))
+            {
+                if (string.Equals(ci.ThreeLetterISOLanguageName, threeLetterCode, StringComparison.OrdinalIgnoreCase))
+                {
+                    return ci.TwoLetterISOLanguageName;
+                }
+            }
+            return null;
+        }
+
+        public static string? DetectLanguageCode(string? text)
+        {
+            if (text == null) return null;
+
+            string? code = ThreeLetterToTwoLetter(_identifier.Identify(text).FirstOrDefault()?.Item1.Iso639_2T);
+            if (code != null && code == "zh")
+            {
+                if (ChineseConverter.ConvertToTraditionalChinese(text) == text)
+                {
+                    return "zh-Hant";
+                }
+                else
+                {
+                    return "zh-Hans";
+                }
+            }
+            return code;
+        }
+
+        public static bool IsCJK(string text)
+        {
+            return DetectLanguageCode(text) switch
+            {
+                "zh" or "ja" or "ko" => true,
+                _ => false
+            };
+        }
+
+        public static string DetectCountryCode(string? text)
+        {
+            if (text == null) return "en";
+            var code = DetectLanguageCode(text);
+            if (code == null) return "en";
+            // 处理中文简体和繁体
+            if (code == "zh-Hans") return "cn";
+            if (code == "zh-Hant") return "cn";
+            // 其他语言直接返回两字母代码
+            return code;
+        }
+
+        public static string GetUserTargetLanguageCode()
+        {
+            return SupportedTargetLanguages[_settingsService.SelectedTargetLanguageIndex].Code;
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/LatestOnlyTaskRunner.cs

@@ -0,0 +1,31 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Helper
+{
+    public class LatestOnlyTaskRunner
+    {
+        private CancellationTokenSource? _cts;
+
+        public async Task RunAsync(Func<CancellationToken, Task> func)
+        {
+            _cts?.Cancel();
+            _cts = new CancellationTokenSource();
+            var token = _cts.Token;
+            try
+            {
+                await func(token);
+            }
+            catch (OperationCanceledException) { }
+        }
+
+        public void Cancel()
+        {
+            _cts?.Cancel();
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/LyricsParser.cs

@@ -0,0 +1,434 @@
+// 2025/6/23 by Zhe Fang
+
+using BetterLyrics.WinUI3.Enums;
+using BetterLyrics.WinUI3.Models;
+using BetterLyrics.WinUI3.Services;
+using Lyricify.Lyrics.Models;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text.RegularExpressions;
+using System.Xml.Linq;
+using Windows.Globalization.Fonts;
+using LyricsData = BetterLyrics.WinUI3.Models.LyricsData;
+
+namespace BetterLyrics.WinUI3.Helper
+{
+    public class LyricsParser
+    {
+        private List<LyricsData> _lyricsDataArr = [];
+
+        public List<LyricsData> Parse(string? raw, int? durationMs)
+        {
+            durationMs ??= (int)TimeSpan.FromMinutes(99).TotalMilliseconds;
+            _lyricsDataArr = [];
+            if (raw == null)
+            {
+                _lyricsDataArr.Add(LyricsData.GetNotfoundPlaceholder(durationMs.Value));
+            }
+            else
+            {
+                switch (raw.DetectFormat())
+                {
+                    case LyricsFormat.Lrc:
+                    case LyricsFormat.Eslrc:
+                        ParseLrc(raw);
+                        break;
+                    case LyricsFormat.Qrc:
+                        ParseQQNeteaseKugou(Lyricify.Lyrics.Parsers.QrcParser.Parse(raw).Lines);
+                        break;
+                    case LyricsFormat.Krc:
+                        ParseQQNeteaseKugou(Lyricify.Lyrics.Parsers.KrcParser.Parse(raw).Lines);
+                        break;
+                    case LyricsFormat.Ttml:
+                        ParseTtml(raw);
+                        break;
+                    default:
+                        break;
+                }
+            }
+            PostProcessLyricsLines(durationMs.Value);
+            return _lyricsDataArr;
+        }
+
+        private void ParseLrc(string raw)
+        {
+            var lines = raw.Split(["\r\n", "\n"], StringSplitOptions.RemoveEmptyEntries);
+            var lrcLines =
+                new List<(int time, string text, List<(int time, string text)> syllables)>();
+
+            // 支持 [mm:ss.xx]字、<mm:ss.xx>字，毫秒两位或三位
+            var syllableRegex = new Regex(
+                @"(\[|\<)(\d{2}):(\d{2})\.(\d{2,3})(\]|\>)([^\[\]\<\>]*)"
+            );
+
+            foreach (var line in lines)
+            {
+                var matches = syllableRegex.Matches(line);
+                var syllables = new List<(int, string)>();
+                for (int i = 0; i < matches.Count; i++)
+                {
+                    var m = matches[i];
+                    int min = int.Parse(m.Groups[2].Value);
+                    int sec = int.Parse(m.Groups[3].Value);
+                    int ms = int.Parse(m.Groups[4].Value.PadRight(3, '0'));
+                    int totalMs = min * 60_000 + sec * 1000 + ms;
+                    string text = m.Groups[6].Value;
+
+                    syllables.Add((totalMs, text));
+                }
+                if (syllables.Count > 0)
+                {
+                    lrcLines.Add(
+                        (
+                            syllables[0].Item1,
+                            string.Concat(syllables.Select(s => s.Item2)),
+                            syllables
+                        )
+                    );
+                }
+                else
+                {
+                    // 普通LRC行
+                    var bracketRegex = new Regex(@"\[(\d{2}):(\d{2})\.(\d{2,3})\]");
+                    var bracketMatches = bracketRegex.Matches(line);
+                    string content = line;
+                    int? lineStartTime = null;
+                    if (bracketMatches.Count > 0)
+                    {
+                        var m = bracketMatches[0];
+                        int min = int.Parse(m.Groups[1].Value);
+                        int sec = int.Parse(m.Groups[2].Value);
+                        int ms = int.Parse(m.Groups[3].Value.PadRight(3, '0'));
+                        lineStartTime = min * 60_000 + sec * 1000 + ms;
+                        content = bracketRegex.Replace(line, "");
+                        lrcLines.Add((lineStartTime.Value, content, new List<(int, string)>()));
+                    }
+                }
+            }
+
+            // 按时间分组
+            var grouped = lrcLines.GroupBy(l => l.time).OrderBy(g => g.Key).ToList();
+            int languageCount = grouped.Max(g => g.Count());
+
+            // 初始化每种语言的歌词列表
+            _lyricsDataArr.Clear();
+            for (int i = 0; i < languageCount; i++)
+                _lyricsDataArr.Add(new LyricsData());
+
+            // 遍历每个时间分组
+            foreach (var group in grouped)
+            {
+                var linesInGroup = group.ToList();
+                for (int langIdx = 0; langIdx < languageCount; langIdx++)
+                {
+                    // 如果该语言有翻译，取对应行，否则用原文（第一行）
+                    var (start, text, syllables) =
+                        langIdx < linesInGroup.Count ? linesInGroup[langIdx] : linesInGroup[0];
+                    var line = new LyricsLine
+                    {
+                        StartMs = start,
+                        EndMs = 0, // 稍后统一修正
+                        OriginalText = text,
+                        CharTimings = [],
+                    };
+                    if (syllables != null && syllables.Count > 0)
+                    {
+                        int currentIndex = 0;
+                        for (int j = 0; j < syllables.Count; j++)
+                        {
+                            var (charStart, charText) = syllables[j];
+                            int startIndex = currentIndex;
+                            line.CharTimings.Add(
+                                new CharTiming
+                                {
+                                    StartMs = charStart,
+                                    EndMs = 0, // Fixed later
+                                    Text = charText ?? "",
+                                    StartIndex = startIndex,
+                                }
+                            );
+                            currentIndex += charText?.Length ?? 0;
+                        }
+                    }
+                    _lyricsDataArr[langIdx].LyricsLines.Add(line);
+                }
+            }
+        }
+
+        private void ParseTtml(string raw)
+        {
+            try
+            {
+                List<LyricsLine> originalLines = [];
+                List<LyricsLine> translationLines = [];
+                var xdoc = XDocument.Parse(raw);
+                var body = xdoc.Descendants().FirstOrDefault(e => e.Name.LocalName == "body");
+                if (body == null) return;
+                var ps = body.Descendants().Where(e => e.Name.LocalName == "p");
+                foreach (var p in ps)
+                {
+                    // 句级时间
+                    string? pBegin = p.Attribute("begin")?.Value;
+                    int pStartMs = ParseTtmlTime(pBegin);
+
+                    // 只获取一级span，且排除ttm:role="x-bg"的span
+                    var spans = p.Elements()
+                        .Where(s => s.Name.LocalName == "span" &&
+                                    s.Attribute(XName.Get("role", "http://www.w3.org/ns/ttml#metadata"))?.Value != "x-bg")
+                        .ToList();
+
+                    // 原文和翻译分离
+                    var originalTextSpans = spans
+                        .Where(s => s.Attribute(XName.Get("role", "http://www.w3.org/ns/ttml#metadata"))?.Value != "x-translation")
+                        .ToList();
+                    var translationTextSpans = spans
+                        .Where(s => s.Attribute(XName.Get("role", "http://www.w3.org/ns/ttml#metadata"))?.Value == "x-translation")
+                        .ToList();
+
+                    // 原文（非 CJK 语言添加空格）
+                    string originalText = string.Concat(originalTextSpans.Select(s => s.Value));
+                    if (!LanguageHelper.IsCJK(originalText))
+                    {
+                        foreach (var span in originalTextSpans)
+                        {
+                            span.Value += " ";
+                        }
+                        originalText = string.Concat(originalTextSpans.Select(s => s.Value));
+                    }
+
+                    var originalCharTimings = new List<CharTiming>();
+                    int originalStartIndex = 0;
+                    foreach (var span in originalTextSpans)
+                    {
+                        string? sBegin = span.Attribute("begin")?.Value;
+                        int sStartMs = ParseTtmlTime(sBegin);
+                        originalCharTimings.Add(new CharTiming
+                        {
+                            StartMs = sStartMs,
+                            EndMs = 0,
+                            StartIndex = originalStartIndex,
+                            Text = span.Value
+                        });
+                        originalStartIndex += span.Value.Length;
+                    }
+                    if (originalTextSpans.Count == 0)
+                        originalText = p.Value;
+
+                    originalLines.Add(new LyricsLine
+                    {
+                        StartMs = pStartMs,
+                        EndMs = 0,
+                        OriginalText = originalText,
+                        CharTimings = originalCharTimings,
+                    });
+
+                    // 翻译
+                    string translationText = string.Concat(translationTextSpans.Select(s => s.Value));
+                    var translationCharTimings = new List<CharTiming>();
+                    int translationStartIndex = 0;
+                    foreach (var span in translationTextSpans)
+                    {
+                        string? sBegin = span.Attribute("begin")?.Value;
+                        int sStartMs = ParseTtmlTime(sBegin);
+                        translationCharTimings.Add(new CharTiming
+                        {
+                            StartMs = sStartMs,
+                            EndMs = 0,
+                            StartIndex = translationStartIndex,
+                            Text = span.Value
+                        });
+                        translationStartIndex += span.Value.Length;
+                    }
+                    if (translationTextSpans.Count > 0)
+                    {
+                        translationLines.Add(new LyricsLine
+                        {
+                            StartMs = pStartMs,
+                            EndMs = 0,
+                            OriginalText = translationText,
+                            CharTimings = translationCharTimings,
+                        });
+                    }
+                }
+                _lyricsDataArr.Add(new LyricsData(originalLines));
+                if (translationLines.Count > 0)
+                    _lyricsDataArr.Add(new LyricsData(translationLines));
+            }
+            catch
+            {
+                // 解析失败，忽略
+            }
+        }
+
+        private static int ParseTtmlTime(string? t)
+        {
+            if (string.IsNullOrWhiteSpace(t))
+                return 0;
+
+            t = t.Trim();
+
+            // 支持 "1.000s"
+            if (t.EndsWith("s"))
+            {
+                if (
+                    double.TryParse(
+                        t.TrimEnd('s'),
+                        System.Globalization.NumberStyles.Float,
+                        System.Globalization.CultureInfo.InvariantCulture,
+                        out double seconds
+                    )
+                )
+                    return (int)(seconds * 1000);
+            }
+            else
+            {
+                var parts = t.Split(':');
+                if (parts.Length == 3)
+                {
+                    // hh:mm:ss.xxx
+                    int h = int.Parse(parts[0]);
+                    int m = int.Parse(parts[1]);
+                    double s = double.Parse(
+                        parts[2],
+                        System.Globalization.CultureInfo.InvariantCulture
+                    );
+                    return (int)((h * 3600 + m * 60 + s) * 1000);
+                }
+                else if (parts.Length == 2)
+                {
+                    // mm:ss.xxx
+                    int m = int.Parse(parts[0]);
+                    double s = double.Parse(
+                        parts[1],
+                        System.Globalization.CultureInfo.InvariantCulture
+                    );
+                    return (int)((m * 60 + s) * 1000);
+                }
+                else if (parts.Length == 1)
+                {
+                    // ss.xxx
+                    if (
+                        double.TryParse(
+                            parts[0],
+                            System.Globalization.NumberStyles.Float,
+                            System.Globalization.CultureInfo.InvariantCulture,
+                            out double s
+                        )
+                    )
+                        return (int)(s * 1000);
+                }
+            }
+            return 0;
+        }
+
+        private void ParseQQNeteaseKugou(List<ILineInfo>? lines)
+        {
+            lines = lines?.Where(x => x.Text != string.Empty).ToList();
+            List<LyricsLine> lyricsLines = [];
+
+            if (lines != null && lines.Count > 0)
+            {
+                lyricsLines = [];
+                for (int lineIndex = 0; lineIndex < lines.Count; lineIndex++)
+                {
+                    var lineRead = lines[lineIndex];
+                    var lineWrite = new LyricsLine
+                    {
+                        StartMs = lineRead.StartTime ?? 0,
+                        EndMs = 0,
+                        OriginalText = lineRead.Text,
+                        CharTimings = [],
+                    };
+
+                    var syllables = (lineRead as SyllableLineInfo)?.Syllables;
+                    if (syllables != null)
+                    {
+                        int startIndex = 0;
+                        for (
+                            int syllableIndex = 0;
+                            syllableIndex < syllables.Count;
+                            syllableIndex++
+                        )
+                        {
+                            var syllable = syllables[syllableIndex];
+                            var charTiming = new CharTiming
+                            {
+                                StartMs = syllable.StartTime,
+                                EndMs = 0,
+                                Text = syllable.Text,
+                                StartIndex = startIndex,
+                            };
+                            if (syllableIndex + 1 < syllables.Count)
+                            {
+                                charTiming.EndMs = syllables[syllableIndex + 1].StartTime;
+                            }
+                            else
+                            {
+                                charTiming.EndMs = lineWrite.EndMs;
+                            }
+                            lineWrite.CharTimings.Add(charTiming);
+                            startIndex += syllable.Text.Length;
+                        }
+                    }
+
+                    lyricsLines.Add(lineWrite);
+                }
+            }
+
+            _lyricsDataArr.Add(new LyricsData(lyricsLines));
+        }
+
+        private void PostProcessLyricsLines(int durationMs)
+        {
+            for (int langIdx = 0; langIdx < _lyricsDataArr.Count; langIdx++)
+            {
+                var lines = _lyricsDataArr[langIdx].LyricsLines;
+                for (int i = 0; i < lines.Count; i++)
+                {
+                    if (i + 1 < lines.Count)
+                    {
+                        lines[i].EndMs = lines[i + 1].StartMs;
+                    }
+                    else
+                    {
+                        lines[i].EndMs = durationMs;
+                    }
+
+                    // 修正 CharTimings 的 EndMs
+                    var timings = lines[i].CharTimings;
+                    if (timings.Count > 0)
+                    {
+                        for (int j = 0; j < timings.Count; j++)
+                        {
+                            if (j + 1 < timings.Count)
+                            {
+                                timings[j].EndMs = timings[j + 1].StartMs;
+                            }
+                            else
+                            {
+                                timings[j].EndMs = lines[i].EndMs;
+                            }
+                        }
+                    }
+                }
+                if (lines.Count > 0)
+                {
+                    if (lines[0].StartMs > 0)
+                    {
+                        lines.Insert(
+                            0,
+                            new LyricsLine
+                            {
+                                StartMs = 0,
+                                EndMs = lines[0].StartMs,
+                                OriginalText = "● ● ●",
+                                CharTimings = [],
+                            }
+                        );
+                    }
+                }
+            }
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/MetadataHelper.cs

@@ -0,0 +1,47 @@
+// 2025/6/23 by Zhe Fang
+
+namespace BetterLyrics.WinUI3.Helper
+{
+    using BetterLyrics.WinUI3.Models;
+    using System;
+    using System.Collections.Generic;
+    using System.IO;
+    using System.Reflection;
+    using System.Threading.Tasks;
+    using Windows.ApplicationModel;
+    using Windows.Storage;
+    using Windows.Storage.FileProperties;
+
+    public static class MetadataHelper
+    {
+        public const string AppAuthor = "Zhe Fang";
+        public const string AppDisplayName = "Better Lyrics";
+        public const string AppName = "BetterLyrics";
+        public static string AppVersion
+        {
+            get
+            {
+                var version = Package.Current.Id.Version;
+                return $"{version.Major}.{version.Minor}.{version.Build}.{version.Revision}";
+            }
+        }
+
+        public const string GithubUrl = "https://github.com/jayfunc/BetterLyrics";
+        public const string QQGroupUrl = "https://qun.qq.com/universal-share/share?ac=1&authKey=4Q%2BYTq3wZldYpF5SbS5c19ECFsiYoLZFAIcBNNzYpBUtiEjaZ8sZ%2F%2BnFN0qw3lad&busi_data=eyJncm91cENvZGUiOiIxMDU0NzAwMzg4IiwidG9rZW4iOiJiVnhqemVYN0N5QVc3b1ZkR24wWmZOTUtvUkJoWm1JRWlaWW5iZnlBcXJtZUtGc2FFTHNlUlFZMi9iRm03cWF5IiwidWluIjoiMTM5NTczOTY2MCJ9&data=39UmAihyH_o6CZaOs7nk2mO_lz2ruODoDou6pxxh7utcxP4WF5sbDBDOPvZ_Wqfzeey4441anegsLYQJxkrBAA&svctype=4&tempid=h5_group_info";
+        public const string DiscordUrl = "https://discord.gg/5yAQPnyCKv";
+
+        public static async Task<DateTime> GetBuildDate()
+        {
+            var assembly = Assembly.GetExecutingAssembly();
+            var filePath = assembly.Location;
+            if (!File.Exists(filePath))
+                return DateTime.MinValue;
+
+            StorageFile file = await StorageFile.GetFileFromPathAsync(filePath);
+            // 获取文件基本属性
+            BasicProperties props = await file.GetBasicPropertiesAsync();
+            // 返回修改日期
+            return props.DateModified.DateTime;
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/PathHelper.cs

@@ -0,0 +1,56 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using Windows.ApplicationModel;
+using Windows.Storage;
+
+namespace BetterLyrics.WinUI3.Helper
+{
+    public class PathHelper
+    {
+        private static string LocalFolder => ApplicationData.Current.LocalFolder.Path;
+        public static string CacheFolder => ApplicationData.Current.LocalCacheFolder.Path;
+        public static string AssetsFolder => Path.Combine(Package.Current.InstalledPath, "Assets");
+
+        public static string LanguageProfilePath => Path.Combine(AssetsFolder, "Core14.profile.xml");
+
+        public static string LogDirectory => Path.Combine(CacheFolder, "logs");
+        public static string LogFilePattern => Path.Combine(LogDirectory, "log-.txt");
+
+        public static string LyricsCacheDirectory => Path.Combine(CacheFolder, "lyrics");
+
+        public static string LrcLibLyricsCacheDirectory => Path.Combine(LyricsCacheDirectory, "lrclib");
+        public static string NeteaseLyricsCacheDirectory => Path.Combine(LyricsCacheDirectory, "netease");
+        public static string QQLyricsCacheDirectory => Path.Combine(LyricsCacheDirectory, "qq");
+        public static string KugouLyricsCacheDirectory => Path.Combine(LyricsCacheDirectory, "kugou");
+        public static string AmllTtmlDbLyricsCacheDirectory => Path.Combine(LyricsCacheDirectory, "amll-ttml-db");
+        public static string AmllTtmlDbIndexPath => Path.Combine(LyricsCacheDirectory, "amll-ttml-db-index.json");
+        public static string AmllTtmlDbLastUpdatedPath => Path.Combine(LyricsCacheDirectory, "amll-ttml-db-last-updated.txt");
+
+        public static string TranslationCacheDirectory => Path.Combine(CacheFolder, "translations");
+
+        public static string QQTranslationCacheDirectory => Path.Combine(TranslationCacheDirectory, "qq");
+
+        public static string AlbumArtCacheDirectory => Path.Combine(CacheFolder, "album-art");
+
+        public static string iTunesAlbumArtCacheDirectory => Path.Combine(AlbumArtCacheDirectory, "itunes");
+
+        public static void EnsureDirectories()
+        {
+            Directory.CreateDirectory(LogDirectory);
+
+            Directory.CreateDirectory(LrcLibLyricsCacheDirectory);
+            Directory.CreateDirectory(QQLyricsCacheDirectory);
+            Directory.CreateDirectory(KugouLyricsCacheDirectory);
+            Directory.CreateDirectory(NeteaseLyricsCacheDirectory);
+            Directory.CreateDirectory(AmllTtmlDbLyricsCacheDirectory);
+
+            Directory.CreateDirectory(QQTranslationCacheDirectory);
+
+            Directory.CreateDirectory(iTunesAlbumArtCacheDirectory);
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/StringHelper.cs

@@ -0,0 +1,19 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Helper
+{
+    public static class StringHelper
+    {
+        // 去除空格、括号、下划线、横杠、点、大小写等
+        public static string Normalize(string s) =>
+            new string(s
+                .Where(c => char.IsLetterOrDigit(c))
+                .ToArray())
+                .ToLowerInvariant();
+        public static string NewLine = "\n";
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/SystemBackdropHelper.cs

@@ -1,4 +1,6 @@
-using BetterLyrics.WinUI3.Enums;
+// 2025/6/23 by Zhe Fang
+
+using BetterLyrics.WinUI3.Enums;
 using Microsoft.UI.Composition.SystemBackdrops;
 using Microsoft.UI.Xaml.Media;
 

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/ValueTransition.cs

@@ -0,0 +1,180 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using System.Diagnostics;
+using BetterLyrics.WinUI3.Enums;
+
+namespace BetterLyrics.WinUI3.Helper
+{
+    public class ValueTransition<T>
+        where T : struct
+    {
+        private T _currentValue;
+        private float _durationSeconds;
+        private EasingType? _easingType;
+        private Func<T, T, float, T> _interpolator;
+        private bool _isTransitioning;
+        private float _progress;
+        private T _startValue;
+        private T _targetValue;
+
+        public float DurationSeconds => _durationSeconds;
+
+        public bool IsTransitioning => _isTransitioning;
+        public T Value => _currentValue;
+        public T TargetValue => _targetValue;
+
+        public ValueTransition(T initialValue, float durationSeconds, Func<T, T, float, T>? interpolator = null, EasingType? easingType = null)
+        {
+            _currentValue = initialValue;
+            _startValue = initialValue;
+            _targetValue = initialValue;
+            _durationSeconds = durationSeconds;
+            _progress = 1f;
+            _isTransitioning = false;
+
+            if (interpolator != null)
+            {
+                _interpolator = interpolator;
+                _easingType = null;
+            }
+            else if (easingType.HasValue)
+            {
+                _easingType = easingType;
+                _interpolator = GetInterpolatorByEasingType(_easingType.Value);
+            }
+            else
+            {
+                _easingType = EasingType.Linear;
+                _interpolator = GetInterpolatorByEasingType(_easingType.Value);
+            }
+        }
+
+        public void SetDuration(float seconds)
+        {
+            if (seconds <= 0)
+                throw new ArgumentOutOfRangeException(nameof(seconds), "Duration must be positive.");
+            _durationSeconds = seconds;
+        }
+
+        private void JumpTo(T value)
+        {
+            _currentValue = value;
+            _startValue = value;
+            _targetValue = value;
+            _progress = 1f;
+            _isTransitioning = false;
+        }
+
+        public void Reset(T value)
+        {
+            _currentValue = value;
+            _startValue = value;
+            _targetValue = value;
+            _progress = 0f;
+            _isTransitioning = false;
+        }
+
+        public void StartTransition(T targetValue, bool jumpTo = false)
+        {
+            if (jumpTo)
+            {
+                JumpTo(targetValue);
+                return;
+            }
+
+            if (!targetValue.Equals(_currentValue))
+            {
+                _startValue = _currentValue;
+                _targetValue = targetValue;
+                _progress = 0f;
+                _isTransitioning = true;
+            }
+        }
+
+        public static bool Equals(double x, double y, double tolerance)
+        {
+            var diff = Math.Abs(x - y);
+            return diff <= tolerance || diff <= Math.Max(Math.Abs(x), Math.Abs(y)) * tolerance;
+        }
+
+        public void Update(TimeSpan elapsedTime)
+        {
+            if (!_isTransitioning) return;
+
+            _progress += (float)elapsedTime.TotalSeconds / _durationSeconds;
+            if (_progress >= 1f)
+            {
+                _progress = 1f;
+                _currentValue = _targetValue;
+                _isTransitioning = false;
+            }
+            else
+            {
+                _currentValue = _interpolator(_startValue, _targetValue, _progress);
+            }
+        }
+
+        private Func<T, T, float, T> GetInterpolatorByEasingType(EasingType type)
+        {
+            if (typeof(T) == typeof(float))
+            {
+                return (start, end, progress) =>
+                {
+                    float s = (float)(object)start;
+                    float e = (float)(object)end;
+                    float t = progress;
+                    switch (type)
+                    {
+                        case EasingType.EaseInOutSine:
+                            t = EasingHelper.EaseInOutSine(t);
+                            break;
+                        case EasingType.EaseInOutQuad:
+                            t = EasingHelper.EaseInOutQuad(t);
+                            break;
+                        case EasingType.EaseInOutCubic:
+                            t = EasingHelper.EaseInOutCubic(t);
+                            break;
+                        case EasingType.EaseInOutQuart:
+                            t = EasingHelper.EaseInOutQuart(t);
+                            break;
+                        case EasingType.EaseInOutQuint:
+                            t = EasingHelper.EaseInOutQuint(t);
+                            break;
+                        case EasingType.EaseInOutExpo:
+                            t = EasingHelper.EaseInOutExpo(t);
+                            break;
+                        case EasingType.EaseInOutCirc:
+                            t = EasingHelper.EaseInOutCirc(t);
+                            break;
+                        case EasingType.EaseInOutBack:
+                            t = EasingHelper.EaseInOutBack(t);
+                            break;
+                        case EasingType.EaseInOutElastic:
+                            t = EasingHelper.EaseInOutElastic(t);
+                            break;
+                        case EasingType.EaseInOutBounce:
+                            t = EasingHelper.EaseInOutBounce(t);
+                            break;
+                        case EasingType.SmoothStep:
+                            t = EasingHelper.SmoothStep(t);
+                            break;
+                        case EasingType.Linear:
+                            t = EasingHelper.Linear(t);
+                            break;
+                        default:
+                            break;
+                    }
+                    return (T)(object)(s + (e - s) * t);
+                };
+            }
+            throw new NotSupportedException($"Easing type {type} is not supported for type {typeof(T)}.");
+        }
+
+        public void SetEasingType(EasingType easingType)
+        {
+            _easingType = easingType;
+            _interpolator = GetInterpolatorByEasingType(easingType);
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/WindowColorHelper.cs

@@ -1,106 +0,0 @@
-using System;
-using System.Drawing;
-using System.Drawing.Imaging;
-using System.Runtime.InteropServices;
-
-namespace BetterLyrics.WinUI3.Helper
-{
-    public static class WindowColorHelper
-    {
-        public static Color GetDominantColorBelow(IntPtr myHwnd)
-        {
-            if (!GetWindowRect(myHwnd, out RECT myRect))
-                return Color.Transparent;
-
-            int screenWidth = GetSystemMetrics(SystemMetric.SM_CXSCREEN);
-            int sampleHeight = 1;
-            int sampleY = myRect.Bottom + 1;
-
-            return GetAverageColorFromScreenRegion(0, sampleY, screenWidth, sampleHeight);
-        }
-
-        private static Color GetAverageColorFromScreenRegion(int x, int y, int width, int height)
-        {
-            using Bitmap bmp = new(width, height, PixelFormat.Format32bppArgb);
-            using Graphics gDest = Graphics.FromImage(bmp);
-
-            IntPtr hdcDest = gDest.GetHdc();
-            IntPtr hdcSrc = GetDC(IntPtr.Zero); // Entire screen
-
-            BitBlt(hdcDest, 0, 0, width, height, hdcSrc, x, y, SRCCOPY);
-
-            gDest.ReleaseHdc(hdcDest);
-            ReleaseDC(IntPtr.Zero, hdcSrc);
-
-            return ComputeAverageColor(bmp);
-        }
-
-        private static Color ComputeAverageColor(Bitmap bmp)
-        {
-            long r = 0,
-                g = 0,
-                b = 0;
-            int count = 0;
-
-            for (int y = 0; y < bmp.Height; y++)
-            {
-                for (int x = 0; x < bmp.Width; x++)
-                {
-                    Color pixel = bmp.GetPixel(x, y);
-                    r += pixel.R;
-                    g += pixel.G;
-                    b += pixel.B;
-                    count++;
-                }
-            }
-
-            if (count == 0)
-                return Color.Transparent;
-            return Color.FromArgb((int)(r / count), (int)(g / count), (int)(b / count));
-        }
-
-        #region Win32 Imports & Structs
-        private const int SRCCOPY = 0x00CC0020;
-
-        [DllImport("user32.dll")]
-        private static extern bool GetWindowRect(IntPtr hWnd, out RECT lpRect);
-
-        [DllImport("user32.dll")]
-        private static extern IntPtr GetDC(IntPtr hWnd);
-
-        [DllImport("user32.dll")]
-        private static extern int ReleaseDC(IntPtr hWnd, IntPtr hDC);
-
-        [DllImport("gdi32.dll")]
-        private static extern bool BitBlt(
-            IntPtr hdcDest,
-            int nXDest,
-            int nYDest,
-            int nWidth,
-            int nHeight,
-            IntPtr hdcSrc,
-            int nXSrc,
-            int nYSrc,
-            int dwRop
-        );
-
-        [DllImport("user32.dll")]
-        private static extern int GetSystemMetrics(SystemMetric smIndex);
-
-        private enum SystemMetric
-        {
-            SM_CXSCREEN = 0,
-            SM_CYSCREEN = 1,
-        }
-
-        [StructLayout(LayoutKind.Sequential)]
-        private struct RECT
-        {
-            public int Left;
-            public int Top;
-            public int Right;
-            public int Bottom;
-        }
-        #endregion
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/WindowHelper.cs

@@ -1,8 +1,12 @@
-using System;
-using System.Collections.Generic;
+// 2025/6/23 by Zhe Fang
+
+using BetterLyrics.WinUI3.Enums;
 using BetterLyrics.WinUI3.Views;
 using Microsoft.UI.Windowing;
 using Microsoft.UI.Xaml;
+using System;
+using System.Collections.Generic;
+using Windows.ApplicationModel.Core;
 using WinRT.Interop;
 using WinUIEx;
 
@@ -10,124 +14,93 @@ namespace BetterLyrics.WinUI3.Helper
 {
     public static class WindowHelper
     {
-        private static readonly Dictionary<Type, Window> _windowCache = new();
+        private static List<object> _activeWindows = [];
 
-        public static void HideSystemTitleBar(this Window window)
+        public static void CloseWindow<T>()
         {
-            window.ExtendsContentIntoTitleBar = true;
-            window.AppWindow.TitleBar.PreferredHeightOption = TitleBarHeightOption.Collapsed;
-        }
-
-        public static void HideSystemTitleBarAndSetCustomTitleBar(
-            this Window window,
-            UIElement titleBar
-        )
-        {
-            window.HideSystemTitleBar();
-            window.SetTitleBar(titleBar);
-        }
-
-        public static void OpenSettingsWindow()
-        {
-            OpenOrShowWindow(typeof(SettingsPage));
-        }
-
-        public static void OpenLyricsWindow()
-        {
-            OpenOrShowWindow(typeof(LyricsPage));
-        }
-
-        private static void OpenOrShowWindow(Type pageType)
-        {
-            if (_windowCache.TryGetValue(pageType, out var window))
+            var window = _activeWindows.Find(w => w is T);
+            if (window is Window w)
             {
-                window.TryShow();
+                w.Close();
+                _activeWindows.Remove(w);
+            }
+        }
+
+        public static void ExitAllWindows()
+        {
+            while (_activeWindows.Count > 0)
+            {
+                var window = _activeWindows[0];
+                ((Window)window).Close();
+                _activeWindows.Remove(window);
+            }
+            App.Current.Exit();
+        }
+
+        public static T? GetWindowByWindowType<T>()
+        {
+            foreach (var window in _activeWindows)
+            {
+                if (window is T castedWindow)
+                {
+                    return castedWindow;
+                }
+            }
+            return default;
+        }
+        public static void OpenOrShowWindow<T>()
+        {
+            var window = _activeWindows.Find(w => w is T);
+            if (window != null)
+            {
+                var castedWindow = (Window)window;
+                castedWindow.Restore();
             }
             else
             {
-                var newWindow = new HostWindow();
-                TrackWindow(newWindow, pageType);
-                newWindow.ViewModel.FramePageType = pageType;
-                newWindow.Navigate(pageType);
-                newWindow.Activate();
+                object newWindow;
+                if (typeof(T) == typeof(LyricsWindow))
+                {
+                    newWindow = new LyricsWindow();
+                    ((LyricsWindow)newWindow).SystemBackdrop = SystemBackdropHelper.CreateSystemBackdrop(BackdropType.Transparent);
+                }
+                else if (typeof(T) == typeof(SettingsWindow))
+                {
+                    newWindow = new SettingsWindow();
+                }
+                else
+                {
+                    throw new ArgumentException("Unsupported window type", nameof(T));
+                }
+                ((Window)newWindow).Activate();
+                TrackWindow(newWindow);
             }
         }
 
-        public static void TrackWindow(Window window, Type pageType = null)
+        public static void RestartApp(string args = "")
         {
-            if (pageType != null)
-            {
-                _windowCache[pageType] = window;
-            }
+            // The restart will be executed immediately.
+            AppRestartFailureReason failureReason =
+                Microsoft.Windows.AppLifecycle.AppInstance.Restart(args);
 
+            // If the restart fails, handle it here.
+            switch (failureReason)
+            {
+                case AppRestartFailureReason.RestartPending:
+                    break;
+                case AppRestartFailureReason.NotInForeground:
+                    break;
+                case AppRestartFailureReason.InvalidUser:
+                    break;
+                default: //AppRestartFailureReason.Other
+                    break;
+            }
+        }
+
+        private static void TrackWindow(object window)
+        {
             if (!_activeWindows.Contains(window))
                 _activeWindows.Add(window);
         }
-
-        public static Window GetWindowForElement(UIElement element)
-        {
-            if (element.XamlRoot != null)
-            {
-                foreach (Window window in _activeWindows)
-                {
-                    if (element.XamlRoot == window.Content.XamlRoot)
-                    {
-                        return window;
-                    }
-                }
-            }
-            return null;
-        }
-
-        // get dpi for an element
-        static public double GetRasterizationScaleForElement(UIElement element)
-        {
-            if (element.XamlRoot != null)
-            {
-                foreach (Window window in _activeWindows)
-                {
-                    if (element.XamlRoot == window.Content.XamlRoot)
-                    {
-                        return element.XamlRoot.RasterizationScale;
-                    }
-                }
-            }
-            return 0.0;
-        }
-
-        public static List<Window> ActiveWindows
-        {
-            get { return _activeWindows; }
-        }
-
-        private static List<Window> _activeWindows = new List<Window>();
-
-        public static void TryShow(this Window window)
-        {
-            if (window is not null)
-            {
-                window.Activate();
-            }
-        }
-
-        public static void TryHide(this Window window)
-        {
-            if (window is not null)
-            {
-                window.Hide();
-            }
-        }
-
-        public static Window GetWindowByFramePageType(Type type)
-        {
-            foreach (var cachedWindow in _windowCache)
-            {
-                if (cachedWindow.Key == type)
-                {
-                    return cachedWindow.Value;
-                }
-            }
-            return null;
-        }
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Messages/ShowNotificatonMessage.cs

@@ -1,15 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-using BetterLyrics.WinUI3.Models;
-using CommunityToolkit.Mvvm.Messaging.Messages;
-using Microsoft.UI.Xaml;
-using Microsoft.UI.Xaml.Controls;
-
-namespace BetterLyrics.WinUI3.Messages
-{
-    public class ShowNotificatonMessage(Notification value)
-        : ValueChangedMessage<Notification>(value) { }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Models/AlbumArtSearchProviderInfo.cs

@@ -0,0 +1,24 @@
+// 2025/6/23 by Zhe Fang
+
+using BetterLyrics.WinUI3.Enums;
+using CommunityToolkit.Mvvm.ComponentModel;
+
+namespace BetterLyrics.WinUI3.Models
+{
+    public partial class AlbumArtSearchProviderInfo : ObservableObject
+    {
+        [ObservableProperty]
+        public partial bool IsEnabled { get; set; }
+
+        [ObservableProperty]
+        public partial AlbumArtSearchProvider Provider { get; set; }
+
+        public AlbumArtSearchProviderInfo() { }
+
+        public AlbumArtSearchProviderInfo(AlbumArtSearchProvider provider, bool isEnabled)
+        {
+            Provider = provider;
+            IsEnabled = isEnabled;
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Models/CharTiming.cs

@@ -0,0 +1,12 @@
+// 2025/6/23 by Zhe Fang
+
+namespace BetterLyrics.WinUI3.Models
+{
+    public class CharTiming
+    {
+        public int EndMs { get; set; }
+        public int StartIndex { get; set; }
+        public int StartMs { get; set; }
+        public string Text { get; set; } = string.Empty;
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Models/LanguageInfo.cs

@@ -0,0 +1,23 @@
+using CommunityToolkit.Mvvm.ComponentModel;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Models
+{
+    public partial class LanguageInfo : ObservableObject
+    {
+        [ObservableProperty]
+        public partial string Code { get; set; }
+        [ObservableProperty]
+        public partial string Name { get; set; }
+
+        public LanguageInfo(string code, string name)
+        {
+            Code = code;
+            Name = name;
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Models/LocalLyricsFolder.cs

@@ -0,0 +1,23 @@
+// 2025/6/23 by Zhe Fang
+
+using CommunityToolkit.Mvvm.ComponentModel;
+
+namespace BetterLyrics.WinUI3.Models
+{
+    public partial class LocalLyricsFolder : ObservableObject
+    {
+        [ObservableProperty]
+        public partial bool IsEnabled { get; set; }
+
+        [ObservableProperty]
+        public partial string Path { get; set; }
+
+        public LocalLyricsFolder() { }
+
+        public LocalLyricsFolder(string path, bool isEnabled)
+        {
+            Path = path;
+            IsEnabled = isEnabled;
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Models/LyricsData.cs

@@ -0,0 +1,95 @@
+using BetterLyrics.WinUI3.Helper;
+using BetterLyrics.WinUI3.Services;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Models
+{
+    public class LyricsData
+    {
+        public List<LyricsLine> LyricsLines { get; set; }
+        public string? LanguageCode => LanguageHelper.DetectLanguageCode(WrappedOriginalText);
+        public string WrappedOriginalText => string.Join(StringHelper.NewLine, LyricsLines.Select(line => line.OriginalText));
+
+        public LyricsData()
+        {
+            LyricsLines = [];
+        }
+
+        public LyricsData(List<LyricsLine> lyricsLines)
+        {
+            LyricsLines = lyricsLines;
+        }
+
+        public void SetDisplayedTextAlongWith(LyricsData translationData)
+        {
+            int i = 0;
+            foreach (var line in LyricsLines)
+            {
+                if (i >= translationData.LyricsLines.Count)
+                {
+                    line.DisplayedText = line.OriginalText; // No translation available, keep original text
+                }
+                else
+                {
+                    line.DisplayedText = $"{line.OriginalText}{StringHelper.NewLine}({translationData.LyricsLines[i].OriginalText})";
+                }
+                i++;
+            }
+        }
+
+        public void SetDisplayedTextAlongWith(string translation)
+        {
+            List<string> translationArr = translation.Split(StringHelper.NewLine).ToList();
+            int i = 0;
+            foreach (var line in LyricsLines)
+            {
+                if (i >= translationArr.Count)
+                {
+                    line.DisplayedText = line.OriginalText; // No translation available, keep original text
+                }
+                else
+                {
+                    line.DisplayedText = $"{line.OriginalText}{StringHelper.NewLine}({translationArr[i]})";
+                }
+                i++;
+            }
+        }
+
+        public void SetDisplayedTextInOriginalText()
+        {
+            foreach (var line in LyricsLines)
+            {
+                line.DisplayedText = line.OriginalText;
+            }
+        }
+
+        public static LyricsData GetNotfoundPlaceholder(int durationMs)
+        {
+            return new LyricsData([new LyricsLine
+            {
+                StartMs = 0,
+                EndMs = durationMs,
+                OriginalText = App.ResourceLoader!.GetString("LyricsNotFound"),
+                CharTimings = [],
+            }]);
+        }
+
+        public static LyricsData GetLoadingPlaceholder()
+        {
+            return new LyricsData([
+                new LyricsLine
+                {
+                    StartMs = 0,
+                    EndMs = (int)TimeSpan.FromMinutes(99).TotalMilliseconds,
+                    OriginalText = "● ● ●",
+                    DisplayedText = "● ● ●",
+                    CharTimings = [],
+                },
+            ]);
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Models/LyricsLine.cs

@@ -1,55 +1,33 @@
-using System.Collections.Generic;
+// 2025/6/23 by Zhe Fang
+
+using System.Collections.Generic;
 using System.Numerics;
-using BetterLyrics.WinUI3.Enums;
+using BetterLyrics.WinUI3.Helper;
+using Microsoft.Graphics.Canvas.Text;
 
 namespace BetterLyrics.WinUI3.Models
 {
     public class LyricsLine
     {
-        public List<string> Texts { get; set; } = [];
+        private const float _animationDuration = 0.3f;
+        public ValueTransition<float> AngleTransition { get; set; } = new(initialValue: 0f, durationSeconds: _animationDuration);
+        public ValueTransition<float> BlurAmountTransition { get; set; } = new(initialValue: 0f, durationSeconds: _animationDuration);
+        public ValueTransition<float> HighlightOpacityTransition { get; set; } = new(initialValue: 0f, durationSeconds: _animationDuration);
+        public ValueTransition<float> OpacityTransition { get; set; } = new(initialValue: 0f, durationSeconds: _animationDuration);
+        public ValueTransition<float> ScaleTransition { get; set; } = new(initialValue: 0.95f, durationSeconds: _animationDuration);
 
-        public int LanguageIndex { get; set; } = 0;
-
-        public string Text => Texts[LanguageIndex];
-
-        public int StartPlayingTimestampMs { get; set; }
-        public int EndPlayingTimestampMs { get; set; }
-
-        public LyricsPlayingState PlayingState { get; set; }
-
-        public int DurationMs => EndPlayingTimestampMs - StartPlayingTimestampMs;
-
-        public float EnteringProgress { get; set; }
-
-        public float ExitingProgress { get; set; }
-
-        public float PlayingProgress { get; set; }
-
-        public Vector2 Position { get; set; }
+        public CanvasTextLayout? CanvasTextLayout { get; set; }
 
         public Vector2 CenterPosition { get; set; }
+        public Vector2 Position { get; set; }
 
-        public float Scale { get; set; }
+        public List<CharTiming> CharTimings { get; set; } = [];
 
-        public float Opacity { get; set; }
+        public int DurationMs => EndMs - StartMs;
+        public int EndMs { get; set; }
+        public int StartMs { get; set; }
 
-        public LyricsLine Clone()
-        {
-            return new LyricsLine
-            {
-                Texts = new List<string>(this.Texts),
-                LanguageIndex = this.LanguageIndex,
-                StartPlayingTimestampMs = this.StartPlayingTimestampMs,
-                EndPlayingTimestampMs = this.EndPlayingTimestampMs,
-                PlayingState = this.PlayingState,
-                EnteringProgress = this.EnteringProgress,
-                ExitingProgress = this.ExitingProgress,
-                PlayingProgress = this.PlayingProgress,
-                Position = this.Position,
-                CenterPosition = this.CenterPosition,
-                Scale = this.Scale,
-                Opacity = this.Opacity,
-            };
-        }
+        public string DisplayedText { get; set; } = "";
+        public string OriginalText { get; set; } = "";
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Models/LyricsSearchProviderInfo.cs

@@ -0,0 +1,25 @@
+// 2025/6/23 by Zhe Fang
+
+using BetterLyrics.WinUI3.Enums;
+using CommunityToolkit.Mvvm.ComponentModel;
+
+namespace BetterLyrics.WinUI3.Models
+{
+    public partial class LyricsSearchProviderInfo : ObservableObject
+    {
+        [ObservableProperty]
+        public partial bool IsEnabled { get; set; }
+
+        [ObservableProperty]
+        public partial LyricsSearchProvider Provider { get; set; }
+
+        public LyricsSearchProviderInfo() { }
+
+        public LyricsSearchProviderInfo(LyricsSearchProvider provider, bool isEnabled)
+        {
+            Provider = provider;
+            IsEnabled = isEnabled;
+        }
+
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Models/MediaSourceProviderInfo.cs

@@ -0,0 +1,25 @@
+// 2025/6/23 by Zhe Fang
+
+using BetterLyrics.WinUI3.Enums;
+using CommunityToolkit.Mvvm.ComponentModel;
+
+namespace BetterLyrics.WinUI3.Models
+{
+    public partial class MediaSourceProviderInfo : ObservableObject
+    {
+        [ObservableProperty]
+        public partial bool IsEnabled { get; set; }
+
+        [ObservableProperty]
+        public partial string Provider { get; set; }
+
+        public MediaSourceProviderInfo() { }
+
+        public MediaSourceProviderInfo(string provider, bool isEnabled)
+        {
+            Provider = provider;
+            IsEnabled = isEnabled;
+        }
+
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Models/MetadataIndex.cs

@@ -1,12 +0,0 @@
-using SQLite;
-
-namespace BetterLyrics.WinUI3.Models
-{
-    public class MetadataIndex
-    {
-        [PrimaryKey]
-        public string? Path { get; set; }
-        public string? Title { get; set; }
-        public string? Artist { get; set; }
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Models/Notification.cs

@@ -1,43 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-using CommunityToolkit.Mvvm.ComponentModel;
-using Microsoft.UI.Xaml;
-using Microsoft.UI.Xaml.Controls;
-
-namespace BetterLyrics.WinUI3.Models
-{
-    public partial class Notification : ObservableObject
-    {
-        [ObservableProperty]
-        private InfoBarSeverity _severity;
-
-        [ObservableProperty]
-        private string? _message;
-
-        [ObservableProperty]
-        private bool _isForeverDismissable;
-
-        [ObservableProperty]
-        private Visibility _visibility;
-
-        [ObservableProperty]
-        private string? _relatedSettingsKeyName;
-
-        public Notification(
-            string? message = null,
-            InfoBarSeverity severity = InfoBarSeverity.Informational,
-            bool isForeverDismissable = false,
-            string? relatedSettingsKeyName = null
-        )
-        {
-            Message = message;
-            Severity = severity;
-            IsForeverDismissable = isForeverDismissable;
-            Visibility = IsForeverDismissable ? Visibility.Visible : Visibility.Collapsed;
-            RelatedSettingsKeyName = relatedSettingsKeyName;
-        }
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Models/SongInfo.cs

@@ -1,106 +1,28 @@
-using System.Collections.Generic;
-using System.Collections.ObjectModel;
-using System.Linq;
-using ATL;
-using BetterLyrics.WinUI3.Helper;
+// 2025/6/23 by Zhe Fang
+
 using CommunityToolkit.Mvvm.ComponentModel;
-using Microsoft.UI;
+using Windows.Graphics.Imaging;
 using Windows.UI;
-using static ATL.LyricsInfo;
 
 namespace BetterLyrics.WinUI3.Models
 {
     public partial class SongInfo : ObservableObject
     {
         [ObservableProperty]
-        public partial string? Title { get; set; }
+        public partial string? Album { get; set; }
 
         [ObservableProperty]
-        public partial string? Artist { get; set; }
+        public partial string Artist { get; set; }
 
         [ObservableProperty]
-        public partial ObservableCollection<string>? FilesFound { get; set; }
-
-        [ObservableProperty]
-        public partial bool IsLyricsExisted { get; set; } = false;
+        public partial double? DurationMs { get; set; }
 
         [ObservableProperty]
         public partial string? SourceAppUserModelId { get; set; } = null;
 
         [ObservableProperty]
-        public partial List<LyricsLine>? LyricsLines { get; set; } = null;
-        public byte[]? AlbumArt { get; set; } = null;
-
-        [ObservableProperty]
-        public partial List<Color>? CoverImageDominantColors { get; set; } = null;
+        public partial string Title { get; set; }
 
         public SongInfo() { }
-
-        /// <summary>
-        /// Try to parse lyrics from the track, optionally override the raw lyrics string.
-        /// </summary>
-        /// <param name="track"></param>
-        /// <param name="overrideRaw"></param>
-        public void ParseLyrics(Track track, string? overrideRaw = null)
-        {
-            List<LyricsLine>? result = null;
-
-            if (overrideRaw != null)
-                track.Lyrics.ParseLRC(overrideRaw);
-
-            var lyricsPhrases = track.Lyrics.SynchronizedLyrics;
-
-            if (lyricsPhrases?.Count > 0)
-            {
-                if (lyricsPhrases[0].TimestampMs > 0)
-                {
-                    var placeholder = new LyricsPhrase(0, $"{track.Artist} - {track.Title}");
-                    lyricsPhrases.Insert(0, placeholder);
-                    lyricsPhrases.Insert(0, placeholder);
-                }
-            }
-
-            LyricsLine? lyricsLine = null;
-
-            for (int i = 0; i < lyricsPhrases?.Count; i++)
-            {
-                var lyricsPhrase = lyricsPhrases[i];
-                int startTimestampMs = lyricsPhrase.TimestampMs;
-                int endTimestampMs;
-
-                if (i + 1 < lyricsPhrases.Count)
-                {
-                    endTimestampMs = lyricsPhrases[i + 1].TimestampMs;
-                }
-                else
-                {
-                    endTimestampMs = (int)track.DurationMs;
-                }
-
-                lyricsLine ??= new LyricsLine { StartPlayingTimestampMs = startTimestampMs };
-
-                lyricsLine.Texts.Add(lyricsPhrase.Text);
-
-                if (endTimestampMs == startTimestampMs)
-                {
-                    continue;
-                }
-                else
-                {
-                    lyricsLine.EndPlayingTimestampMs = endTimestampMs;
-                    result ??= [];
-                    result.Add(lyricsLine);
-                    lyricsLine = null;
-                }
-            }
-
-            if (result != null && result.Count == 0)
-            {
-                result = null;
-            }
-
-            LyricsLines = result;
-            IsLyricsExisted = result != null;
-        }
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Models/TranslateResponse.cs

@@ -0,0 +1,15 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Text.Json.Serialization;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Models
+{
+    public class TranslateResponse
+    {
+        [JsonPropertyName("translatedText")]
+        public string TranslatedText { get; set; }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Renderer/LyricsRenderer.xaml

@@ -5,6 +5,7 @@
     xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
     xmlns:canvas="using:Microsoft.Graphics.Canvas.UI.Xaml"
     xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+    xmlns:interactivity="using:Microsoft.Xaml.Interactivity"
     xmlns:local="using:BetterLyrics.WinUI3.Renderer"
     xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
     mc:Ignorable="d">
@@ -13,8 +14,16 @@
         <canvas:CanvasAnimatedControl
             x:Name="LyricsCanvas"
             Draw="LyricsCanvas_Draw"
-            Loaded="LyricsCanvas_Loaded"
-            Paused="{x:Bind ViewModel.IsPlaying, Mode=OneWay, Converter={StaticResource BoolNegationConverter}}"
             Update="LyricsCanvas_Update" />
+        <Grid
+            Margin="36"
+            HorizontalAlignment="Right"
+            VerticalAlignment="Top"
+            Visibility="{x:Bind ViewModel.IsTranslating, Mode=OneWay, Converter={StaticResource BoolToVisibilityConverter}}">
+            <FontIcon
+                x:Name="RotatingIcon"
+                FontFamily="{StaticResource IconFontFamily}"
+                Glyph="&#xE8C1;" />
+        </Grid>
     </Grid>
 </UserControl>

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Renderer/LyricsRenderer.xaml.cs

@@ -1,11 +1,9 @@
-using System.Diagnostics;
+// 2025/6/23 by Zhe Fang
+
 using BetterLyrics.WinUI3.ViewModels;
 using CommunityToolkit.Mvvm.DependencyInjection;
-using Microsoft.UI.Xaml;
 using Microsoft.UI.Xaml.Controls;
-
-// To learn more about WinUI, the WinUI project structure,
-// and more about our project templates, see: http://aka.ms/winui-project-info.
+using Microsoft.UI.Xaml.Media.Animation;
 
 namespace BetterLyrics.WinUI3.Renderer
 {
@@ -19,25 +17,14 @@ namespace BetterLyrics.WinUI3.Renderer
             ViewModel = Ioc.Default.GetRequiredService<LyricsRendererViewModel>();
         }
 
-        private void LyricsCanvas_Draw(
-            Microsoft.Graphics.Canvas.UI.Xaml.ICanvasAnimatedControl sender,
-            Microsoft.Graphics.Canvas.UI.Xaml.CanvasAnimatedDrawEventArgs args
-        )
+        private void LyricsCanvas_Draw(Microsoft.Graphics.Canvas.UI.Xaml.ICanvasAnimatedControl sender, Microsoft.Graphics.Canvas.UI.Xaml.CanvasAnimatedDrawEventArgs args)
         {
             ViewModel.Draw(sender, args.DrawingSession);
         }
 
-        private void LyricsCanvas_Update(
-            Microsoft.Graphics.Canvas.UI.Xaml.ICanvasAnimatedControl sender,
-            Microsoft.Graphics.Canvas.UI.Xaml.CanvasAnimatedUpdateEventArgs args
-        )
+        private void LyricsCanvas_Update(Microsoft.Graphics.Canvas.UI.Xaml.ICanvasAnimatedControl sender, Microsoft.Graphics.Canvas.UI.Xaml.CanvasAnimatedUpdateEventArgs args)
         {
-            ViewModel.Calculate(sender, args);
-        }
-
-        private void LyricsCanvas_Loaded(object sender, RoutedEventArgs e)
-        {
-            ViewModel.RequestRelayout();
+            ViewModel.Update(sender, args);
         }
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Serialization/SourceGenerationContext.cs

@@ -0,0 +1,20 @@
+// 2025/6/23 by Zhe Fang
+
+using System.Collections.Generic;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+using BetterLyrics.WinUI3.Models;
+
+namespace BetterLyrics.WinUI3.Serialization
+{
+
+    [JsonSerializable(typeof(List<AlbumArtSearchProviderInfo>))]
+    [JsonSerializable(typeof(List<LyricsSearchProviderInfo>))]
+    [JsonSerializable(typeof(List<MediaSourceProviderInfo>))]
+    [JsonSerializable(typeof(List<LocalLyricsFolder>))]
+    [JsonSerializable(typeof(List<string>))]
+    [JsonSerializable(typeof(TranslateResponse))]
+    [JsonSerializable(typeof(JsonElement))]
+    [JsonSourceGenerationOptions(WriteIndented = true)]
+    internal partial class SourceGenerationContext : JsonSerializerContext { }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/AlbumArtSearchService.cs

@@ -0,0 +1,136 @@
+using ATL;
+using BetterLyrics.WinUI3.Enums;
+using BetterLyrics.WinUI3.Helper;
+using CommunityToolkit.Mvvm.DependencyInjection;
+using Microsoft.Extensions.Logging;
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Net.Http;
+using System.Text;
+using System.Text.Json;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Services
+{
+    public class AlbumArtSearchService : IAlbumArtSearchService
+    {
+        private readonly HttpClient _iTunesHttpClinet;
+
+        private readonly ISettingsService _settingsService;
+        private readonly ILogger _logger;
+
+        public AlbumArtSearchService(ISettingsService settingsService)
+        {
+            _settingsService = settingsService;
+            _logger = Ioc.Default.GetRequiredService<ILogger<AlbumArtSearchService>>();
+            _iTunesHttpClinet = new();
+        }
+
+        public async Task<byte[]?> SearchAsync(string title, string artist, string album, byte[]? bytesFromSMTC = null)
+        {
+            byte[]? result = null;
+
+            foreach (var provider in _settingsService.AlbumArtSearchProvidersInfo)
+            {
+                if (!provider.IsEnabled)
+                {
+                    continue;
+                }
+
+                switch (provider.Provider)
+                {
+                    case AlbumArtSearchProvider.Local:
+                        result = SearchFile(artist, album);
+                        break;
+                    case AlbumArtSearchProvider.SMTC:
+                        result = bytesFromSMTC;
+                        break;
+                    case AlbumArtSearchProvider.iTunes:
+                        result = await SearchiTunesAsync(artist, album);
+                        break;
+                    default:
+                        break;
+                }
+
+                if (result != null) return result;
+            }
+            return null;
+        }
+
+        private byte[]? SearchFile(string artist, string album)
+        {
+            foreach (var folder in _settingsService.LocalLyricsFolders)
+            {
+                if (Directory.Exists(folder.Path) && folder.IsEnabled)
+                {
+                    foreach (var file in Directory.GetFiles(folder.Path, $"*.*", SearchOption.AllDirectories))
+                    {
+                        if (FileHelper.IsSwitchableNormalizedMatch(Path.GetFileNameWithoutExtension(file), album, artist))
+                        {
+                            Track track = new(file);
+                            var bytes = track.EmbeddedPictures.FirstOrDefault()?.PictureData;
+                            if (bytes != null)
+                            {
+                                return bytes;
+                            }
+                        }
+                    }
+                }
+            }
+            return null;
+        }
+
+        private async Task<byte[]?> SearchiTunesAsync(string artist, string album)
+        {
+            // Source: https://gist.github.com/mcworkaholic/82fbf203e3f1043bbe534b5b2974c0ce
+            try
+            {
+                string format = ".jpg";
+                var cachedAlbumArt = FileHelper.ReadAlbumArtCache(artist, album, format, PathHelper.iTunesAlbumArtCacheDirectory);
+
+                if (cachedAlbumArt != null)
+                {
+                    return cachedAlbumArt;
+                }
+
+                // Build the iTunes API URL
+                string url = $"https://itunes.apple.com/search?term=" + artist + "+" + album + "&country=" + LanguageHelper.DetectCountryCode(album + artist) + "&entity=album";
+                url.Replace(" ", "-");
+                // Make a request to the API
+
+                HttpResponseMessage response = await _iTunesHttpClinet.GetAsync(url);
+                response.EnsureSuccessStatusCode();
+                string responseBody = await response.Content.ReadAsStringAsync();
+
+                // Parse the JSON response
+                var data = JsonSerializer.Deserialize(responseBody, Serialization.SourceGenerationContext.Default.JsonElement);
+
+                if (data.TryGetProperty("results", out var results) && results.ValueKind == JsonValueKind.Array && results.GetArrayLength() > 0)
+                {
+                    // Get the first result
+                    var result = results[0];
+                    if (result.TryGetProperty("artworkUrl100", out var artworkUrlProp))
+                    {
+                        string artworkUrl = artworkUrlProp.GetString()?.Replace("100x100bb.jpg", "1200x1200bb.jpg") ?? string.Empty;
+                        var fetched = await _iTunesHttpClinet.GetByteArrayAsync(artworkUrl);
+
+                        if (fetched != null && fetched.Length > 0)
+                        {
+                            // Write to cache
+                            FileHelper.WriteAlbumArtCache(artist, album, fetched, format, PathHelper.iTunesAlbumArtCacheDirectory);
+                            return fetched;
+                        }
+                    }
+                }
+            }
+            catch (Exception ex)
+            {
+                _logger.LogError(ex, "Error searching iTunes album art for {Artist} - {Album}", artist, album);
+            }
+            return null;
+        }
+
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/Database/DatabaseService.cs

@@ -1,176 +0,0 @@
-using System.Collections.Generic;
-using System.IO;
-using System.Text;
-using System.Threading.Tasks;
-using ATL;
-using BetterLyrics.WinUI3.Helper;
-using BetterLyrics.WinUI3.Models;
-using SQLite;
-using Ude;
-using Windows.Media.Control;
-using Windows.Storage.Streams;
-
-namespace BetterLyrics.WinUI3.Services.Database
-{
-    public class DatabaseService : IDatabaseService
-    {
-        private readonly SQLiteConnection _connection;
-
-        private readonly CharsetDetector _charsetDetector = new();
-
-        public DatabaseService()
-        {
-            _connection = new SQLiteConnection(AppInfo.DatabasePath);
-            if (_connection.GetTableInfo("MetadataIndex").Count == 0)
-            {
-                _connection.CreateTable<MetadataIndex>();
-            }
-        }
-
-        public async Task RebuildDatabaseAsync(IList<string> paths)
-        {
-            await Task.Run(() =>
-            {
-                _connection.DeleteAll<MetadataIndex>();
-
-                HashSet<string> insertedPaths = new();
-
-                foreach (var path in paths)
-                {
-                    if (Directory.Exists(path))
-                    {
-                        foreach (
-                            var file in Directory.GetFiles(path, "*.*", SearchOption.AllDirectories)
-                        )
-                        {
-                            if (!insertedPaths.Contains(file))
-                            {
-                                var track = new Track(file);
-                                _connection.Insert(
-                                    new MetadataIndex
-                                    {
-                                        Path = file,
-                                        Title = track.Title,
-                                        Artist = track.Artist,
-                                    }
-                                );
-                                insertedPaths.Add(file);
-                            }
-                        }
-                    }
-                }
-            });
-        }
-
-        public async Task<SongInfo> FindSongInfoAsync(
-            GlobalSystemMediaTransportControlsSessionMediaProperties? mediaProps
-        )
-        {
-            if (mediaProps == null || mediaProps.Title == null || mediaProps.Artist == null)
-                return new();
-
-            var songInfo = new SongInfo { Title = mediaProps?.Title, Artist = mediaProps?.Artist };
-
-            // App.ResourceLoader!.GetString("MainPageNoLocalFilesMatched");
-
-            if (mediaProps?.Thumbnail is IRandomAccessStreamReference streamReference)
-            {
-                songInfo.AlbumArt = await ImageHelper.ToByteArrayAsync(streamReference);
-            }
-
-            return await FindSongInfoAsync(songInfo, mediaProps!.Title, mediaProps!.Artist);
-        }
-
-        public async Task<SongInfo> FindSongInfoAsync(
-            SongInfo initSongInfo,
-            string searchTitle,
-            string searchArtist
-        )
-        {
-            var founds = _connection
-                .Table<MetadataIndex>()
-                // Look up by Title and Artist (these two props were fetched by reading metadata in music file befoe) first
-                // then by Path (music file name usually contains song name and artist so this can be a second way to look up for)
-                // Please note for .lrc file, only the second way works for it
-                .Where(m =>
-                    (
-                        m.Title != null
-                        && m.Artist != null
-                        && m.Title.Contains(searchTitle)
-                        && m.Artist.Contains(searchArtist)
-                    )
-                    || (
-                        m.Path != null
-                        && m.Path.Contains(searchTitle)
-                        && m.Path.Contains(searchArtist)
-                    )
-                )
-                .ToList();
-
-            foreach (var found in founds)
-            {
-                initSongInfo.FilesFound ??= [];
-                initSongInfo.FilesFound.Add(found.Path!);
-                if (initSongInfo.LyricsLines == null || initSongInfo.AlbumArt == null)
-                {
-                    Track track = new(found.Path);
-                    initSongInfo.ParseLyrics(track);
-                    // Successfully parse lyrics info from metadata in music file
-                    if (initSongInfo.LyricsLines != null)
-                    {
-                        // Used as lyrics source
-                    }
-                    // Find lyrics file
-                    if (initSongInfo.LyricsLines == null && found?.Path?.EndsWith(".lrc") == true)
-                    {
-                        using (FileStream fs = File.OpenRead(found.Path))
-                        {
-                            _charsetDetector.Feed(fs);
-                            _charsetDetector.DataEnd();
-                        }
-
-                        string content;
-                        if (_charsetDetector.Charset != null)
-                        {
-                            Encoding encoding = Encoding.GetEncoding(_charsetDetector.Charset);
-                            content = File.ReadAllText(found.Path, encoding);
-                        }
-                        else
-                        {
-                            content = File.ReadAllText(found.Path, Encoding.UTF8);
-                        }
-                        initSongInfo.ParseLyrics(track, content);
-                        // Used as lyrics source
-                    }
-
-                    // Finf album art
-                    if (initSongInfo.AlbumArt == null)
-                    {
-                        if (track.EmbeddedPictures.Count > 0)
-                        {
-                            initSongInfo.AlbumArt = track.EmbeddedPictures[0].PictureData;
-                            // Used as album art source
-                        }
-                    }
-                }
-                else
-                    break;
-            }
-
-            if (initSongInfo.AlbumArt == null)
-            {
-                initSongInfo.CoverImageDominantColors = null;
-            }
-            else
-            {
-                initSongInfo.CoverImageDominantColors = await ImageHelper.GetAccentColorsFromByte(
-                    initSongInfo.AlbumArt
-                );
-            }
-
-            if (initSongInfo.LyricsLines == null) { }
-
-            return initSongInfo;
-        }
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/Database/IDatabaseService.cs

@@ -1,25 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-using BetterLyrics.WinUI3.Models;
-using Windows.Media.Control;
-
-namespace BetterLyrics.WinUI3.Services.Database
-{
-    public interface IDatabaseService
-    {
-        Task RebuildDatabaseAsync(IList<string> paths);
-
-        Task<SongInfo> FindSongInfoAsync(
-            GlobalSystemMediaTransportControlsSessionMediaProperties? mediaProps
-        );
-
-        Task<SongInfo> FindSongInfoAsync(
-            SongInfo initSongInfo,
-            string searchTitle,
-            string searchArtist
-        );
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/IAlbumArtSearchService.cs

@@ -0,0 +1,13 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Services
+{
+    public interface IAlbumArtSearchService
+    {
+        Task<byte[]?> SearchAsync(string title, string artist, string album, byte[]? bytesFromSMTC = null);
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/ILibWatcherService.cs

@@ -0,0 +1,19 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using BetterLyrics.WinUI3.Events;
+using BetterLyrics.WinUI3.Models;
+
+namespace BetterLyrics.WinUI3.Services
+{
+    public interface ILibWatcherService
+    {
+        event EventHandler<LibChangedEventArgs>? MusicLibraryFilesChanged;
+
+        public void UpdateWatchers(List<LocalLyricsFolder> folders);
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/ILyricsSearchService.cs

@@ -0,0 +1,14 @@
+// 2025/6/23 by Zhe Fang
+
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+using BetterLyrics.WinUI3.Enums;
+
+namespace BetterLyrics.WinUI3.Services
+{
+    public interface ILyricsSearchService
+    {
+        Task<string?> SearchAsync(string title, string artist, string album, double durationMs, CancellationToken token);
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/IPlaybackService.cs

@@ -1,18 +1,17 @@
-using System;
+// 2025/6/23 by Zhe Fang
+
+using System;
 using BetterLyrics.WinUI3.Events;
 using BetterLyrics.WinUI3.Models;
 
-namespace BetterLyrics.WinUI3.Services.Playback
+namespace BetterLyrics.WinUI3.Services
 {
     public interface IPlaybackService
     {
-        event EventHandler<SongInfoChangedEventArgs>? SongInfoChanged;
         event EventHandler<IsPlayingChangedEventArgs>? IsPlayingChanged;
         event EventHandler<PositionChangedEventArgs>? PositionChanged;
-
-        void ReSendingMessages();
-        SongInfo? SongInfo { get; }
-        bool IsPlaying { get; }
-        TimeSpan Position { get; }
+        event EventHandler<SongInfoChangedEventArgs>? SongInfoChanged;
+        event EventHandler<AlbumArtChangedEventArgs>? AlbumArtChangedChanged;
+        event EventHandler<MediaSourceProvidersInfoEventArgs>? MediaSourceProvidersInfoChanged;
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/ISettingsService.cs

@@ -0,0 +1,91 @@
+// 2025/6/23 by Zhe Fang
+
+using System.Collections.Generic;
+using BetterLyrics.WinUI3.Enums;
+using BetterLyrics.WinUI3.Models;
+using Microsoft.UI.Text;
+using Microsoft.UI.Xaml;
+using Windows.UI;
+using Windows.UI.Text;
+
+namespace BetterLyrics.WinUI3.Services
+{
+    public interface ISettingsService
+    {
+        // App behavior
+
+        AutoStartWindowType AutoStartWindowType { get; set; }
+
+        int CoverImageRadius { get; set; }
+
+        int CoverOverlayBlurAmount { get; set; }
+        int CoverOverlayOpacity { get; set; }
+        bool IsDynamicCoverOverlayEnabled { get; set; }
+        bool IsFanLyricsEnabled { get; set; }
+        bool IsFirstRun { get; set; }
+        bool IsLyricsGlowEffectEnabled { get; set; }
+        Language Language { get; set; }
+        int DesktopWindowLeft { get; set; }
+        int DesktopWindowTop { get; set; }
+        int DesktopWindowWidth { get; set; }
+        int DesktopWindowHeight { get; set; }
+
+        int StandardWindowWidth { get; set; }
+        int StandardWindowHeight { get; set; }
+        int StandardWindowLeft { get; set; }
+        int StandardWindowTop { get; set; }
+
+        bool AutoLockOnDesktopMode { get; set; }
+
+        string LibreTranslateServer { get; set; }
+        int SelectedTargetLanguageIndex { get; set; }
+        // Lyrics lib
+
+        List<LocalLyricsFolder> LocalLyricsFolders { get; set; }
+
+        // Lyrics style and effetc
+
+        TextAlignmentType LyricsAlignmentType { get; set; }
+        TextAlignmentType SongInfoAlignmentType { get; set; }
+
+        int LyricsBlurAmount { get; set; }
+
+        Color LyricsCustomBgFontColor { get; set; }
+        Color LyricsCustomFgFontColor { get; set; }
+        Color LyricsCustomStrokeFontColor { get; set; }
+
+        LyricsFontColorType LyricsBgFontColorType { get; set; }
+        LyricsFontColorType LyricsFgFontColorType { get; set; }
+        LyricsFontColorType LyricsStrokeFontColorType { get; set; }
+
+        int LyricsFontSize { get; set; }
+
+        ElementTheme LyricsBackgroundTheme { get; set; }
+
+        int LyricsFontStrokeWidth { get; set; }
+
+        LyricsFontWeight LyricsFontWeight { get; set; }
+
+        LineRenderingType LyricsGlowEffectScope { get; set; }
+        LineRenderingType LyricsHighlightScope { get; set; }
+
+        float LyricsLineSpacingFactor { get; set; }
+
+        List<LyricsSearchProviderInfo> LyricsSearchProvidersInfo { get; set; }
+        List<AlbumArtSearchProviderInfo> AlbumArtSearchProvidersInfo { get; set; }
+        List<MediaSourceProviderInfo> MediaSourceProvidersInfo { get; set; }
+
+        EasingType LyricsScrollEasingType { get; set; }
+        int LyricsScrollDuration { get; set; }
+
+        int LyricsVerticalEdgeOpacity { get; set; }
+
+        bool IgnoreFullscreenWindow { get; set; }
+
+        bool IsTranslationEnabled { get; set; }
+
+        LyricsDisplayType PreferredDisplayType { get; set; }
+
+        int TimelineSyncThreshold { get; set; }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/ITranslateService.cs

@@ -0,0 +1,17 @@
+using BetterLyrics.WinUI3.Models;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Services
+{
+    public interface ITranslateService
+    {
+        Task<string> TranslateTextAsync(string text, string targetLangCode, CancellationToken? token);
+
+        int SearchTranslatedLyricsItself(List<LyricsData> lyricsDataArr);
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/LibWatcherService.cs

@@ -0,0 +1,84 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using BetterLyrics.WinUI3.Events;
+using BetterLyrics.WinUI3.Models;
+
+namespace BetterLyrics.WinUI3.Services
+{
+    public class LibWatcherService : IDisposable, ILibWatcherService
+    {
+        private readonly ISettingsService _settingsService;
+
+        private readonly Dictionary<string, FileSystemWatcher> _watchers = [];
+
+        public LibWatcherService(ISettingsService settingsService)
+        {
+            _settingsService = settingsService;
+            UpdateWatchers(_settingsService.LocalLyricsFolders);
+        }
+
+        public event EventHandler<LibChangedEventArgs>? MusicLibraryFilesChanged;
+
+        public void Dispose()
+        {
+            foreach (var watcher in _watchers.Values)
+            {
+                watcher.Dispose();
+            }
+            _watchers.Clear();
+        }
+
+        public void UpdateWatchers(List<LocalLyricsFolder> folders)
+        {
+            // 移除不再监听的
+            foreach (var key in _watchers.Keys.ToList())
+            {
+                if (!folders.Any(x => x.Path == key && x.IsEnabled))
+                {
+                    _watchers[key].Dispose();
+                    _watchers.Remove(key);
+                }
+            }
+
+            // 添加新的监听
+            foreach (var folder in folders)
+            {
+                if (
+                    !_watchers.ContainsKey(folder.Path)
+                    && Directory.Exists(folder.Path)
+                    && folder.IsEnabled
+                )
+                {
+                    var watcher = new FileSystemWatcher(folder.Path)
+                    {
+                        IncludeSubdirectories = true,
+                        EnableRaisingEvents = true,
+                    };
+                    watcher.Created += (s, e) => OnChanged(folder.Path, e);
+                    watcher.Changed += (s, e) => OnChanged(folder.Path, e);
+                    watcher.Deleted += (s, e) => OnChanged(folder.Path, e);
+                    watcher.Renamed += (s, e) => OnChanged(folder.Path, e);
+                    _watchers[folder.Path] = watcher;
+                }
+            }
+        }
+
+        private void OnChanged(string folder, FileSystemEventArgs e)
+        {
+            App.DispatcherQueue!.TryEnqueue(
+                Microsoft.UI.Dispatching.DispatcherQueuePriority.High,
+                () =>
+                {
+                    MusicLibraryFilesChanged?.Invoke(
+                        this,
+                        new LibChangedEventArgs(folder, e.FullPath, e.ChangeType)
+                    );
+                }
+            );
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/LyricsSearchService.cs

@@ -0,0 +1,352 @@
+// 2025/6/23 by Zhe Fang
+
+using ATL;
+using BetterLyrics.WinUI3.Enums;
+using BetterLyrics.WinUI3.Helper;
+using CommunityToolkit.Mvvm.DependencyInjection;
+using Lyricify.Lyrics.Providers.Web.Kugou;
+using Lyricify.Lyrics.Searchers;
+using Microsoft.Extensions.Logging;
+using System;
+using System.IO;
+using System.Linq;
+using System.Net.Http;
+using System.Text;
+using System.Text.Json;
+using System.Threading;
+using System.Threading.Tasks;
+using Windows.Storage;
+
+namespace BetterLyrics.WinUI3.Services
+{
+    public class LyricsSearchService : ILyricsSearchService
+    {
+        private readonly HttpClient _amllTtmlDbHttpClient;
+        private readonly HttpClient _lrcLibHttpClient;
+
+        private readonly ISettingsService _settingsService;
+        private readonly ILogger _logger;
+
+        public LyricsSearchService(ISettingsService settingsService)
+        {
+            _settingsService = settingsService;
+            _logger = Ioc.Default.GetRequiredService<ILogger<LyricsSearchService>>();
+
+            _lrcLibHttpClient = new();
+            _lrcLibHttpClient.DefaultRequestHeaders.Add(
+                "User-Agent",
+                $"{MetadataHelper.AppName} {MetadataHelper.AppVersion} ({MetadataHelper.GithubUrl})"
+            );
+            _amllTtmlDbHttpClient = new();
+        }
+
+        private static bool IsAmllTtmlDbIndexInvalid()
+        {
+            bool existed = File.Exists(PathHelper.AmllTtmlDbIndexPath);
+
+            if (!existed)
+            {
+                return true;
+            }
+            else
+            {
+                long currentTs = DateTimeOffset.UtcNow.ToUnixTimeSeconds();
+                string lastUpdatedStr = File.ReadAllText(PathHelper.AmllTtmlDbLastUpdatedPath);
+                long lastUpdated = Convert.ToInt64(lastUpdatedStr);
+                return currentTs - lastUpdated > 1 * 24 * 60 * 60;
+            }
+        }
+
+        public async Task<bool> DownloadAmllTtmlDbIndexAsync()
+        {
+            const string url = "https://raw.githubusercontent.com/Steve-xmh/amll-ttml-db/refs/heads/main/metadata/raw-lyrics-index.jsonl";
+            try
+            {
+                using var response = await _amllTtmlDbHttpClient.GetAsync(url, HttpCompletionOption.ResponseHeadersRead);
+                if (!response.IsSuccessStatusCode) return false;
+
+                await using var stream = await response.Content.ReadAsStreamAsync();
+                await using var fs = new FileStream(
+                    PathHelper.AmllTtmlDbIndexPath,
+                    FileMode.Create,
+                    FileAccess.Write,
+                    FileShare.None
+                );
+                await stream.CopyToAsync(fs);
+
+                long currentTs = DateTimeOffset.UtcNow.ToUnixTimeSeconds();
+                File.WriteAllText(PathHelper.AmllTtmlDbLastUpdatedPath, currentTs.ToString());
+
+                return true;
+            }
+            catch
+            {
+                return false;
+            }
+        }
+
+        public async Task<string?> SearchAsync(string title, string artist, string album, double durationMs, CancellationToken token)
+        {
+            _logger.LogInformation("Searching img for: {Title} - {Artist} (Album: {Album}, Duration: {DurationMs}ms)", title, artist, album, durationMs);
+
+            foreach (var provider in _settingsService.LyricsSearchProvidersInfo)
+            {
+                if (!provider.IsEnabled)
+                {
+                    continue;
+                }
+
+                string? cachedLyrics;
+                LyricsFormat lyricsFormat = provider.Provider.GetLyricsFormat();
+
+                // Check cache first
+                if (provider.Provider.IsRemote())
+                {
+                    cachedLyrics = FileHelper.ReadLyricsCache(title, artist, lyricsFormat, provider.Provider.GetCacheDirectory());
+                    if (!string.IsNullOrWhiteSpace(cachedLyrics))
+                    {
+                        return cachedLyrics;
+                    }
+                }
+
+                string? searchedLyrics = null;
+
+                if (provider.Provider.IsLocal())
+                {
+                    if (provider.Provider == LyricsSearchProvider.LocalMusicFile)
+                    {
+                        searchedLyrics = SearchEmbedded(title, artist);
+                    }
+                    else
+                    {
+                        searchedLyrics = await SearchFile(title, artist, lyricsFormat);
+                    }
+                }
+                else
+                {
+                    switch (provider.Provider)
+                    {
+                        case LyricsSearchProvider.LrcLib:
+                            searchedLyrics = await SearchLrcLibAsync(title, artist, album, (int)(durationMs / 1000));
+                            break;
+                        case LyricsSearchProvider.QQ:
+                            searchedLyrics = await SearchQQNeteaseKugouAsync(title, artist, album, (int)durationMs, Searchers.QQMusic);
+                            break;
+                        case LyricsSearchProvider.Kugou:
+                            searchedLyrics = await SearchQQNeteaseKugouAsync(title, artist, album, (int)durationMs, Searchers.Kugou);
+                            break;
+                        case LyricsSearchProvider.Netease:
+                            searchedLyrics = await SearchQQNeteaseKugouAsync(title, artist, album, (int)durationMs, Searchers.Netease);
+                            break;
+                        case LyricsSearchProvider.AmllTtmlDb:
+                            searchedLyrics = await SearchAmllTtmlDbAsync(title, artist);
+                            break;
+                        default:
+                            break;
+                    }
+                }
+
+                token.ThrowIfCancellationRequested();
+
+                if (!string.IsNullOrWhiteSpace(searchedLyrics))
+                {
+                    if (provider.Provider.IsRemote())
+                    {
+                        FileHelper.WriteLyricsCache(title, artist, searchedLyrics, lyricsFormat, provider.Provider.GetCacheDirectory());
+                    }
+
+                    return searchedLyrics;
+                }
+            }
+
+            return null;
+        }
+
+        private async Task<string?> SearchFile(string title, string artist, LyricsFormat format)
+        {
+            foreach (var folder in _settingsService.LocalLyricsFolders)
+            {
+                if (Directory.Exists(folder.Path) && folder.IsEnabled)
+                {
+                    foreach (var file in Directory.GetFiles(folder.Path, $"*{format.ToFileExtension()}", SearchOption.AllDirectories))
+                    {
+                        if (FileHelper.IsSwitchableNormalizedMatch(Path.GetFileNameWithoutExtension(file), title, artist))
+                        {
+                            string? raw = await File.ReadAllTextAsync(file, FileHelper.GetEncoding(file));
+                            if (raw != null)
+                            {
+                                return raw;
+                            }
+                        }
+                    }
+                }
+            }
+            return null;
+        }
+
+        private string? SearchEmbedded(string title, string artist)
+        {
+            foreach (var folder in _settingsService.LocalLyricsFolders)
+            {
+                if (Directory.Exists(folder.Path) && folder.IsEnabled)
+                {
+                    foreach (var file in Directory.GetFiles(folder.Path, $"*.*", SearchOption.AllDirectories))
+                    {
+                        if (FileHelper.IsSwitchableNormalizedMatch(Path.GetFileNameWithoutExtension(file), title, artist))
+                        {
+                            try
+                            {
+                                var plain = TagLib.File.Create(file).Tag.Lyrics;
+                                if (plain != null && plain != string.Empty)
+                                {
+                                    return plain;
+                                }
+                            }
+                            catch (Exception) { }
+                        }
+                    }
+                }
+            }
+
+            return null;
+        }
+
+        private async Task<string?> SearchAmllTtmlDbAsync(string title, string artist)
+        {
+            if (IsAmllTtmlDbIndexInvalid())
+            {
+                var downloadOk = await DownloadAmllTtmlDbIndexAsync();
+                if (!downloadOk)
+                    return null;
+            }
+
+            string? rawLyricFile = null;
+            await foreach (var line in File.ReadLinesAsync(PathHelper.AmllTtmlDbIndexPath))
+            {
+                if (string.IsNullOrWhiteSpace(line))
+                    continue;
+                try
+                {
+                    using var doc = JsonDocument.Parse(line);
+                    var root = doc.RootElement;
+                    if (!root.TryGetProperty("metadata", out var metadataArr))
+                        continue;
+                    string? musicName = null;
+                    string? artists = null;
+                    foreach (var meta in metadataArr.EnumerateArray())
+                    {
+                        if (meta.GetArrayLength() != 2)
+                            continue;
+                        var key = meta[0].GetString();
+                        var valueArr = meta[1];
+                        if (key == "musicName" && valueArr.GetArrayLength() > 0)
+                            musicName = valueArr[0].GetString();
+                        if (key == "artists" && valueArr.GetArrayLength() > 0)
+                            artists = valueArr[0].GetString();
+                    }
+                    if (musicName == null || artists == null)
+                        continue;
+
+                    if (FileHelper.IsSwitchableNormalizedMatch($"{artists} - {musicName}", title, artist))
+                    {
+                        if (root.TryGetProperty("rawLyricFile", out var rawLyricFileProp))
+                        {
+                            rawLyricFile = rawLyricFileProp.GetString();
+                            break;
+                        }
+                    }
+                }
+                catch { }
+            }
+
+            if (string.IsNullOrWhiteSpace(rawLyricFile))
+                return null;
+
+            // 下载歌词内容
+            var url = $"https://raw.githubusercontent.com/Steve-xmh/amll-ttml-db/refs/heads/main/raw-lyrics/{rawLyricFile}";
+            try
+            {
+                var response = await _amllTtmlDbHttpClient.GetAsync(url);
+                if (!response.IsSuccessStatusCode)
+                    return null;
+                return await response.Content.ReadAsStringAsync();
+            }
+            catch
+            {
+                return null;
+            }
+        }
+
+        private async Task<string?> SearchLrcLibAsync(string title, string artist, string album, int duration)
+        {
+            // Build API query URL
+            var url =
+                $"https://lrclib.net/api/search?" +
+                $"track_name={Uri.EscapeDataString(title)}&" +
+                $"artist_name={Uri.EscapeDataString(artist)}&" +
+                $"&album_name={Uri.EscapeDataString(album)}" +
+                $"&durationMs={Uri.EscapeDataString(duration.ToString())}";
+
+            var response = await _lrcLibHttpClient.GetAsync(url);
+            if (!response.IsSuccessStatusCode)
+                return null;
+
+            var json = await response.Content.ReadAsStringAsync();
+
+            var jArr = JsonSerializer.Deserialize(
+                json,
+                Serialization.SourceGenerationContext.Default.JsonElement
+            );
+            if (jArr.ValueKind == JsonValueKind.Array && jArr.GetArrayLength() > 0)
+            {
+                var first = jArr[0];
+                var syncedLyrics = first.GetProperty("syncedLyrics").GetString();
+                var result = string.IsNullOrWhiteSpace(syncedLyrics) ? null : syncedLyrics;
+                if (!string.IsNullOrWhiteSpace(result))
+                {
+                    return result;
+                }
+            }
+
+            return null;
+        }
+
+        private static async Task<string?> SearchQQNeteaseKugouAsync(string title, string artist, string album, int durationMs, Searchers searchers)
+        {
+            var result = await SearchersHelper.GetSearcher(searchers).SearchForResult(
+                new Lyricify.Lyrics.Models.TrackMultiArtistMetadata()
+                {
+                    DurationMs = durationMs,
+                    Album = album,
+                    Artists = [artist],
+                    Title = title,
+                }
+            );
+
+            if (result is QQMusicSearchResult qqResult)
+            {
+                var response = await Lyricify.Lyrics.Helpers.ProviderHelper.QQMusicApi.GetLyricsAsync(qqResult.Id);
+                var original = response?.Lyrics;
+                return original;
+            }
+            else if (result is NeteaseSearchResult neteaseResult)
+            {
+                var response = await Lyricify.Lyrics.Helpers.ProviderHelper.NeteaseApi.GetLyric(neteaseResult.Id);
+                return response?.Lrc.Lyric;
+            }
+            else if (result is KugouSearchResult kugouResult)
+            {
+                var response = await Lyricify.Lyrics.Helpers.ProviderHelper.KugouApi.GetSearchLyrics(hash: kugouResult.Hash);
+                if (response?.Candidates.FirstOrDefault() is SearchLyricsResponse.Candidate candidate)
+                {
+                    return Lyricify.Lyrics.Decrypter.Krc.Helper.GetLyrics(
+                        candidate.Id,
+                        candidate.AccessKey
+                    );
+                }
+            }
+
+            return null;
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/Playback/PlaybackService.cs

@@ -1,185 +0,0 @@
-using System;
-using System.Diagnostics;
-using System.Threading.Tasks;
-using BetterLyrics.WinUI3.Events;
-using BetterLyrics.WinUI3.Helper;
-using BetterLyrics.WinUI3.Models;
-using BetterLyrics.WinUI3.Services.Database;
-using CommunityToolkit.WinUI;
-using Microsoft.UI.Dispatching;
-using Windows.Media.Control;
-
-namespace BetterLyrics.WinUI3.Services.Playback
-{
-    public partial class PlaybackService : IPlaybackService
-    {
-        private readonly DispatcherQueue _dispatcherQueue = DispatcherQueue.GetForCurrentThread();
-
-        public event EventHandler<SongInfoChangedEventArgs>? SongInfoChanged;
-        public event EventHandler<IsPlayingChangedEventArgs>? IsPlayingChanged;
-        public event EventHandler<PositionChangedEventArgs>? PositionChanged;
-
-        private GlobalSystemMediaTransportControlsSessionManager? _sessionManager = null;
-        private GlobalSystemMediaTransportControlsSession? _currentSession = null;
-
-        public SongInfo? SongInfo { get; private set; }
-        public bool IsPlaying { get; private set; }
-        public TimeSpan Position { get; private set; }
-
-        private readonly IDatabaseService _databaseService;
-
-        public PlaybackService(IDatabaseService databaseService)
-        {
-            _databaseService = databaseService;
-            InitMediaManager().ConfigureAwait(true);
-        }
-
-        private async Task<SongInfo> GetSongInfoAsync()
-        {
-            var songInfo = await _databaseService.FindSongInfoAsync(
-                await _currentSession?.TryGetMediaPropertiesAsync()
-            );
-            songInfo.SourceAppUserModelId = _currentSession?.SourceAppUserModelId;
-            return songInfo;
-        }
-
-        private async Task InitMediaManager()
-        {
-            _sessionManager = await GlobalSystemMediaTransportControlsSessionManager.RequestAsync();
-            _sessionManager.CurrentSessionChanged += SessionManager_CurrentSessionChanged;
-
-            SessionManager_CurrentSessionChanged(_sessionManager, null);
-        }
-
-        public void ReSendingMessages()
-        {
-            // Re-send messages to update UI
-            CurrentSession_MediaPropertiesChanged(_currentSession, null);
-            CurrentSession_PlaybackInfoChanged(_currentSession, null);
-            CurrentSession_TimelinePropertiesChanged(_currentSession, null);
-        }
-
-        /// <summary>
-        /// Note: Non-UI thread
-        /// </summary>
-        /// <param name="sender"></param>
-        /// <param name="args"></param>
-        private void CurrentSession_PlaybackInfoChanged(
-            GlobalSystemMediaTransportControlsSession? sender,
-            PlaybackInfoChangedEventArgs? args
-        )
-        {
-            if (sender == null)
-            {
-                IsPlaying = false;
-            }
-            else
-            {
-                var playbackState = sender.GetPlaybackInfo().PlaybackStatus;
-                // _logger.LogDebug(playbackState.ToString());
-
-                switch (playbackState)
-                {
-                    case GlobalSystemMediaTransportControlsSessionPlaybackStatus.Closed:
-                    case GlobalSystemMediaTransportControlsSessionPlaybackStatus.Opened:
-                    case GlobalSystemMediaTransportControlsSessionPlaybackStatus.Changing:
-                    case GlobalSystemMediaTransportControlsSessionPlaybackStatus.Stopped:
-                    case GlobalSystemMediaTransportControlsSessionPlaybackStatus.Paused:
-                        IsPlaying = false;
-                        break;
-                    case GlobalSystemMediaTransportControlsSessionPlaybackStatus.Playing:
-                        IsPlaying = true;
-                        break;
-                    default:
-                        break;
-                }
-            }
-            _dispatcherQueue.TryEnqueue(() =>
-            {
-                IsPlayingChanged?.Invoke(this, new IsPlayingChangedEventArgs(IsPlaying));
-            });
-        }
-
-        private void SessionManager_CurrentSessionChanged(
-            GlobalSystemMediaTransportControlsSessionManager sender,
-            CurrentSessionChangedEventArgs? args
-        )
-        {
-            // _logger.LogDebug("SessionManager_CurrentSessionChanged");
-            // Unregister events associated with the previous session
-            if (_currentSession != null)
-            {
-                _currentSession.MediaPropertiesChanged -= CurrentSession_MediaPropertiesChanged;
-                _currentSession.PlaybackInfoChanged -= CurrentSession_PlaybackInfoChanged;
-                _currentSession.TimelinePropertiesChanged -=
-                    CurrentSession_TimelinePropertiesChanged;
-            }
-
-            // Record and register events for current session
-            _currentSession = sender.GetCurrentSession();
-
-            if (_currentSession != null)
-            {
-                _currentSession.MediaPropertiesChanged += CurrentSession_MediaPropertiesChanged;
-                _currentSession.PlaybackInfoChanged += CurrentSession_PlaybackInfoChanged;
-                _currentSession.TimelinePropertiesChanged +=
-                    CurrentSession_TimelinePropertiesChanged;
-            }
-
-            ReSendingMessages();
-        }
-
-        /// <summary>
-        /// Note: this func is invoked by non-UI thread
-        /// </summary>
-        /// <param name="sender"></param>
-        /// <param name="args"></param>
-        private void CurrentSession_MediaPropertiesChanged(
-            GlobalSystemMediaTransportControlsSession? sender,
-            MediaPropertiesChangedEventArgs? args
-        )
-        {
-            App.DispatcherQueueTimer!.Debounce(
-                async () =>
-                {
-                    // _logger.LogDebug("CurrentSession_MediaPropertiesChanged");
-                    if (sender == null)
-                        SongInfo = null;
-                    else
-                    {
-                        try
-                        {
-                            SongInfo = await GetSongInfoAsync();
-                        }
-                        catch (Exception) { }
-                    }
-                    _dispatcherQueue.TryEnqueue(() =>
-                    {
-                        SongInfoChanged?.Invoke(this, new SongInfoChangedEventArgs(SongInfo));
-                    });
-                },
-                TimeSpan.FromMilliseconds(AnimationHelper.DebounceDefaultDuration)
-            );
-        }
-
-        private void CurrentSession_TimelinePropertiesChanged(
-            GlobalSystemMediaTransportControlsSession? sender,
-            TimelinePropertiesChangedEventArgs? args
-        )
-        {
-            if (sender == null)
-            {
-                Position = TimeSpan.Zero;
-            }
-            else
-            {
-                Position = sender.GetTimelineProperties().Position;
-            }
-            _dispatcherQueue.TryEnqueue(() =>
-            {
-                PositionChanged?.Invoke(this, new PositionChangedEventArgs(Position));
-            });
-            // _logger.LogDebug(_currentTime);
-        }
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/PlaybackService.cs

@@ -0,0 +1,287 @@
+// 2025/6/23 by Zhe Fang
+
+using BetterLyrics.WinUI3.Events;
+using BetterLyrics.WinUI3.Helper;
+using BetterLyrics.WinUI3.Models;
+using BetterLyrics.WinUI3.ViewModels;
+using CommunityToolkit.Mvvm.DependencyInjection;
+using CommunityToolkit.Mvvm.Messaging;
+using CommunityToolkit.Mvvm.Messaging.Messages;
+using Microsoft.Extensions.Logging;
+using Microsoft.UI.Dispatching;
+using System;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using System.Linq;
+using System.Runtime.InteropServices.WindowsRuntime;
+using System.Threading;
+using System.Threading.Tasks;
+using Windows.Graphics.Imaging;
+using Windows.Media.Control;
+using Windows.Storage.Streams;
+using WindowsMediaController;
+
+namespace BetterLyrics.WinUI3.Services
+{
+    public partial class PlaybackService : BaseViewModel, IPlaybackService,
+        IRecipient<PropertyChangedMessage<ObservableCollection<MediaSourceProviderInfo>>>,
+        IRecipient<PropertyChangedMessage<ObservableCollection<AlbumArtSearchProviderInfo>>>
+    {
+        private readonly IAlbumArtSearchService _albumArtSearchService;
+        private readonly ILogger<PlaybackService> _logger;
+        private readonly MediaManager _mediaManager = new();
+        private readonly LatestOnlyTaskRunner _AlbumArtRefreshRunner = new();
+        private readonly LatestOnlyTaskRunner _OnAnyMediaPropertyChangedRunner = new();
+
+        private SongInfo? _cachedSongInfo;
+        private List<MediaSourceProviderInfo> _mediaSourceProvidersInfo;
+        private byte[]? _SMTCAlbumArtBytes = null;
+        private AlbumArtChangedEventArgs _albumArtChangedEventArgs = new AlbumArtChangedEventArgs();
+
+        public event EventHandler<IsPlayingChangedEventArgs>? IsPlayingChanged;
+        public event EventHandler<PositionChangedEventArgs>? PositionChanged;
+        public event EventHandler<SongInfoChangedEventArgs>? SongInfoChanged;
+        public event EventHandler<AlbumArtChangedEventArgs>? AlbumArtChangedChanged;
+        public event EventHandler<MediaSourceProvidersInfoEventArgs>? MediaSourceProvidersInfoChanged;
+
+        public PlaybackService(ISettingsService settingsService, IAlbumArtSearchService albumArtSearchService) : base(settingsService)
+        {
+            _albumArtSearchService = albumArtSearchService;
+            _logger = Ioc.Default.GetRequiredService<ILogger<PlaybackService>>();
+
+            _mediaSourceProvidersInfo = _settingsService.MediaSourceProvidersInfo;
+            InitMediaManager();
+        }
+
+        private bool IsMediaSourceEnabled(string id)
+        {
+            return _mediaSourceProvidersInfo.FirstOrDefault(s => s.Provider == id)?.IsEnabled ?? true;
+        }
+
+        private void InitMediaManager()
+        {
+            _mediaManager.Start();
+
+            _mediaManager.OnAnySessionOpened += MediaManager_OnAnySessionOpened;
+            _mediaManager.OnAnySessionClosed += MediaManager_OnAnySessionClosed;
+            _mediaManager.OnFocusedSessionChanged += MediaManager_OnFocusedSessionChanged;
+            _mediaManager.OnAnyMediaPropertyChanged += MediaManager_OnAnyMediaPropertyChanged;
+            _mediaManager.OnAnyPlaybackStateChanged += MediaManager_OnAnyPlaybackStateChanged;
+            _mediaManager.OnAnyTimelinePropertyChanged += MediaManager_OnAnyTimelinePropertyChanged;
+
+            MediaManager_OnFocusedSessionChanged(_mediaManager.GetFocusedSession());
+        }
+
+        private void MediaManager_OnFocusedSessionChanged(MediaManager.MediaSession mediaSession)
+        {
+            if (mediaSession == null || !IsMediaSourceEnabled(mediaSession.ControlSession.SourceAppUserModelId))
+            {
+                SendNullMessages();
+            }
+            else
+            {
+                _dispatcherQueue.TryEnqueue(async () =>
+                {
+                    try
+                    {
+                        var props = await mediaSession.ControlSession.TryGetMediaPropertiesAsync();
+                        MediaManager_OnAnyMediaPropertyChanged(mediaSession, props);
+                        MediaManager_OnAnyPlaybackStateChanged(mediaSession, mediaSession.ControlSession.GetPlaybackInfo());
+                    }
+                    catch (Exception ex)
+                    {
+                        _logger.LogWarning(ex, "TryGetMediaPropertiesAsync failed");
+                        SendNullMessages();
+                    }
+                });
+            }
+        }
+
+        private void MediaManager_OnAnyTimelinePropertyChanged(MediaManager.MediaSession mediaSession, GlobalSystemMediaTransportControlsSessionTimelineProperties timelineProperties)
+        {
+            if (!IsMediaSourceEnabled(mediaSession.ControlSession.SourceAppUserModelId) || mediaSession != _mediaManager.GetFocusedSession()) return;
+
+            _dispatcherQueue.TryEnqueue(
+                DispatcherQueuePriority.High,
+                () =>
+                {
+                    PositionChanged?.Invoke(this, new PositionChangedEventArgs(timelineProperties.Position));
+                }
+            );
+        }
+
+        private void MediaManager_OnAnyPlaybackStateChanged(MediaManager.MediaSession mediaSession, GlobalSystemMediaTransportControlsSessionPlaybackInfo playbackInfo)
+        {
+            RecordMediaSourceProviderInfo(mediaSession);
+            if (!IsMediaSourceEnabled(mediaSession.ControlSession.SourceAppUserModelId) || mediaSession != _mediaManager.GetFocusedSession()) return;
+
+            _dispatcherQueue.TryEnqueue(DispatcherQueuePriority.High,
+                () =>
+                {
+                    IsPlayingChanged?.Invoke(this, new IsPlayingChangedEventArgs(playbackInfo.PlaybackStatus switch
+                    {
+                        GlobalSystemMediaTransportControlsSessionPlaybackStatus.Playing => true,
+                        _ => false,
+                    }));
+                }
+            );
+        }
+
+        private void MediaManager_OnAnyMediaPropertyChanged(MediaManager.MediaSession mediaSession, GlobalSystemMediaTransportControlsSessionMediaProperties mediaProperties)
+        {
+            _ = _OnAnyMediaPropertyChangedRunner.RunAsync(async token =>
+            {
+                _logger.LogInformation("Media properties changed: Title: {Title}, Artist: {Artist}, Album: {Album}",
+                    mediaProperties.Title, mediaProperties.Artist, mediaProperties.AlbumTitle);
+
+                RecordMediaSourceProviderInfo(mediaSession);
+                string id = mediaSession.ControlSession.SourceAppUserModelId;
+                if (!IsMediaSourceEnabled(id) || mediaSession != _mediaManager.GetFocusedSession()) return;
+
+                token.ThrowIfCancellationRequested();
+
+                _cachedSongInfo = new SongInfo
+                {
+                    Title = mediaProperties.Title,
+                    Artist = mediaProperties.Artist,
+                    Album = mediaProperties.AlbumTitle,
+                    DurationMs = mediaSession.ControlSession.GetTimelineProperties().EndTime.TotalMilliseconds,
+                    SourceAppUserModelId = id,
+                };
+
+                if (mediaProperties.Thumbnail is IRandomAccessStreamReference streamReference)
+                {
+                    _SMTCAlbumArtBytes = await ImageHelper.ToByteArrayAsync(streamReference);
+                    token.ThrowIfCancellationRequested();
+                }
+
+                _ = _AlbumArtRefreshRunner.RunAsync(async tokne =>
+                {
+                    await UpdateAlbumArtRelated(tokne);
+                });
+
+                if (!token.IsCancellationRequested)
+                {
+                    _dispatcherQueue.TryEnqueue(DispatcherQueuePriority.High,
+                    () =>
+                    {
+                        SongInfoChanged?.Invoke(this, new SongInfoChangedEventArgs(_cachedSongInfo));
+                    });
+                }
+            });
+        }
+
+        private void MediaManager_OnAnySessionClosed(MediaManager.MediaSession mediaSession)
+        {
+            if (_mediaManager.CurrentMediaSessions.Count == 0)
+            {
+                SendNullMessages();
+            }
+        }
+
+        private void MediaManager_OnAnySessionOpened(MediaManager.MediaSession mediaSession)
+        {
+            RecordMediaSourceProviderInfo(mediaSession);
+        }
+
+        private void RecordMediaSourceProviderInfo(MediaManager.MediaSession mediaSession)
+        {
+            var id = mediaSession?.ControlSession?.SourceAppUserModelId;
+            if (string.IsNullOrEmpty(id)) return;
+
+            var found = _mediaSourceProvidersInfo.FirstOrDefault(x => x.Provider == id);
+            if (found == null)
+            {
+                _mediaSourceProvidersInfo.Add(new MediaSourceProviderInfo(id, true));
+                _settingsService.MediaSourceProvidersInfo = _mediaSourceProvidersInfo;
+                _dispatcherQueue.TryEnqueue(DispatcherQueuePriority.High,
+                () =>
+                {
+                    MediaSourceProvidersInfoChanged?.Invoke(this, new MediaSourceProvidersInfoEventArgs(_mediaSourceProvidersInfo));
+                });
+            }
+        }
+
+        private void SendNullMessages()
+        {
+            _dispatcherQueue.TryEnqueue(DispatcherQueuePriority.High,
+            () =>
+            {
+                _cachedSongInfo = null;
+                SongInfoChanged?.Invoke(this, new SongInfoChangedEventArgs(_cachedSongInfo));
+                IsPlayingChanged?.Invoke(this, new IsPlayingChangedEventArgs(false));
+                PositionChanged?.Invoke(this, new PositionChangedEventArgs(TimeSpan.Zero));
+            });
+        }
+
+        private async Task UpdateAlbumArtRelated(CancellationToken token)
+        {
+            if (_cachedSongInfo == null)
+            {
+                _logger.LogWarning("Cached song info is null, cannot update album art.");
+                return;
+            }
+
+            byte[]? bytes = await _albumArtSearchService.SearchAsync(
+                _cachedSongInfo.Title,
+                _cachedSongInfo.Artist,
+                _cachedSongInfo?.Album ?? string.Empty,
+                _SMTCAlbumArtBytes
+            );
+            token.ThrowIfCancellationRequested();
+
+            if (bytes == null)
+            {
+                bytes = await ImageHelper.CreateTextPlaceholderBytesAsync($"{_cachedSongInfo!.Artist} - {_cachedSongInfo.Title}", 400, 400);
+                token.ThrowIfCancellationRequested();
+            }
+
+            using var stream = new InMemoryRandomAccessStream();
+            await stream.WriteAsync(bytes.AsBuffer());
+            token.ThrowIfCancellationRequested();
+
+            var decoder = await BitmapDecoder.CreateAsync(stream);
+            token.ThrowIfCancellationRequested();
+
+            _albumArtChangedEventArgs.AlbumArtSwBitmap = await decoder.GetSoftwareBitmapAsync(BitmapPixelFormat.Rgba8, BitmapAlphaMode.Premultiplied);
+            token.ThrowIfCancellationRequested();
+
+            _albumArtChangedEventArgs.AlbumArtAccentColor = ImageHelper.GetAccentColorsFromByte(bytes).FirstOrDefault();
+
+            _dispatcherQueue.TryEnqueue(DispatcherQueuePriority.High,
+            () =>
+            {
+                AlbumArtChangedChanged?.Invoke(this, _albumArtChangedEventArgs);
+            });
+        }
+
+        public void Receive(PropertyChangedMessage<ObservableCollection<MediaSourceProviderInfo>> message)
+        {
+            if (message.Sender is SettingsPageViewModel)
+            {
+                if (message.PropertyName == nameof(SettingsPageViewModel.MediaSourceProvidersInfo))
+                {
+                    _mediaSourceProvidersInfo = [.. message.NewValue];
+                    _settingsService.MediaSourceProvidersInfo = _mediaSourceProvidersInfo;
+                    MediaManager_OnFocusedSessionChanged(_mediaManager.GetFocusedSession());
+                }
+            }
+        }
+
+        public void Receive(PropertyChangedMessage<ObservableCollection<AlbumArtSearchProviderInfo>> message)
+        {
+            if (message.Sender is SettingsPageViewModel)
+            {
+                if (message.PropertyName == nameof(SettingsPageViewModel.AlbumArtSearchProvidersInfo))
+                {
+                    // Album art search providers info changed, re-fetch album art
+                    _logger.LogInformation("Album art search providers info changed, refreshing album art.");
+                    _ = _AlbumArtRefreshRunner.RunAsync(async tokne =>
+                    {
+                        await UpdateAlbumArtRelated(tokne);
+                    });
+                }
+            }
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/Settings/ISettingsService.cs

@@ -1,46 +0,0 @@
-using System.Collections.Generic;
-using BetterLyrics.WinUI3.Enums;
-using Microsoft.UI.Text;
-using Microsoft.UI.Xaml;
-using Windows.UI.Text;
-
-namespace BetterLyrics.WinUI3.Services.Settings
-{
-    public interface ISettingsService
-    {
-        bool IsFirstRun { get; set; }
-
-        // Lyrics lib
-        List<string> MusicLibraries { get; set; }
-
-        // App appearance
-        ElementTheme ThemeType { get; set; }
-        BackdropType BackdropType { get; set; }
-        TitleBarType TitleBarType { get; set; }
-        Language Language { get; set; }
-
-        // App behavior
-        AutoStartWindowType AutoStartWindowType { get; set; }
-
-        // Album art background
-
-        bool IsCoverOverlayEnabled { get; set; }
-        bool IsDynamicCoverOverlayEnabled { get; set; }
-        int CoverOverlayOpacity { get; set; }
-        int CoverOverlayBlurAmount { get; set; }
-
-        // Album art cover style
-        int CoverImageRadius { get; set; }
-
-        // Lyrics style and effetc
-        LyricsAlignmentType LyricsAlignmentType { get; set; }
-        LyricsFontWeight LyricsFontWeight { get; set; }
-        int LyricsBlurAmount { get; set; }
-        int LyricsVerticalEdgeOpacity { get; set; }
-        float LyricsLineSpacingFactor { get; set; }
-        int LyricsFontSize { get; set; }
-        bool IsLyricsGlowEffectEnabled { get; set; }
-        LyricsGlowEffectScope LyricsGlowEffectScope { get; set; }
-        LyricsFontColorType LyricsFontColorType { get; set; }
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/Settings/SettingsService.cs

@@ -1,228 +0,0 @@
-using System;
-using System.Collections;
-using System.Collections.Generic;
-using System.Linq;
-using BetterLyrics.WinUI3.Enums;
-using CommunityToolkit.Mvvm.ComponentModel;
-using Microsoft.UI.Xaml;
-using Newtonsoft.Json;
-using Windows.Media;
-using Windows.Storage;
-
-namespace BetterLyrics.WinUI3.Services.Settings
-{
-    public class SettingsService : ISettingsService
-    {
-        private readonly ApplicationDataContainer _localSettings;
-
-        private const string IsFirstRunKey = "IsFirstRun";
-
-        // App appearance
-        private const string ThemeTypeKey = "ThemeType";
-        private const string LanguageKey = "Language";
-        private const string MusicLibrariesKey = "MusicLibraries";
-        private const string BackdropTypeKey = "BackdropType";
-
-        // App behavior
-        private const string AutoStartWindowTypeKey = "AutoStartWindowType";
-
-        // Album art
-        private const string IsCoverOverlayEnabledKey = "IsCoverOverlayEnabled";
-        private const string IsDynamicCoverOverlayEnabledKey = "IsDynamicCoverOverlayEnabled";
-        private const string CoverOverlayOpacityKey = "CoverOverlayOpacity";
-        private const string CoverOverlayBlurAmountKey = "CoverOverlayBlurAmount";
-        private const string TitleBarTypeKey = "TitleBarType";
-        private const string CoverImageRadiusKey = "CoverImageRadius";
-
-        private const string LyricsAlignmentTypeKey = "LyricsAlignmentType";
-        private const string LyricsFontWeightKey = "LyricsFontWeightKey";
-        private const string LyricsBlurAmountKey = "LyricsBlurAmount";
-        private const string LyricsVerticalEdgeOpacityKey = "LyricsVerticalEdgeOpacity";
-        private const string LyricsLineSpacingFactorKey = "LyricsLineSpacingFactor";
-        private const string LyricsFontSizeKey = "LyricsFontSize";
-        private const string IsLyricsGlowEffectEnabledKey = "IsLyricsGlowEffectEnabled";
-        private const string LyricsFontColorTypeKey = "LyricsFontColorType";
-        private const string LyricsGlowEffectScopeKey = "LyricsGlowEffectScope";
-
-        public bool IsFirstRun
-        {
-            get => GetValue<bool>(IsFirstRunKey);
-            set => SetValue(IsFirstRunKey, value);
-        }
-
-        public ElementTheme ThemeType
-        {
-            get => (ElementTheme)GetValue<int>(ThemeTypeKey);
-            set => SetValue(ThemeTypeKey, (int)value);
-        }
-
-        public Language Language
-        {
-            get => (Language)GetValue<int>(LanguageKey);
-            set => SetValue(LanguageKey, (int)value);
-        }
-
-        public BackdropType BackdropType
-        {
-            get => (BackdropType)GetValue<int>(BackdropTypeKey);
-            set => SetValue(BackdropTypeKey, (int)value);
-        }
-
-        public AutoStartWindowType AutoStartWindowType
-        {
-            get => (AutoStartWindowType)GetValue<int>(AutoStartWindowTypeKey);
-            set => SetValue(AutoStartWindowTypeKey, (int)value);
-        }
-
-        public List<string> MusicLibraries
-        {
-            get =>
-                JsonConvert.DeserializeObject<List<string>>(
-                    GetValue<string>(MusicLibrariesKey) ?? "[]"
-                )!;
-            set => SetValue(MusicLibrariesKey, JsonConvert.SerializeObject(value));
-        }
-
-        public bool IsCoverOverlayEnabled
-        {
-            get => GetValue<bool>(IsCoverOverlayEnabledKey);
-            set => SetValue(IsCoverOverlayEnabledKey, value);
-        }
-
-        public bool IsDynamicCoverOverlayEnabled
-        {
-            get => GetValue<bool>(IsDynamicCoverOverlayEnabledKey);
-            set => SetValue(IsDynamicCoverOverlayEnabledKey, value);
-        }
-
-        public int CoverOverlayOpacity
-        {
-            get => GetValue<int>(CoverOverlayOpacityKey);
-            set => SetValue(CoverOverlayOpacityKey, value);
-        }
-
-        public int CoverOverlayBlurAmount
-        {
-            get => GetValue<int>(CoverOverlayBlurAmountKey);
-            set => SetValue(CoverOverlayBlurAmountKey, value);
-        }
-
-        public TitleBarType TitleBarType
-        {
-            get => (TitleBarType)GetValue<int>(TitleBarTypeKey);
-            set => SetValue(TitleBarTypeKey, (int)value);
-        }
-
-        public int CoverImageRadius
-        {
-            get => GetValue<int>(CoverImageRadiusKey);
-            set => SetValue(CoverImageRadiusKey, value);
-        }
-
-        public LyricsAlignmentType LyricsAlignmentType
-        {
-            get => (LyricsAlignmentType)GetValue<int>(LyricsAlignmentTypeKey);
-            set => SetValue(LyricsAlignmentTypeKey, (int)value);
-        }
-
-        public LyricsFontWeight LyricsFontWeight
-        {
-            get => (LyricsFontWeight)GetValue<int>(LyricsFontWeightKey);
-            set => SetValue(LyricsFontWeightKey, (int)value);
-        }
-
-        public int LyricsBlurAmount
-        {
-            get => GetValue<int>(LyricsBlurAmountKey);
-            set => SetValue(LyricsBlurAmountKey, value);
-        }
-
-        public int LyricsVerticalEdgeOpacity
-        {
-            get => GetValue<int>(LyricsVerticalEdgeOpacityKey);
-            set => SetValue(LyricsVerticalEdgeOpacityKey, value);
-        }
-
-        public float LyricsLineSpacingFactor
-        {
-            get => GetValue<float>(LyricsLineSpacingFactorKey);
-            set => SetValue(LyricsLineSpacingFactorKey, value);
-        }
-
-        public int LyricsFontSize
-        {
-            get => GetValue<int>(LyricsFontSizeKey);
-            set => SetValue(LyricsFontSizeKey, value);
-        }
-
-        public bool IsLyricsGlowEffectEnabled
-        {
-            get => GetValue<bool>(IsLyricsGlowEffectEnabledKey);
-            set => SetValue(IsLyricsGlowEffectEnabledKey, value);
-        }
-
-        public LyricsGlowEffectScope LyricsGlowEffectScope
-        {
-            get => (LyricsGlowEffectScope)GetValue<int>(LyricsGlowEffectScopeKey);
-            set => SetValue(LyricsGlowEffectScopeKey, (int)value);
-        }
-
-        public LyricsFontColorType LyricsFontColorType
-        {
-            get => (LyricsFontColorType)GetValue<int>(LyricsFontColorTypeKey);
-            set => SetValue(LyricsFontColorTypeKey, (int)value);
-        }
-
-        public SettingsService()
-        {
-            _localSettings = ApplicationData.Current.LocalSettings;
-
-            SetDefault(IsFirstRunKey, true);
-            // App appearance
-            SetDefault(ThemeTypeKey, (int)ElementTheme.Default);
-            SetDefault(LanguageKey, (int)Language.FollowSystem);
-            SetDefault(MusicLibrariesKey, "[]");
-            SetDefault(BackdropTypeKey, (int)BackdropType.DesktopAcrylic);
-            // App behavior
-            SetDefault(AutoStartWindowTypeKey, (int)AutoStartWindowType.StandardMode);
-            // Album art
-            SetDefault(IsCoverOverlayEnabledKey, true);
-            SetDefault(IsDynamicCoverOverlayEnabledKey, true);
-            SetDefault(CoverOverlayOpacityKey, 100); // 100 % = 1.1
-            SetDefault(CoverOverlayBlurAmountKey, 200);
-            SetDefault(TitleBarTypeKey, (int)TitleBarType.Compact);
-            SetDefault(CoverImageRadiusKey, 24); // 24 %
-            // Lyrics
-            SetDefault(LyricsAlignmentTypeKey, (int)LyricsAlignmentType.Center);
-            SetDefault(LyricsFontWeightKey, (int)LyricsFontWeight.Bold);
-            SetDefault(LyricsBlurAmountKey, 0);
-            SetDefault(LyricsFontColorTypeKey, (int)LyricsFontColorType.Default);
-            SetDefault(LyricsFontSizeKey, 28);
-            SetDefault(LyricsLineSpacingFactorKey, 0.5f);
-            SetDefault(LyricsVerticalEdgeOpacityKey, 0);
-            SetDefault(IsLyricsGlowEffectEnabledKey, true);
-            SetDefault(LyricsGlowEffectScopeKey, (int)LyricsGlowEffectScope.CurrentChar);
-        }
-
-        private T? GetValue<T>(string key)
-        {
-            if (_localSettings.Values.TryGetValue(key, out object? value))
-            {
-                return (T)value;
-            }
-            return default;
-        }
-
-        private void SetValue<T>(string key, T value)
-        {
-            _localSettings.Values[key] = value;
-        }
-
-        private void SetDefault<T>(string key, T value)
-        {
-            if (_localSettings.Values.ContainsKey(key) && _localSettings.Values[key] is T)
-                return;
-            _localSettings.Values[key] = value;
-        }
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/SettingsService.cs

@@ -0,0 +1,547 @@
+// 2025/6/23 by Zhe Fang
+
+using BetterLyrics.WinUI3.Enums;
+using BetterLyrics.WinUI3.Helper;
+using BetterLyrics.WinUI3.Models;
+using BetterLyrics.WinUI3.Serialization;
+using CommunityToolkit.WinUI.Helpers;
+using Microsoft.UI;
+using Microsoft.UI.Xaml;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using Windows.Storage;
+using Windows.UI;
+
+namespace BetterLyrics.WinUI3.Services
+{
+    public class SettingsService : ISettingsService
+    {
+        public const string LyricsCustomBgFontColorKey = "LyricsCustomBgFontColor";
+        public const string LyricsCustomFgFontColorKey = "LyricsCustomFgFontColor";
+        public const string LyricsCustomStrokeFontColorKey = "LyricsCustomStrokeFontColor";
+
+        // App behavior
+
+        private const string AutoStartWindowTypeKey = "AutoStartWindowType";
+
+        private const string CoverImageRadiusKey = "AlbumArtCornerRadius";
+        private const string CoverOverlayBlurAmountKey = "CoverOverlayBlurAmount";
+        private const string CoverOverlayOpacityKey = "CoverOverlayOpacity";
+        private const string IsCoverOverlayEnabledKey = "IsCoverOverlayEnabled";
+
+        private const string DesktopWindowLeftKey = "DesktopWindowLeft";
+        private const string DesktopWindowTopKey = "DesktopWindowTop";
+        private const string DesktopWindowWidthKey = "DesktopWindowWidth";
+        private const string DesktopWindowHeightKey = "DesktopWindowHeight";
+
+        private const string StandardWindowLeftKey = "StandardWindowLeft";
+        private const string StandardWindowTopKey = "StandardWindowTop";
+        private const string StandardWindowWidthKey = "StandardWindowWidth";
+        private const string StandardWindowHeightKey = "StandardWindowHeight";
+
+        private const string AutoLockOnDesktopModeKey = "AutoLockOnDesktopMode";
+
+        private const string IsDynamicCoverOverlayEnabledKey = "IsDynamicCoverOverlayEnabled";
+        private const string IsFanLyricsEnabledKey = "IsFanLyricsEnabled";
+        private const string IsFirstRunKey = "IsFirstRun";
+        private const string IsLyricsGlowEffectEnabledKey = "IsLyricsGlowEffectEnabled";
+        private const string LanguageKey = "Language";
+
+        private const string LocalLyricsFoldersKey = "LocalLyricsFolders";
+        private const string LyricsAlignmentTypeKey = "TextAlignmentType";
+        private const string SongInfoAlignmentTypeKey = "SongInfoAlignmentType";
+        private const string LyricsBlurAmountKey = "LyricsBlurAmount";
+
+        private const string LyricsBgFontColorTypeKey = "_lyricsBgFontColorType";
+        private const string LyricsFgFontColorTypeKey = "LyricsFgFontColorType";
+        private const string LyricsStrokeFontColorTypeKey = "LyricsStrokeFontColorType";
+
+        private const string LyricsFontStrokeWidthKey = "LyricsFontStrokeWidth";
+
+        private const string LyricsFontSizeKey = "LyricsFontSize";
+        private const string LyricsFontWeightKey = "LyricsFontWeightKey";
+        private const string LyricsGlowEffectScopeKey = "LyricsGlowEffectScope";
+        private const string LyricsHighlightSopeKey = "LyricsHighlightSope";
+        private const string LyricsLineSpacingFactorKey = "LyricsLineSpacingFactor";
+        private const string LyricsSearchProvidersInfoKey = "LyricsSearchProvidersInfo";
+        private const string AlbumArtSearchProvidersInfoKey = "AlbumArtSearchProvidersInfo";
+        private const string LyricsVerticalEdgeOpacityKey = "LyricsVerticalEdgeOpacity";
+
+        private const string MediaSourceProvidersInfoKey = "MediaSourceProvidersInfo";
+
+        private const string IsTranslationEnabledKey = "IsTranslationEnabled";
+        private const string LibreTranslateServerKey = "LibreTranslateServer";
+        private const string SelectedTargetLanguageIndexKey = "SelectedTargetLanguageIndex";
+
+        private const string LyricsBackgroundThemeKey = "LyricsBackgroundTheme";
+        private const string IgnoreFullscreenWindowKey = "IgnoreFullscreenWindow";
+        private const string PreferredDisplayTypeKey = "PreferredDisplayTypeKey";
+
+        private const string LyricsScrollEasingTypeKey = "LyricsScrollEasingType";
+        private const string LyricsScrollDurationKey = "LyricsScrollDuration";
+
+        public const string TimelineSyncThresholdKey = "TimelineSyncThreshold";
+
+        private readonly ApplicationDataContainer _localSettings;
+
+        public SettingsService()
+        {
+            _localSettings = ApplicationData.Current.LocalSettings;
+
+            SetDefault(IsFirstRunKey, true);
+            // Lyrics lib
+            SetDefault(LocalLyricsFoldersKey, "[]");
+            SetDefault(
+                LyricsSearchProvidersInfoKey,
+                System.Text.Json.JsonSerializer.Serialize(
+                    Enum.GetValues<LyricsSearchProvider>()
+                        .Select(p => new LyricsSearchProviderInfo(p, true))
+                        .ToList(),
+                    SourceGenerationContext.Default.ListLyricsSearchProviderInfo
+                )
+            );
+            if (LyricsSearchProvidersInfo.Count != Enum.GetValues<LyricsSearchProvider>().Length)
+            {
+                LyricsSearchProvidersInfo = Enum.GetValues<LyricsSearchProvider>()
+                    .Select(p => new LyricsSearchProviderInfo(
+                        p,
+                        LyricsSearchProvidersInfo
+                            .Where(x => x.Provider == p)
+                            .FirstOrDefault()
+                            ?.IsEnabled ?? true
+                    ))
+                    .ToList();
+            }
+
+            SetDefault(
+                AlbumArtSearchProvidersInfoKey,
+                System.Text.Json.JsonSerializer.Serialize(
+                    Enum.GetValues<AlbumArtSearchProvider>()
+                        .Select(p => new AlbumArtSearchProviderInfo(p, true))
+                        .ToList(),
+                    SourceGenerationContext.Default.ListAlbumArtSearchProviderInfo
+                )
+            );
+            if (AlbumArtSearchProvidersInfo.Count != Enum.GetValues<AlbumArtSearchProvider>().Length)
+            {
+                AlbumArtSearchProvidersInfo = Enum.GetValues<AlbumArtSearchProvider>()
+                    .Select(p => new AlbumArtSearchProviderInfo(
+                        p,
+                        AlbumArtSearchProvidersInfo
+                            .Where(x => x.Provider == p)
+                            .FirstOrDefault()
+                            ?.IsEnabled ?? true
+                    ))
+                    .ToList();
+            }
+
+            SetDefault(MediaSourceProvidersInfoKey, "[]");
+
+            // App appearance
+            SetDefault(LanguageKey, (int)Language.FollowSystem);
+
+            SetDefault(DesktopWindowHeightKey, 600);
+            SetDefault(DesktopWindowLeftKey, 200);
+            SetDefault(DesktopWindowTopKey, 200);
+            SetDefault(DesktopWindowWidthKey, 1200);
+
+            SetDefault(StandardWindowHeightKey, 800);
+            SetDefault(StandardWindowLeftKey, 200);
+            SetDefault(StandardWindowTopKey, 200);
+            SetDefault(StandardWindowWidthKey, 1600);
+
+            SetDefault(AutoLockOnDesktopModeKey, false);
+            // App behavior
+            SetDefault(AutoStartWindowTypeKey, (int)AutoStartWindowType.StandardMode);
+            // Album art
+            SetDefault(IsCoverOverlayEnabledKey, true);
+            SetDefault(IsDynamicCoverOverlayEnabledKey, true);
+            SetDefault(CoverOverlayOpacityKey, 100); // 100 % = 1.0
+            SetDefault(CoverOverlayBlurAmountKey, 100);
+            SetDefault(CoverImageRadiusKey, 12); // 12 %
+            // Lyrics
+            SetDefault(LyricsAlignmentTypeKey, (int)TextAlignmentType.Center);
+            SetDefault(SongInfoAlignmentTypeKey, (int)TextAlignmentType.Left);
+            SetDefault(LyricsFontWeightKey, (int)LyricsFontWeight.Bold);
+            SetDefault(LyricsBlurAmountKey, 5);
+
+            SetDefault(LyricsBackgroundThemeKey, (int)ElementTheme.Default);
+
+            SetDefault(LyricsBgFontColorTypeKey, (int)LyricsFontColorType.AdaptiveGrayed);
+            SetDefault(LyricsFgFontColorTypeKey, (int)LyricsFontColorType.AdaptiveGrayed);
+            SetDefault(LyricsStrokeFontColorTypeKey, (int)LyricsFontColorType.AdaptiveGrayed);
+
+            SetDefault(LyricsCustomBgFontColorKey, Colors.White.ToInt());
+            SetDefault(LyricsCustomFgFontColorKey, Colors.White.ToInt());
+            SetDefault(LyricsCustomStrokeFontColorKey, Colors.White.ToInt());
+
+            SetDefault(LyricsFontSizeKey, 28);
+            SetDefault(LyricsLineSpacingFactorKey, 0.5f);
+            SetDefault(LyricsVerticalEdgeOpacityKey, 0);
+            SetDefault(IsLyricsGlowEffectEnabledKey, true);
+            SetDefault(LyricsGlowEffectScopeKey, (int)LineRenderingType.CurrentChar);
+            SetDefault(LyricsHighlightSopeKey, (int)LineRenderingType.LineStartToCurrentChar);
+            SetDefault(IsFanLyricsEnabledKey, false);
+
+            SetDefault(LibreTranslateServerKey, "");
+            SetDefault(IsTranslationEnabledKey, false);
+            SetDefault(SelectedTargetLanguageIndexKey, 6);
+
+            SetDefault(LyricsFontStrokeWidthKey, 3);
+            SetDefault(IgnoreFullscreenWindowKey, false);
+            SetDefault(PreferredDisplayTypeKey, (int)LyricsDisplayType.SplitView);
+
+            SetDefault(LyricsScrollEasingTypeKey, (int)EasingType.EaseInOutQuad);
+            SetDefault(LyricsScrollDurationKey, 500); // 500ms
+            SetDefault(TimelineSyncThresholdKey, 0); // 0ms
+        }
+
+        public EasingType LyricsScrollEasingType
+        {
+            get => (EasingType)GetValue<int>(LyricsScrollEasingTypeKey);
+            set => SetValue(LyricsScrollEasingTypeKey, (int)value);
+        }
+
+        public int LyricsScrollDuration
+        {
+            get => GetValue<int>(LyricsScrollDurationKey);
+            set => SetValue(LyricsScrollDurationKey, value);
+        }
+
+        public LyricsDisplayType PreferredDisplayType
+        {
+            get => (LyricsDisplayType)GetValue<int>(PreferredDisplayTypeKey);
+            set => SetValue(PreferredDisplayTypeKey, (int)value);
+        }
+
+        public ElementTheme LyricsBackgroundTheme
+        {
+            get => (ElementTheme)GetValue<int>(LyricsBackgroundThemeKey);
+            set => SetValue(LyricsBackgroundThemeKey, (int)value);
+        }
+
+        public AutoStartWindowType AutoStartWindowType
+        {
+            get => (AutoStartWindowType)GetValue<int>(AutoStartWindowTypeKey);
+            set => SetValue(AutoStartWindowTypeKey, (int)value);
+        }
+
+        public int DesktopWindowLeft
+        {
+            get => GetValue<int>(DesktopWindowLeftKey);
+            set => SetValue(DesktopWindowLeftKey, value);
+        }
+
+        public int DesktopWindowTop
+        {
+            get => GetValue<int>(DesktopWindowTopKey);
+            set => SetValue(DesktopWindowTopKey, value);
+        }
+
+        public int DesktopWindowWidth
+        {
+            get => GetValue<int>(DesktopWindowWidthKey);
+            set => SetValue(DesktopWindowWidthKey, value);
+        }
+
+        public int DesktopWindowHeight
+        {
+            get => GetValue<int>(DesktopWindowHeightKey);
+            set => SetValue(DesktopWindowHeightKey, value);
+        }
+
+        public int StandardWindowLeft
+        {
+            get => GetValue<int>(StandardWindowLeftKey);
+            set => SetValue(StandardWindowLeftKey, value);
+        }
+
+        public int StandardWindowTop
+        {
+            get => GetValue<int>(StandardWindowTopKey);
+            set => SetValue(StandardWindowTopKey, value);
+        }
+
+        public int StandardWindowWidth
+        {
+            get => GetValue<int>(StandardWindowWidthKey);
+            set => SetValue(StandardWindowWidthKey, value);
+        }
+
+        public int StandardWindowHeight
+        {
+            get => GetValue<int>(StandardWindowHeightKey);
+            set => SetValue(StandardWindowHeightKey, value);
+        }
+
+        public bool AutoLockOnDesktopMode
+        {
+            get => GetValue<bool>(AutoLockOnDesktopModeKey);
+            set => SetValue(AutoLockOnDesktopModeKey, value);
+        }
+
+        public int CoverImageRadius
+        {
+            get => GetValue<int>(CoverImageRadiusKey);
+            set => SetValue(CoverImageRadiusKey, value);
+        }
+
+        public int CoverOverlayBlurAmount
+        {
+            get => GetValue<int>(CoverOverlayBlurAmountKey);
+            set => SetValue(CoverOverlayBlurAmountKey, value);
+        }
+
+        public int CoverOverlayOpacity
+        {
+            get => GetValue<int>(CoverOverlayOpacityKey);
+            set => SetValue(CoverOverlayOpacityKey, value);
+        }
+
+        public bool IsDynamicCoverOverlayEnabled
+        {
+            get => GetValue<bool>(IsDynamicCoverOverlayEnabledKey);
+            set => SetValue(IsDynamicCoverOverlayEnabledKey, value);
+        }
+
+        public bool IsFanLyricsEnabled
+        {
+            get => GetValue<bool>(IsFanLyricsEnabledKey);
+            set => SetValue(IsFanLyricsEnabledKey, value);
+        }
+
+        public bool IsFirstRun
+        {
+            get => GetValue<bool>(IsFirstRunKey);
+            set => SetValue(IsFirstRunKey, value);
+        }
+
+        public bool IsLyricsGlowEffectEnabled
+        {
+            get => GetValue<bool>(IsLyricsGlowEffectEnabledKey);
+            set => SetValue(IsLyricsGlowEffectEnabledKey, value);
+        }
+
+        public Language Language
+        {
+            get => (Language)GetValue<int>(LanguageKey);
+            set => SetValue(LanguageKey, (int)value);
+        }
+
+        public List<LocalLyricsFolder> LocalLyricsFolders
+        {
+            get =>
+                System.Text.Json.JsonSerializer.Deserialize(
+                    GetValue<string>(LocalLyricsFoldersKey) ?? "[]",
+                    SourceGenerationContext.Default.ListLocalLyricsFolder
+                )!;
+            set =>
+                SetValue(
+                    LocalLyricsFoldersKey,
+                    System.Text.Json.JsonSerializer.Serialize(
+                        value,
+                        SourceGenerationContext.Default.ListLocalLyricsFolder
+                    )
+                );
+        }
+
+        public TextAlignmentType LyricsAlignmentType
+        {
+            get => (TextAlignmentType)GetValue<int>(LyricsAlignmentTypeKey);
+            set => SetValue(LyricsAlignmentTypeKey, (int)value);
+        }
+
+        public TextAlignmentType SongInfoAlignmentType
+        {
+            get => (TextAlignmentType)GetValue<int>(SongInfoAlignmentTypeKey);
+            set => SetValue(SongInfoAlignmentTypeKey, (int)value);
+        }
+
+        public int LyricsBlurAmount
+        {
+            get => GetValue<int>(LyricsBlurAmountKey);
+            set => SetValue(LyricsBlurAmountKey, value);
+        }
+
+        public Color LyricsCustomBgFontColor
+        {
+            get => GetValue<int>(LyricsCustomBgFontColorKey)!.ToColor();
+            set => SetValue(LyricsCustomBgFontColorKey, value.ToInt());
+        }
+
+        public Color LyricsCustomFgFontColor
+        {
+            get => GetValue<int>(LyricsCustomFgFontColorKey)!.ToColor();
+            set => SetValue(LyricsCustomFgFontColorKey, value.ToInt());
+        }
+
+        public Color LyricsCustomStrokeFontColor
+        {
+            get => GetValue<int>(LyricsCustomStrokeFontColorKey)!.ToColor();
+            set => SetValue(LyricsCustomStrokeFontColorKey, value.ToInt());
+        }
+
+        public LyricsFontColorType LyricsBgFontColorType
+        {
+            get => (LyricsFontColorType)GetValue<int>(LyricsBgFontColorTypeKey);
+            set => SetValue(LyricsBgFontColorTypeKey, (int)value);
+        }
+
+        public LyricsFontColorType LyricsFgFontColorType
+        {
+            get => (LyricsFontColorType)GetValue<int>(LyricsFgFontColorTypeKey);
+            set => SetValue(LyricsFgFontColorTypeKey, (int)value);
+        }
+
+        public LyricsFontColorType LyricsStrokeFontColorType
+        {
+            get => (LyricsFontColorType)GetValue<int>(LyricsStrokeFontColorTypeKey);
+            set => SetValue(LyricsStrokeFontColorTypeKey, (int)value);
+        }
+
+        public int LyricsFontStrokeWidth
+        {
+            get => GetValue<int>(LyricsFontStrokeWidthKey);
+            set => SetValue(LyricsFontStrokeWidthKey, value);
+        }
+
+        public int LyricsFontSize
+        {
+            get => GetValue<int>(LyricsFontSizeKey);
+            set => SetValue(LyricsFontSizeKey, value);
+        }
+
+        public LyricsFontWeight LyricsFontWeight
+        {
+            get => (LyricsFontWeight)GetValue<int>(LyricsFontWeightKey);
+            set => SetValue(LyricsFontWeightKey, (int)value);
+        }
+
+        public LineRenderingType LyricsGlowEffectScope
+        {
+            get => (LineRenderingType)GetValue<int>(LyricsGlowEffectScopeKey);
+            set => SetValue(LyricsGlowEffectScopeKey, (int)value);
+        }
+
+        public LineRenderingType LyricsHighlightScope
+        {
+            get => (LineRenderingType)GetValue<int>(LyricsHighlightSopeKey);
+            set => SetValue(LyricsHighlightSopeKey, (int)value);
+        }
+
+        public float LyricsLineSpacingFactor
+        {
+            get => GetValue<float>(LyricsLineSpacingFactorKey);
+            set => SetValue(LyricsLineSpacingFactorKey, value);
+        }
+
+        public List<LyricsSearchProviderInfo> LyricsSearchProvidersInfo
+        {
+            get =>
+                System.Text.Json.JsonSerializer.Deserialize(
+                    GetValue<string>(LyricsSearchProvidersInfoKey) ?? "[]",
+                    SourceGenerationContext.Default.ListLyricsSearchProviderInfo
+                )!;
+            set =>
+                SetValue(
+                    LyricsSearchProvidersInfoKey,
+                    System.Text.Json.JsonSerializer.Serialize(
+                        value,
+                        SourceGenerationContext.Default.ListLyricsSearchProviderInfo
+                    )
+                );
+        }
+
+        public List<AlbumArtSearchProviderInfo> AlbumArtSearchProvidersInfo
+        {
+            get =>
+                System.Text.Json.JsonSerializer.Deserialize(
+                    GetValue<string>(AlbumArtSearchProvidersInfoKey) ?? "[]",
+                    SourceGenerationContext.Default.ListAlbumArtSearchProviderInfo
+                )!;
+            set =>
+                SetValue(
+                    AlbumArtSearchProvidersInfoKey,
+                    System.Text.Json.JsonSerializer.Serialize(
+                        value,
+                        SourceGenerationContext.Default.ListAlbumArtSearchProviderInfo
+                    )
+                );
+        }
+
+        public List<MediaSourceProviderInfo> MediaSourceProvidersInfo
+        {
+            get =>
+                System.Text.Json.JsonSerializer.Deserialize(
+                    GetValue<string>(MediaSourceProvidersInfoKey) ?? "[]",
+                    SourceGenerationContext.Default.ListMediaSourceProviderInfo
+                )!;
+            set =>
+                SetValue(
+                    MediaSourceProvidersInfoKey,
+                    System.Text.Json.JsonSerializer.Serialize(
+                        value,
+                        SourceGenerationContext.Default.ListMediaSourceProviderInfo
+                    )
+                );
+        }
+
+        public int LyricsVerticalEdgeOpacity
+        {
+            get => GetValue<int>(LyricsVerticalEdgeOpacityKey);
+            set => SetValue(LyricsVerticalEdgeOpacityKey, value);
+        }
+
+        public string LibreTranslateServer
+        {
+            get => GetValue<string>(LibreTranslateServerKey)!;
+            set => SetValue(LibreTranslateServerKey, value);
+        }
+
+        public bool IsTranslationEnabled
+        {
+            get => GetValue<bool>(IsTranslationEnabledKey);
+            set => SetValue(IsTranslationEnabledKey, value);
+        }
+
+        public int SelectedTargetLanguageIndex
+        {
+            get => GetValue<int>(SelectedTargetLanguageIndexKey);
+            set => SetValue(SelectedTargetLanguageIndexKey, value);
+        }
+
+        public bool IgnoreFullscreenWindow
+        {
+            get => GetValue<bool>(IgnoreFullscreenWindowKey);
+            set => SetValue(IgnoreFullscreenWindowKey, value);
+        }
+
+        public int TimelineSyncThreshold
+        {
+            get => GetValue<int>(TimelineSyncThresholdKey);
+            set => SetValue(TimelineSyncThresholdKey, value);
+        }
+
+        private T? GetValue<T>(string key)
+        {
+            if (_localSettings.Values.TryGetValue(key, out object? value))
+            {
+                return (T)value;
+            }
+            return default;
+        }
+
+        private void SetDefault<T>(string key, T value)
+        {
+            if (_localSettings.Values.ContainsKey(key) && _localSettings.Values[key] is T)
+                return;
+            _localSettings.Values[key] = value;
+        }
+
+        private void SetValue<T>(string key, T value)
+        {
+            _localSettings.Values[key] = value;
+        }
+    }
+}