Metadatas

Troubleshooting · Icecast metadata

Spotycast metadata not updating

If track titles are missing, stale, or incorrect, the audio path may still be healthy. The issue is usually in the metadata side channel: Spotify metadata ingestion, Liquidsoap tag forwarding, Icecast now-playing propagation, or player-side caching.

Icecast metadata Now playing Liquidsoap tags Stale titles
Related guides: Device not showing, Dropouts, No audio.

Quick answer

If audio is correct but titles do not refresh, the problem is usually not in the audio samples themselves. It is more often in the metadata side channel: Spotify metadata ingestion, Liquidsoap propagation, Icecast now-playing state, or the client’s refresh behavior.

The fastest diagnostic is to compare Icecast now-playing against what the player displays. If Icecast is correct and the player is wrong, the issue is often client-side caching.

Typical symptoms

Track title never changes

The stream plays correctly, but the same title remains visible across multiple songs.

Artist or title is blank

The player sees a stream but does not receive complete metadata fields.

Metadata updates late

Title changes eventually arrive, but with a lag or only after reconnecting the player.

Common causes

  • Liquidsoap not forwarding metadata correctly
  • Icecast mountpoint metadata path not updated as expected
  • Player-side caching in Roon, LMS, Volumio or another client
  • Metadata generated only on startup instead of per track update
  • Unexpected tag format or missing artist / title fields
  • Frontend reading the wrong mountpoint or stale endpoint
If audio itself is missing, use No audio. If playback cuts, use Dropouts.

Step-by-step fix

01 · Reference Spotify current track Confirm the title / artist you expect to see.
02 · Pipeline Liquidsoap logs Check whether metadata enters and survives the stream pipeline.
03 · Publication Icecast now-playing Use Icecast as the neutral reference point.
04 · Client Player display Compare Roon, LMS, Volumio, VLC or ffplay behavior.

1. Check Icecast now-playing first

Icecast is the best neutral reference. If Icecast shows the right metadata, the player may simply be caching it badly.

2. Verify the mountpoint

A surprising number of stale metadata incidents come from reading an old mountpoint instead of the one currently in use.

3. Test another client

If one player is stale and another is correct, the issue is likely client-side caching rather than stream-side failure.

http://YOUR_HOST:YOUR_PORT/YOUR_MOUNT

vlc http://YOUR_HOST:YOUR_PORT/YOUR_MOUNT
ffplay http://YOUR_HOST:YOUR_PORT/YOUR_MOUNT
After configuration changes, restart the relevant services cleanly so both audio and tags are republished consistently.
systemctl restart spotifyd
systemctl restart liquidsoap
systemctl restart icecast2

What to collect in logs

Metadata issues are easiest to isolate when you compare what each layer believes is the current title.

journalctl -u liquidsoap -n 200 --no-pager
journalctl -u icecast2 -n 200 --no-pager
curl http://YOUR_HOST:YOUR_PORT/status-json.xsl
The most useful evidence chain is: Spotify current trackLiquidsoap logsIcecast now-playingplayer display.

How Spotycast fits into the fix

Spotycast is designed to expose Spotify playback as a stable HTTP / Icecast stream, including usable now-playing behavior. When metadata is wrong, the failure is usually localized to the metadata propagation path rather than the transport of audio itself.

When this is probably not a metadata issue

If the stream is silent, the issue is not just metadata. If the device never appears in Spotify, the incident starts earlier in the chain.

Frequently asked questions

Why is Icecast showing no metadata?

The most common reason is that metadata is not being forwarded correctly from the upstream source into the published mountpoint.

Why does my player keep showing an old title?

Often because the player caches metadata updates aggressively. If Icecast now-playing is correct, the client is the likely bottleneck.

Can metadata work differently between Roon, LMS and VLC?

Yes. Different clients refresh and display stream metadata differently, so the same mountpoint can appear more reactive in one player than another.

Can Spotycast still be used with Roon or LMS once metadata is fixed?

Yes. Once metadata propagation is correct, Spotycast provides a standard HTTP / Icecast stream with usable now-playing behavior for compatible clients.

Debug metadata separately from audio.

If the stream plays but the title is missing, stale, or delayed, isolate the metadata path layer by layer. Icecast now-playing is your best reference point: once it is correct, remaining inconsistencies usually come from player refresh behavior.