Skip to content

Subathon timer triggers

Time added

Runs every time time is added to (or taken from) a subathon timer: by a sub, bits, a tip, a follow, a raid, a reward or by hand. Good for a "+5:00" alert or a thank you.

Setting What to put in
Timer Only for this timer. Leave it empty for every timer.

Variables you get

Variable What it holds
%timer% The timer's name
%seconds% Seconds added (negative when time was taken away), after the multiplier
%formattedSeconds% The same as text, like +0:05:00
%user% Who added it (empty when it was added by hand)
%platform% Their platform
%reason% What added it, like Subscription, Cheer, Follow, the reward's name or Manual
%remaining% Seconds left now
%formattedRemaining% Time left now, like 4:05:00
%multiplier% The multiplier that was used

Type id: subathon.timeAdded

Timer ended

Runs when a subathon timer reaches 0:00:00. Good for ending the stream (an OBS sub-action), a raid or a big thank you.

Setting What to put in
Timer Only for this timer. Leave it empty for every timer.

Variables you get

Variable What it holds
%timer% The timer's name
%elapsed% Seconds the subathon ran in all
%formattedElapsed% How long it ran, like 26:03:10

Type id: subathon.ended

Timer paused

Runs when a subathon timer is paused, by hand, by a sub-action or because your stream ended.

Setting What to put in
Timer Only for this timer. Leave it empty for every timer.

Variables you get

Variable What it holds
%timer% The timer's name
%remaining% Seconds left
%formattedRemaining% Time left, like 2:15:30
%elapsed% Seconds it has run so far

Type id: subathon.paused

Timer resumed

Runs when a paused subathon timer carries on.

Setting What to put in
Timer Only for this timer. Leave it empty for every timer.

Variables you get

Variable What it holds
%timer% The timer's name
%remaining% Seconds left
%formattedRemaining% Time left, like 2:15:30

Type id: subathon.resumed

Timer started

Runs when a subathon timer starts (from its starting length). Good for announcing the subathon in chat.

Setting What to put in
Timer Only for this timer. Leave it empty for every timer.

Variables you get

Variable What it holds
%timer% The timer's name
%timerId% The timer's internal id
%state% Running
%remaining% Seconds left
%formattedRemaining% Time left, like 4:00:00
%elapsed% Seconds it has run so far
%formattedElapsed% Time it has run so far, like 1:30:00
%multiplier% The multiplier for event time (1 = normal)

Type id: subathon.started