From 52ef41f1566ad7dd1235e9971231af2f03bf4867 Mon Sep 17 00:00:00 2001
From: zarzet <42882290+zarzet@users.noreply.github.com>
Date: Sun, 18 Oct 2026 19:24:39 +0700
Subject: [PATCH] docs(readme): describe the lyrics providers and online search
Explain the default provider order and Search online in the FAQ, mention
SpotiFLAC-Mobile Lyrics in the Lyrics feature, and credit lrc.red,
LyricsPlus and BetterLyrics.
---
README.md | 22 +++++++++++++++++++---
1 file changed, 19 insertions(+), 3 deletions(-)
diff --git a/README.md b/README.md
index 1e9d3ff1..f7c3cfe4 100644
--- a/README.md
+++ b/README.md
@@ -118,8 +118,9 @@
Synced lyrics with word-by-word timing, optional translation and
- romanization lines, and several lyrics providers with automatic
- fallback. Pick up to five lines and share them as a card.
+ romanization lines, and a reorderable chain of lyrics providers,
+ including SpotiFLAC-Mobile Lyrics. Files without lyrics can search
+ online from the player. Pick up to five lines and share them as a card.
@@ -334,6 +335,18 @@ your DAC or amplifier volume before you press play.
+
+Where do the lyrics come from?
+
+
+From the providers in **Settings > Lyrics > Lyrics Provider Priority**, tried
+top to bottom until one has the song. By default that is Apple Music (through
+Paxsenix), lrc.red, SpotiFLAC-Mobile Lyrics, LyricsPlus and LRCLIB; you can
+reorder them or turn on others. Lyrics already in a file always come first.
+If a file has none, tap **Search online** on the player's lyrics page.
+
+
+
Where are my listening statistics stored?
@@ -413,8 +426,11 @@ Interested in contributing? Check out the [Contributing Guide](CONTRIBUTING.md)
## API Credits
