Soulsolid Soulsolid
Soulsolid

Analyze

Analyze Feature The analyze feature aims to run an analysis of the metadata of your library and fill those missing gaps.

Analyze Jobs

At the moment, jobs for adding AcoustID and Lyrics are available. More analysis will be added in future releases of Soulsolid.

AcoustID Analysis

The AcoustID analysis job computes acoustic fingerprints for your audio tracks and matches them against the AcoustID database. This helps identify songs accurately, filling in missing or incorrect metadata such as track titles, artists, albums, and other tags. It’s particularly useful for tracks with incomplete information or those obtained from unknown sources.

Lyrics Analysis

The Lyrics analysis job searches for and adds lyrics to your tracks using configured providers. Currently supported providers include:

  • Lrclib: A lyrics database that provides synchronized and plain text lyrics.
  • Dummy: A placeholder provider for testing or when no other providers are available.

The job will skip tracks that already have lyrics and attempt to fetch lyrics for tracks without them. If lyrics are found, they are embedded into the track’s metadata.

Analyze Jobs

This is how the jobs logs look like. You’ll be able to browse over these logs and see which tracks could be processed correctly and which tracks failed. For those which failed, you’ll be able to manually fix them by clicking on manual_fix="track".

time=2025-11-30T11:42:34.416+01:00 level=INFO msg="Starting job" name="Analyze Lyrics for Library"
time=2025-11-30T11:42:34.416+01:00 level=INFO msg="EXECUTE STARTED: Lyrics job task is running" color=pink
time=2025-11-30T11:42:34.416+01:00 level=INFO msg="Enabled lyrics providers" providers="map[dummy:true lrclib:true]" color=blue
time=2025-11-30T11:42:34.416+01:00 level=INFO msg="Starting lyrics analysis" totalTracks=16 color=blue
time=2025-11-30T11:42:34.416+01:00 level=INFO msg=Progress percentage=0 status="Starting analysis of 16 tracks"
time=2025-11-30T11:42:34.424+01:00 level=INFO msg=Progress percentage=0 status="Processing track 1/16: 4 + 20"
time=2025-11-30T11:42:34.424+01:00 level=INFO msg="Skipping track with existing lyrics" trackID=5a56532c-9f5b-57d0-a9eb-c7e6f81cac77 title="4 + 20" lyricsLength=661 color=orange
time=2025-11-30T11:42:36.890+01:00 level=ERROR msg="Failed to add lyrics for track" trackID=c3fded61-1a6b-5fbb-ac51-ce1ec30ae07c title="A contraluz" provider=lrclib error="failed to search lyrics with provider 'lrclib': no lyrics found" manual_fix="track"
time=2025-11-30T11:42:36.890+01:00 level=INFO msg=Progress percentage=6 status="Processing track 2/16: Almost Cut My Hair"
time=2025-11-30T11:42:36.890+01:00 level=INFO msg="Skipping track with existing lyrics" trackID=d4aaa7ad-27c1-5370-9c42-ce881e36cca3 title="Almost Cut My Hair" lyricsLength=656 color=orange
time=2025-11-30T11:42:36.890+01:00 level=INFO msg=Progress percentage=6 status="Processing track 2/16: Carry On"
time=2025-11-30T11:42:36.890+01:00 level=INFO msg="Skipping track with existing lyrics" trackID=3b3c0e60-3c8c-5694-8eed-213656355b0f title="Carry On" lyricsLength=906 color=orange
time=2025-11-30T11:42:38.569+01:00 level=INFO msg="Lyrics analysis completed" totalTracks=16 processed=2 updated=0 skipped=14 color=green

(Scroll left to see the full log line)
Prev
Jobs
Next
Configuration