add: support 0 duration for lyrics animation

2026-01-12 19:24:55 +08:00 · 2025-11-23 09:46:18 -05:00
parent 93d567e21d
commit 181a06c932
21 changed files with 161 additions and 83 deletions
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Constants/Link.cs
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Constants/Link.cs
@@ -2,16 +2,17 @@
 {
    public static class Link
    {
-        public const string MicrosoftStoreUrl = "https://apps.microsoft.com/detail/9p1wcd1p597r";
-        public const string GitHubUrl = "https://github.com/jayfunc/BetterLyrics";
-        public const string ShareHubUrl = $"{GitHubUrl}/blob/dev/ShareHub/index.md";
-        public const string TermsOfServiceUrl = $"{GitHubUrl}/blob/dev/TermsofService.md";
-        public const string PrivacyPolicy = $"{GitHubUrl}/blob/dev/PrivacyPolicy.md";
-        public const string WikiUrl = "https://jayfunc.blog/work/betterlyrics";
-        public const string AppleMusicCfgUrl = $"{WikiUrl}#lyrics-sources-configuration";
-        public const string FAQUrl = $"{WikiUrl}#faq";
-        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 const string TelegramUrl = "https://t.me/+svhSLZ7awPsxNGY1";
+        public const string MicrosoftStore = "https://apps.microsoft.com/detail/9p1wcd1p597r";
+        
+        public const string GitHub = "https://github.com/jayfunc/BetterLyrics";
+        public const string ShareHub = $"{GitHub}/blob/dev/ShareHub/index.md";
+        public const string TermsOfService = $"{GitHub}/blob/dev/TermsofService.md";
+        public const string PrivacyPolicy = $"{GitHub}/blob/dev/PrivacyPolicy.md";
+        public const string UserGuide = $"{GitHub}/wiki/User-Guide";
+        public const string AppleMusicCfg = $"{UserGuide}#lyrics-source-configuration";
+
+        public const string QQGroup = "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 Discord = "https://discord.gg/5yAQPnyCKv";
+        public const string Telegram = "https://t.me/+svhSLZ7awPsxNGY1";
    }
 }
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/AboutControl.xaml
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/AboutControl.xaml
@@ -51,11 +51,10 @@
                            <dev:SettingsCard HorizontalContentAlignment="Left" ContentAlignment="Left">
                                <StackPanel Spacing="6">
                                    <StackPanel Margin="-12,0,0,0" Orientation="Horizontal">
-                                        <HyperlinkButton Content="GitHub" NavigateUri="{x:Bind const:Link.GitHubUrl}" />
-                                        <HyperlinkButton Content="Wiki" NavigateUri="{x:Bind const:Link.WikiUrl}" />
-                                        <HyperlinkButton Content="FAQ" NavigateUri="{x:Bind const:Link.FAQUrl}" />
+                                        <HyperlinkButton Content="GitHub" NavigateUri="{x:Bind const:Link.GitHub}" />
+                                        <HyperlinkButton x:Uid="UserGuide" NavigateUri="{x:Bind const:Link.UserGuide}" />
                                        <HyperlinkButton x:Uid="PrivacyPolicy" NavigateUri="{x:Bind const:Link.PrivacyPolicy}" />
-                                        <HyperlinkButton x:Uid="TermsOfService" NavigateUri="{x:Bind const:Link.TermsOfServiceUrl}" />
+                                        <HyperlinkButton x:Uid="TermsOfService" NavigateUri="{x:Bind const:Link.TermsOfService}" />
                                    </StackPanel>
                                </StackPanel>

@@ -65,9 +64,9 @@
                                <StackPanel Spacing="6">
                                    <TextBlock x:Uid="SetingsPageFeedback" />
                                    <StackPanel Margin="-12,0,0,0" Orientation="Horizontal">
-                                        <HyperlinkButton x:Uid="SettingsPageQQGroup" NavigateUri="{x:Bind const:Link.QQGroupUrl}" />
-                                        <HyperlinkButton x:Uid="SettingsPageDiscord" NavigateUri="{x:Bind const:Link.DiscordUrl}" />
-                                        <HyperlinkButton x:Uid="SettingsPageTelegram" NavigateUri="{x:Bind const:Link.TelegramUrl}" />
+                                        <HyperlinkButton x:Uid="SettingsPageQQGroup" NavigateUri="{x:Bind const:Link.QQGroup}" />
+                                        <HyperlinkButton x:Uid="SettingsPageDiscord" NavigateUri="{x:Bind const:Link.Discord}" />
+                                        <HyperlinkButton x:Uid="SettingsPageTelegram" NavigateUri="{x:Bind const:Link.Telegram}" />
                                    </StackPanel>
                                </StackPanel>
                            </dev:SettingsCard>
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/LyricsEffectSettingsControl.xaml
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/LyricsEffectSettingsControl.xaml
@@ -224,7 +224,7 @@
                        </dev:SettingsExpander.Items>
                    </dev:SettingsExpander>

-                    <!--  滚动动画  -->
+                    <!--  歌词动画  -->
                    <dev:SettingsExpander x:Uid="SettingsPageScrollEasing" HeaderIcon="{ui:FontIcon FontFamily={StaticResource IconFontFamily}, Glyph=&#xECE7;}">
                        <ComboBox SelectedIndex="{x:Bind LyricsEffectSettings.LyricsScrollEasingType, Mode=TwoWay, Converter={StaticResource EnumToIntConverter}}">
                            <ComboBoxItem x:Uid="SettingsPageEasingTypeLinear" />
@@ -246,7 +246,7 @@
                                    Default="500"
                                    Frequency="50"
                                    Maximum="1000"
-                                    Minimum="50"
+                                    Minimum="0"
                                    Unit="ms"
                                    Value="{x:Bind LyricsEffectSettings.LyricsScrollTopDuration, Mode=TwoWay}" />
                            </dev:SettingsCard>
@@ -255,7 +255,7 @@
                                    Default="500"
                                    Frequency="50"
                                    Maximum="1000"
-                                    Minimum="50"
+                                    Minimum="0"
                                    Unit="ms"
                                    Value="{x:Bind LyricsEffectSettings.LyricsScrollDuration, Mode=TwoWay}" />
                            </dev:SettingsCard>
@@ -264,7 +264,7 @@
                                    Default="500"
                                    Frequency="50"
                                    Maximum="1000"
-                                    Minimum="50"
+                                    Minimum="0"
                                    Unit="ms"
                                    Value="{x:Bind LyricsEffectSettings.LyricsScrollBottomDuration, Mode=TwoWay}" />
                            </dev:SettingsCard>
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/LyricsSearchControl.xaml
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/LyricsSearchControl.xaml
@@ -195,6 +195,10 @@
                                            x:Uid="LyricsPageMatchPercentage"
                                            Unit="%"
                                            Value="{x:Bind MatchPercentage, Mode=OneWay}" />
+                                        <local:PropertyRow
+                                            x:Uid="LyricsPageCachePath"
+                                            Link="{x:Bind SelfPath, TargetNullValue=N/A, Mode=OneWay}"
+                                            ToolTipService.ToolTip="{x:Bind SelfPath, TargetNullValue=N/A, Mode=OneWay}" />
                                    </StackPanel>
                                    <!--  NOT FOUND  -->
                                    <TextBlock
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/LyricsWindowSettingsControl.xaml
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/LyricsWindowSettingsControl.xaml
@@ -60,7 +60,7 @@
                            </Button>

                            <!--  Sharing hub  -->
-                            <HyperlinkButton x:Uid="SettingsPageShareHub" NavigateUri="{x:Bind constants:Link.ShareHubUrl}" />
+                            <HyperlinkButton x:Uid="SettingsPageShareHub" NavigateUri="{x:Bind constants:Link.ShareHub}" />

                        </StackPanel>

--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/PlaybackSettingsControl.xaml
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/PlaybackSettingsControl.xaml
@@ -308,9 +308,7 @@
                            HorizontalAlignment="Stretch"
                            HorizontalContentAlignment="Left">
                            <StackPanel Spacing="6">
-                                <!--  Playback source  -->
                                <local:PropertyRow x:Uid="SettingsPagePlaybackSource" Value="{x:Bind ViewModel.MediaSessionsService.CurrentMediaSourceProviderInfo.DisplayName, Mode=OneWay}" />
-                                <!--  Playback source ID  -->
                                <local:PropertyRow x:Uid="SettingsPagePlaybackSourceID" Value="{x:Bind ViewModel.MediaSessionsService.CurrentSongInfo.PlayerId, TargetNullValue=N/A, Mode=OneWay}" />
                            </StackPanel>
                        </Expander>
@@ -321,13 +319,9 @@
                            HorizontalAlignment="Stretch"
                            HorizontalContentAlignment="Left">
                            <StackPanel Spacing="6">
-                                <!--  Song title  -->
                                <local:PropertyRow x:Uid="SettingsPageSongTitle" Value="{x:Bind ViewModel.MediaSessionsService.CurrentSongInfo.Title, TargetNullValue=N/A, Mode=OneWay}" />
-                                <!--  Song artists  -->
                                <local:PropertyRow x:Uid="SettingsPageArtist" Value="{x:Bind ViewModel.MediaSessionsService.CurrentSongInfo.DisplayArtists, TargetNullValue=N/A, Mode=OneWay}" />
-                                <!--  Song album  -->
                                <local:PropertyRow x:Uid="SettingsPageAlbum" Value="{x:Bind ViewModel.MediaSessionsService.CurrentSongInfo.Album, TargetNullValue=N/A, Mode=OneWay}" />
-                                <!--  Song duration  -->
                                <local:PropertyRow
                                    x:Uid="LyricsSearchControlDurauion"
                                    Unit="s"
@@ -341,30 +335,27 @@
                            HorizontalAlignment="Stretch"
                            HorizontalContentAlignment="Left">
                            <StackPanel Spacing="6">
-                                <!--  Searched title  -->
                                <local:PropertyRow x:Uid="SettingsPageSongTitle" Value="{x:Bind ViewModel.MediaSessionsService.CurrentLyricsSearchResult.Title, TargetNullValue=N/A, Mode=OneWay}" />
-                                <!--  Searched artists  -->
                                <local:PropertyRow x:Uid="SettingsPageArtist" Value="{x:Bind ViewModel.MediaSessionsService.CurrentLyricsSearchResult.DisplayArtists, TargetNullValue=N/A, Mode=OneWay}" />
-                                <!--  Searched album  -->
                                <local:PropertyRow x:Uid="SettingsPageAlbum" Value="{x:Bind ViewModel.MediaSessionsService.CurrentLyricsSearchResult.Album, TargetNullValue=N/A, Mode=OneWay}" />
-                                <!--  Searched duration  -->
                                <local:PropertyRow
                                    x:Uid="LyricsSearchControlDurauion"
                                    Unit="s"
                                    Value="{x:Bind ViewModel.MediaSessionsService.CurrentLyricsSearchResult.Duration, TargetNullValue=N/A, Mode=OneWay}" />
-                                <!--  Lyrics source  -->
                                <local:PropertyRow
                                    x:Uid="LyricsPageLyricsProviderPrefix"
                                    Link="{x:Bind ViewModel.MediaSessionsService.CurrentLyricsSearchResult.Reference, Mode=OneWay}"
                                    ToolTipService.ToolTip="{x:Bind ViewModel.MediaSessionsService.CurrentLyricsSearchResult.Reference, TargetNullValue=N/A, Mode=OneWay}"
                                    Value="{x:Bind ViewModel.MediaSessionsService.CurrentLyricsSearchResult.ProviderIfFound, Mode=OneWay, Converter={StaticResource LyricsSearchProviderToDisplayNameConverter}}" />
-                                <!--  Translation source  -->
                                <local:PropertyRow x:Uid="LyricsPageTranslationProviderPrefix" Value="{x:Bind ViewModel.MediaSessionsService.TranslationSearchProvider, Mode=OneWay, Converter={StaticResource TranslationSearchProviderToDisplayNameConverter}}" />
-                                <!--  Match percentage  -->
                                <local:PropertyRow
                                    x:Uid="LyricsPageMatchPercentage"
                                    Unit="%"
                                    Value="{x:Bind ViewModel.MediaSessionsService.CurrentLyricsSearchResult.MatchPercentage, Mode=OneWay}" />
+                                <local:PropertyRow
+                                    x:Uid="LyricsPageCachePath"
+                                    Link="{x:Bind ViewModel.MediaSessionsService.CurrentLyricsSearchResult.SelfPath, TargetNullValue=N/A, Mode=OneWay}"
+                                    ToolTipService.ToolTip="{x:Bind ViewModel.MediaSessionsService.CurrentLyricsSearchResult.SelfPath, TargetNullValue=N/A, Mode=OneWay}" />
                            </StackPanel>
                        </Expander>

@@ -508,7 +499,7 @@
                                    Content="{ui:FontIcon FontFamily={StaticResource IconFontFamily},
                                                          FontSize=12,
                                                          Glyph=&#xE897;}"
-                                    NavigateUri="{x:Bind constants:Link.AppleMusicCfgUrl}" />
+                                    NavigateUri="{x:Bind constants:Link.AppleMusicCfg}" />
                                <Button
                                    Grid.Column="2"
                                    Command="{x:Bind ViewModel.SaveAppleMusicMediaUserTokenCommand}"
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/CanvasHelper.cs
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/CanvasHelper.cs
@@ -5,6 +5,7 @@ using Microsoft.Graphics.Canvas.Brushes;
 using Microsoft.Graphics.Canvas.Effects;
 using Microsoft.Graphics.Canvas.UI.Xaml;
 using Microsoft.UI;
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Numerics;
@@ -55,11 +56,11 @@ namespace BetterLyrics.WinUI3.Helper
                    Source = new GaussianBlurEffect
                    {
                        Source = backgroundFontEffect,
-                        BlurAmount = (float)lyricsLine.BlurAmountTransition.Value,
+                        BlurAmount = (float)Math.Max(lyricsLine.BlurAmountTransition.Value, 0),
                        BorderMode = EffectBorderMode.Soft,
                        Optimization = EffectOptimization.Speed,
                    },
-                    Opacity = (float)(lyricsLine.OpacityTransition.Value * lyricsLayerOpacity),
+                    Opacity = (float)Math.Max(lyricsLine.OpacityTransition.Value * lyricsLayerOpacity, 0),
                };
            }
        }
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/FileHelper.cs
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/FileHelper.cs
@@ -48,6 +48,7 @@ namespace BetterLyrics.WinUI3.Helper
            {
                var json = File.ReadAllText(cacheFilePath);
                var data = System.Text.Json.JsonSerializer.Deserialize(json, SourceGenerationContext.Default.LyricsSearchResult);
+                data?.SelfPath = cacheFilePath;
                return data;
            }
            return null;
@@ -68,6 +69,7 @@ namespace BetterLyrics.WinUI3.Helper
            var cacheFilePath = Path.Combine(
                lyricsSearchResult.Provider.GetCacheDirectory(),
                SanitizeFileName($"{songInfo.ToFileName()}.json"));
+            lyricsSearchResult.SelfPath = cacheFilePath;
            var json = System.Text.Json.JsonSerializer.Serialize(lyricsSearchResult, SourceGenerationContext.Default.LyricsSearchResult);
            File.WriteAllText(cacheFilePath, json);
        }
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/ValueTransition.cs
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/ValueTransition.cs
@@ -57,7 +57,7 @@ namespace BetterLyrics.WinUI3.Helper

        public void SetDuration(double seconds)
        {
-            if (seconds <= 0)
+            if (seconds < 0)
                throw new ArgumentOutOfRangeException(nameof(seconds), "Duration must be positive.");
            _durationSeconds = seconds;
        }
@@ -145,7 +145,7 @@ namespace BetterLyrics.WinUI3.Helper
            }
        }

-        private Func<T, T, double, T> GetInterpolatorByEasingType(EasingType type)
+        private Func<T, T, double, T> GetInterpolatorByEasingType(EasingType? type)
        {
            if (typeof(T) == typeof(double))
            {
@@ -193,6 +193,7 @@ namespace BetterLyrics.WinUI3.Helper
                            t = EasingHelper.Linear(t);
                            break;
                        default:
+                            t = EasingHelper.EaseInOutQuad(t);
                            break;
                    }
                    return (T)(object)(s + (e - s) * t);
@@ -201,7 +202,7 @@ namespace BetterLyrics.WinUI3.Helper
            throw new NotSupportedException($"Easing type {type} is not supported for type {typeof(T)}.");
        }

-        public void SetEasingType(EasingType easingType)
+        public void SetEasingType(EasingType? easingType)
        {
            _easingType = easingType;
            _interpolator = GetInterpolatorByEasingType(easingType);
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Models/LyricsLine.cs
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Models/LyricsLine.cs
@@ -3,6 +3,7 @@
 using BetterLyrics.WinUI3.Enums;
 using BetterLyrics.WinUI3.Extensions;
 using BetterLyrics.WinUI3.Helper;
+using CommunityToolkit.Mvvm.ComponentModel;
 using Microsoft.Graphics.Canvas.Geometry;
 using Microsoft.Graphics.Canvas.Text;
 using Microsoft.Graphics.Canvas.UI.Xaml;
@@ -13,37 +14,13 @@ namespace BetterLyrics.WinUI3.Models
 {
    public class LyricsLine
    {
-        private const double _animationDuration = 0.3;
-        public ValueTransition<double> AngleTransition { get; set; } = new(
-            initialValue: 0,
-            durationSeconds: _animationDuration,
-            easingType: EasingType.EaseInOutQuad
-        );
-        public ValueTransition<double> BlurAmountTransition { get; set; } = new(
-            initialValue: 0,
-            durationSeconds: _animationDuration,
-            easingType: EasingType.EaseInOutQuad
-        );
-        public ValueTransition<double> HighlightOpacityTransition { get; set; } = new(
-            initialValue: 0,
-            durationSeconds: _animationDuration,
-            easingType: EasingType.EaseInOutQuad
-        );
-        public ValueTransition<double> OpacityTransition { get; set; } = new(
-            initialValue: 0,
-            durationSeconds: _animationDuration,
-            easingType: EasingType.EaseInOutQuad
-        );
-        public ValueTransition<double> ScaleTransition { get; set; } = new(
-            initialValue: 0,
-            durationSeconds: _animationDuration,
-            easingType: EasingType.EaseInOutQuad
-        );
-        public ValueTransition<double> YOffsetTransition { get; set; } = new(
-            initialValue: 0,
-            durationSeconds: 0.5,
-            easingType: EasingType.EaseInOutQuad
-        );
+        public double AnimationDuration { get; set; } = 0.3;
+        public ValueTransition<double> AngleTransition { get; set; }
+        public ValueTransition<double> BlurAmountTransition { get; set; }
+        public ValueTransition<double> HighlightOpacityTransition { get; set; }
+        public ValueTransition<double> OpacityTransition { get; set; }
+        public ValueTransition<double> ScaleTransition { get; set; }
+        public ValueTransition<double> YOffsetTransition { get; set; }

        public CanvasTextLayout? OriginalCanvasTextLayout { get; private set; }
        public CanvasTextLayout? TranslatedCanvasTextLayout { get; private set; }
@@ -86,6 +63,40 @@ namespace BetterLyrics.WinUI3.Models
        public CanvasGeometry? TranslatedCanvasGeometry { get; private set; }
        public CanvasGeometry? PhoneticCanvasGeometry { get; private set; }

+        public LyricsLine()
+        {
+            AngleTransition = new(
+                initialValue: 0,
+                durationSeconds: AnimationDuration,
+                easingType: EasingType.EaseInOutQuad
+            );
+            BlurAmountTransition = new(
+                 initialValue: 0,
+                 durationSeconds: AnimationDuration,
+                 easingType: EasingType.EaseInOutQuad
+             );
+            HighlightOpacityTransition = new(
+                initialValue: 0,
+                durationSeconds: AnimationDuration,
+                easingType: EasingType.EaseInOutQuad
+            );
+            OpacityTransition = new(
+                initialValue: 0,
+                durationSeconds: AnimationDuration,
+                easingType: EasingType.EaseInOutQuad
+            );
+            ScaleTransition = new(
+                initialValue: 0,
+                durationSeconds: AnimationDuration,
+                easingType: EasingType.EaseInOutQuad
+            );
+            YOffsetTransition = new(
+                initialValue: 0,
+                durationSeconds: AnimationDuration,
+                easingType: EasingType.EaseInOutQuad
+            );
+        }
+
        public void UpdateCenterPosition(double maxWidth, TextAlignmentType type)
        {
            if (OriginalCanvasTextLayout == null)
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Models/LyricsSearchResult.cs
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Models/LyricsSearchResult.cs
@@ -1,4 +1,5 @@
 using BetterLyrics.WinUI3.Enums;
+using BetterLyrics.WinUI3.Extensions;
 using CommunityToolkit.Mvvm.ComponentModel;
 using NTextCat.Commons;
 using System;
@@ -28,6 +29,8 @@ namespace BetterLyrics.WinUI3.Models
        [ObservableProperty] public partial int MatchPercentage { get; set; } = -1;
        [ObservableProperty] public partial string Reference { get; set; } = "about:blank";

+        public string? SelfPath { get; set; }
+
        public bool IsFound => !string.IsNullOrEmpty(Raw);

        public LyricsSearchProvider? ProviderIfFound => IsFound ? Provider : null;
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/DiscordService/DiscordService.cs
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/DiscordService/DiscordService.cs
@@ -26,7 +26,7 @@ namespace BetterLyrics.WinUI3.Services.DiscordService
            {
                StatusDisplay = StatusDisplayType.Details,
                Type = ActivityType.Listening,
-                Buttons = new Button[] { new() { Label = "Get this status", Url = Constants.Link.MicrosoftStoreUrl } },
+                Buttons = new Button[] { new() { Label = "Get this status", Url = Constants.Link.MicrosoftStore } },
                Assets = new Assets
                {
                    LargeImageKey = "banner",
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/LyricsSearchService/LyricsSearchService.cs
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Services/LyricsSearchService/LyricsSearchService.cs
@@ -40,7 +40,7 @@ namespace BetterLyrics.WinUI3.Services.LyricsSearchService
            _lrcLibHttpClient = new();
            _lrcLibHttpClient.DefaultRequestHeaders.Add(
                "User-Agent",
-                $"{Constants.App.AppName} {MetadataHelper.AppVersion} ({Constants.Link.GitHubUrl})"
+                $"{Constants.App.AppName} {MetadataHelper.AppVersion} ({Constants.Link.GitHub})"
            );
            _amllTtmlDbHttpClient = new();
            _appleMusic = new AppleMusic();
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Strings/en-US/Resources.resw
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Strings/en-US/Resources.resw
@@ -231,6 +231,12 @@
  <data name="LyricsNotFound" xml:space="preserve">
    <value>Lyrics not found</value>
  </data>
+  <data name="LyricsPageCachePath.Header" xml:space="preserve">
+    <value>Cache path</value>
+  </data>
+  <data name="LyricsPageCachePath.Value" xml:space="preserve">
+    <value>Cache path</value>
+  </data>
  <data name="LyricsPageLyricsProviderPrefix.Header" xml:space="preserve">
    <value>Lyrics provider</value>
  </data>
@@ -1286,7 +1292,7 @@ If you encounter any problems, please go to the Settings page, About tab, and vi
    <value>Current line duration</value>
  </data>
  <data name="SettingsPageScrollEasing.Header" xml:space="preserve">
-    <value>Lyrics scrolling animation type</value>
+    <value>Lyric animation type</value>
  </data>
  <data name="SettingsPageScrollTopDelay.Header" xml:space="preserve">
    <value>First line delay</value>
@@ -1501,4 +1507,7 @@ If you encounter any problems, please go to the Settings page, About tab, and vi
  <data name="TryRunMultipleInstance" xml:space="preserve">
    <value>BetterLyrics is already running</value>
  </data>
+  <data name="UserGuide.Content" xml:space="preserve">
+    <value>User Guide</value>
+  </data>
 </root>
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Strings/ja-JP/Resources.resw
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Strings/ja-JP/Resources.resw
@@ -231,6 +231,12 @@
  <data name="LyricsNotFound" xml:space="preserve">
    <value>歌詞が見つかりません</value>
  </data>
+  <data name="LyricsPageCachePath.Header" xml:space="preserve">
+    <value>キャッシュパス</value>
+  </data>
+  <data name="LyricsPageCachePath.Value" xml:space="preserve">
+    <value>キャッシュパス</value>
+  </data>
  <data name="LyricsPageLyricsProviderPrefix.Header" xml:space="preserve">
    <value>歌詞プロバイダー</value>
  </data>
@@ -1286,7 +1292,7 @@
    <value>現在のライン期間</value>
  </data>
  <data name="SettingsPageScrollEasing.Header" xml:space="preserve">
-    <value>歌詞スクロールアニメーションタイプ</value>
+    <value>リリックアニメーションタイプ</value>
  </data>
  <data name="SettingsPageScrollTopDelay.Header" xml:space="preserve">
    <value>最初の行の遅延</value>
@@ -1501,4 +1507,7 @@
  <data name="TryRunMultipleInstance" xml:space="preserve">
    <value>BetterLyrics はすでに実行されています</value>
  </data>
+  <data name="UserGuide.Content" xml:space="preserve">
+    <value>利用案内</value>
+  </data>
 </root>
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Strings/ko-KR/Resources.resw
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Strings/ko-KR/Resources.resw
@@ -231,6 +231,12 @@
  <data name="LyricsNotFound" xml:space="preserve">
    <value>가사를 찾을 수 없습니다</value>
  </data>
+  <data name="LyricsPageCachePath.Header" xml:space="preserve">
+    <value>캐시</value>
+  </data>
+  <data name="LyricsPageCachePath.Value" xml:space="preserve">
+    <value>캐시</value>
+  </data>
  <data name="LyricsPageLyricsProviderPrefix.Header" xml:space="preserve">
    <value>가사 제공자</value>
  </data>
@@ -1286,7 +1292,7 @@
    <value>현재 라인 기간</value>
  </data>
  <data name="SettingsPageScrollEasing.Header" xml:space="preserve">
-    <value>가사 스크롤링 애니메이션 유형</value>
+    <value>가사 애니메이션 유형</value>
  </data>
  <data name="SettingsPageScrollTopDelay.Header" xml:space="preserve">
    <value>첫 번째 줄 지연</value>
@@ -1501,4 +1507,7 @@
  <data name="TryRunMultipleInstance" xml:space="preserve">
    <value>BetterLyrics 가 이미 실행 중입니다</value>
  </data>
+  <data name="UserGuide.Content" xml:space="preserve">
+    <value>사용 안내서</value>
+  </data>
 </root>
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Strings/zh-CN/Resources.resw
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Strings/zh-CN/Resources.resw
@@ -231,6 +231,12 @@
  <data name="LyricsNotFound" xml:space="preserve">
    <value>未找到歌词</value>
  </data>
+  <data name="LyricsPageCachePath.Header" xml:space="preserve">
+    <value>缓存路径</value>
+  </data>
+  <data name="LyricsPageCachePath.Value" xml:space="preserve">
+    <value>缓存路径</value>
+  </data>
  <data name="LyricsPageLyricsProviderPrefix.Header" xml:space="preserve">
    <value>歌词来源</value>
  </data>
@@ -1286,7 +1292,7 @@
    <value>当前行持续时间</value>
  </data>
  <data name="SettingsPageScrollEasing.Header" xml:space="preserve">
-    <value>歌词滚动动画类型</value>
+    <value>歌词动画类型</value>
  </data>
  <data name="SettingsPageScrollTopDelay.Header" xml:space="preserve">
    <value>首行延时</value>
@@ -1501,4 +1507,7 @@
  <data name="TryRunMultipleInstance" xml:space="preserve">
    <value>BetterLyrics 已经在运行</value>
  </data>
+  <data name="UserGuide.Content" xml:space="preserve">
+    <value>使用指南</value>
+  </data>
 </root>
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Strings/zh-TW/Resources.resw
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Strings/zh-TW/Resources.resw
@@ -231,6 +231,12 @@
  <data name="LyricsNotFound" xml:space="preserve">
    <value>找不到歌詞</value>
  </data>
+  <data name="LyricsPageCachePath.Header" xml:space="preserve">
+    <value>檔案路徑緩存</value>
+  </data>
+  <data name="LyricsPageCachePath.Value" xml:space="preserve">
+    <value>檔案路徑緩存</value>
+  </data>
  <data name="LyricsPageLyricsProviderPrefix.Header" xml:space="preserve">
    <value>歌詞來源</value>
  </data>
@@ -1286,7 +1292,7 @@
    <value>當前行持續時間</value>
  </data>
  <data name="SettingsPageScrollEasing.Header" xml:space="preserve">
-    <value>歌詞滾動動畫類型</value>
+    <value>歌詞動畫類型</value>
  </data>
  <data name="SettingsPageScrollTopDelay.Header" xml:space="preserve">
    <value>首行延時</value>
@@ -1501,4 +1507,7 @@
  <data name="TryRunMultipleInstance" xml:space="preserve">
    <value>BetterLyrics 已經在運作</value>
  </data>
+  <data name="UserGuide.Content" xml:space="preserve">
+    <value>使用手冊</value>
+  </data>
 </root>
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/ViewModels/AboutControlViewModel.cs
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/ViewModels/AboutControlViewModel.cs
@@ -36,7 +36,7 @@ namespace BetterLyrics.WinUI3.ViewModels
        [RelayCommand]
        private async Task LaunchProjectGitHubPageAsync()
        {
-            await Windows.System.Launcher.LaunchUriAsync(new Uri(Constants.Link.GitHubUrl));
+            await Windows.System.Launcher.LaunchUriAsync(new Uri(Constants.Link.GitHub));
        }

        [RelayCommand]
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/ViewModels/LyricsRendererViewModel/LyricsRendererViewModel.Draw.cs
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/ViewModels/LyricsRendererViewModel/LyricsRendererViewModel.Draw.cs
@@ -370,7 +370,7 @@ namespace BetterLyrics.WinUI3.ViewModels.LyricsRendererViewModel
                    combinedDs.DrawImage(new OpacityEffect
                    {
                        Source = effectLayer,
-                        Opacity = (float)(line.HighlightOpacityTransition.Value * _lyricsOpacityTransition.Value),
+                        Opacity = (float)Math.Max(line.HighlightOpacityTransition.Value * _lyricsOpacityTransition.Value, 0),
                    });

                    if (i == _playingLineIndex)
--- a/BetterLyrics.WinUI3/BetterLyrics.WinUI3/ViewModels/LyricsRendererViewModel/LyricsRendererViewModel.Update.cs
+++ b/BetterLyrics.WinUI3/BetterLyrics.WinUI3/ViewModels/LyricsRendererViewModel/LyricsRendererViewModel.Update.cs
@@ -892,7 +892,27 @@ namespace BetterLyrics.WinUI3.ViewModels.LyricsRendererViewModel
                        yScrollDelay = distanceFactor * _liveStatesService.LiveStates.LyricsWindowStatus.LyricsEffectSettings.LyricsScrollBottomDelay / 1000.0;
                    }

-                    line.YOffsetTransition.SetEasingType(_canvasYScrollTransition.EasingType ?? EasingType.Linear);
+                    line.AngleTransition.SetEasingType(_canvasYScrollTransition.EasingType);
+                    line.AngleTransition.SetDuration(yScrollDuration);
+                    line.AngleTransition.SetDelay(yScrollDelay);
+
+                    line.ScaleTransition.SetEasingType(_canvasYScrollTransition.EasingType);
+                    line.ScaleTransition.SetDuration(yScrollDuration);
+                    line.ScaleTransition.SetDelay(yScrollDelay);
+
+                    line.BlurAmountTransition.SetEasingType(_canvasYScrollTransition.EasingType);
+                    line.BlurAmountTransition.SetDuration(yScrollDuration);
+                    line.BlurAmountTransition.SetDelay(yScrollDelay);
+
+                    line.OpacityTransition.SetEasingType(_canvasYScrollTransition.EasingType);
+                    line.OpacityTransition.SetDuration(yScrollDuration);
+                    line.OpacityTransition.SetDelay(yScrollDelay);
+
+                    line.HighlightOpacityTransition.SetEasingType(_canvasYScrollTransition.EasingType);
+                    line.HighlightOpacityTransition.SetDuration(yScrollDuration);
+                    line.HighlightOpacityTransition.SetDelay(yScrollDelay);
+
+                    line.YOffsetTransition.SetEasingType(_canvasYScrollTransition.EasingType);
                    line.YOffsetTransition.SetDuration(yScrollDuration);
                    line.YOffsetTransition.SetDelay(yScrollDelay);
                    line.YOffsetTransition.StartTransition(_canvasTargetYScrollOffset, _isLayoutChanged);