maxrave-dev / maxrave-dev/SimpMusic

Offline lyric cache requires manual provider switch to load word-by-word sync,

Open
#2,489 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Kotlin
Stars
11.4k
Forks
599
Avg merge
3d 18h
Merged PRs (30d)
7

Description

Duplicate Check
  • I confirm I searched for existing reports and found no duplicates.
Describe the Bug
Bug Description

There is an offline lyrics caching issue involving the "SimpMusic Lyrics" and "LRCLIB" providers.

When online, fetching word-by-word lyrics using the default SimpMusic Lyrics provider works fine. However, after downloading the track and closing/reopening the app in offline mode, the lyrics do not display under the default provider.

Manually switching the Main Lyrics Provider to LRCLIB while offline immediately triggers the app to read the cached data, and the word-by-word animations load perfectly. The app seems to lose track of the offline cached lyric file until the provider toggle is manually switched to LRCLIB.

Steps to Reproduce
  1. Set Main Lyrics Provider to "SimpMusic Lyrics".
  2. Play and download a song online with word-by-word lyrics.
  3. Completely close the app.
  4. Turn off internet connection (Offline Mode).
  5. Open the app and play the downloaded song (lyrics are blank).
  6. Go to settings and switch the provider to "LRCLIB" (lyrics instantly appear word-by-word).
Expected Behavior

The app should automatically recognize and load the offline word-by-word lyric cache without requiring a manual provider switch every time the app is reopened offline.

Steps to Reproduce

Hi

Expected Behavior

When I'm using the main simp lyric to work on offline mode

App Version

SimpMusic-foss-arm64-v8a-release.apk

Android Version

Android 15

Device Model

Redmi 14c

Custom ROM
  • I am using a custom ROM
Custom ROM Name (if applicable)

No response

Screenshots (optional)

No response

Log / Error Details

No response

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by tracing the SimpMusic Lyrics provider selection and offline lyric-cache loading during downloaded-song playback. Reproduce the issue with the listed provider-switch sequence on Android, then verify that reopening offline automatically loads the cached word-by-word lyrics without switching to LRCLIB.

Written by the indexing model from the issue text.

Assessment

Tech stack
kotlin
Domain
mobile
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
67/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.