Skip to content

Placeholders

Yakuda edited this page Aug 10, 2026 · 1 revision

Placeholder Reference

Every {name} the app understands. They work in All-in-one strings, in the Hardware and MediaPlay custom lines, in plugin templates, and as Placeholder blocks on the Advanced canvas.

The + button next to any of those fields opens the same list as a menu, so nothing has to be typed from memory.


Rules

Rule Meaning
Case-insensitive {GPU_Usage} = {gpu_usage}
Unknown name Renders as nothing
Empty value Removed together with its separators
\n A real line break

The separator rule is what makes templates writable:

Template:  GPU: {gpu_usage} | VRAM: {vram_usage} | CPU: {cpu_usage}
No VRAM:   GPU: 88% | CPU: 41%

Personal Status

Placeholder Value
{text} The rotating text of the active template
{text_1} … {text_20} One specific slot of the active template
{text_t1} … {text_t10} The rotating text of that template
{text_t3_5} Slot 5 of template 3

{text_template3} and {text_tpl3} are accepted spellings of {text_t3}.

MediaPlay

Placeholder Value
{artist} Artist
{title} Song title, cut to the configured length
{time} Position and length, e.g. 1:27/3:45
{time_status} Position only
{time_end} Length only
{bar} The progress bar
{lyrics} The current synced lyric line
{lyrics_prefix} The lyric marker symbol
{icon_sound} The small ♪ icon
{media_idle} The idle text shown between songs

Hardware

Placeholder Value
{gpu_name} Card name
{gpu_usage} GPU load
{gpu_temp} GPU temperature
{gpu_power} GPU power draw
{vram_usage} VRAM used
{cpu_name} CPU model
{cpu_usage} CPU load
{cpu_temp} CPU temperature
{cpu_power} CPU package power
{ram_usage} RAM used
{ram_type} Your free-text RAM label
{fps} Frames per second (MangoHud)
{temp_icon} 🔥 above the threshold, otherwise nothing

A value whose checkbox is off is empty. The template asks, the checkbox permits.

Chat / Speech to Text

Available in Variables send mode.

Placeholder Value
{stt_input} / {stt_output} Spoken: before / after translation
{ttt_input} / {ttt_output} Typed to text: before / after
{chat_input} / {chat_output} From the Chat card
{text_input} / {text_output} Whichever of the three sent last

Custom Box

Placeholder Value
{box_start} The top frame line
{box_stop} The bottom frame line
{box_text} Just the middle text, without frame characters
{box_clock} The clock, for use inside a box middle text

With All in one active these are the only way the frame appears.

Live info

Placeholder Value
{player_in_world} Players in the current world
{group_world} Group world name
{instance_type} Instance type
{realtime} Current time

Plugins

Placeholder Value
{<id>} The plugin's own line
{<id>_<key>} One of its named values

A plugin may also claim a name without the prefix. A built-in value always wins, so a plugin cannot hijack one.


Formatting

Style markers are resolved after placeholders, so their content can be one:

{sup/"RX 9070 XT"}       small and raised, literal text
{sup/{cpu_usage}}        small and raised, a value
{sub/"vram"}             small and lowered

Characters without a small-letter mapping pass through unchanged, so a line never breaks — it just mixes sizes.

OSC-DreamChatbox · GPL-3.0-or-later · github.com/yakuda-stack/OSC-DreamChatbox

Clone this wiki locally