IceCast 当前播放字段含%符号时无法更新的求助

Hey there! I’ve run into this exact issue a few times with IceCast, so let’s break down what’s happening and how to fix it.

Why the % Symbol Breaks Your Metadata #

IceCast uses the % character as a special escape/identifier character in its metadata parsing system. It’s built to recognize patterns like %artist% or %title% when pulling dynamic metadata from sources. When you throw a raw % into your track text, IceCast tries to interpret whatever comes after it as a metadata variable—which doesn’t exist in your case. This messes up the entire metadata format, so the "currently playing" field fails to update correctly.

How to Fix It #

Here are three reliable solutions to get % working in your metadata:

• Double up the % symbol: The simplest fix is to replace every single % with %%. IceCast will parse %% as a single, literal % character. For example, if your track text is "Summer Mix 50%", change it to "Summer Mix 50%%"—this will show up correctly in the "currently playing" field.
• Configure your streaming client: If you’re using a tool like Liquidsoap, Butt, or Winamp to send metadata to IceCast, check the client’s settings. Many clients have built-in options to automatically escape special characters like % in metadata. Enabling this feature will handle the conversion for you without manual edits.
• Update IceCast to the latest stable version: Older IceCast releases (pre-2.4.x) had bugs in metadata parsing that could cause issues with special characters. Upgrading to the newest stable version fixes many of these edge cases and might resolve the problem without extra configuration.

Quick Note on Other Radio Stations #

The stations you’ve seen using % without issues aren’t doing anything magical—they’re either using a client that auto-escapes the symbol, or they’ve manually implemented the %% replacement in their metadata workflow. IceCast doesn’t support raw % by default, but these workarounds make it possible.

内容的提问来源于stack exchange，提问作者Andrew Fabri