Marathon-Timer Marathon-Timer
Support the project Follow me on Twitch Connect

Run the timer from the chat

Chat commands for your mods, the time left answered to !timer, platforms, rights and safeguards.

Updated November 3, 2026

What chat commands do

Chat commands let your mods run the timer without opening the site: add or remove time, pause, start a happy hour. They work on Twitch, Kick and YouTube, and all of them begin with the same word, !timer by default.

They are off until you turn them on: by default, nothing in your chat is read.

Turning them on

  1. In the menu, open 💬 Chat commands.
  2. Tick Turn chat commands on.
  3. Under Platforms, tick the ones you want listened to.
  4. On Twitch, click Allow chat reading on Twitch: you go through Twitch, then come back to the page.
  5. Click Save.
Kick and YouTube need nothing more: the platform only has to be connected in Connections. The YouTube chat is only read while your timer is running.

Who can use them

  • You, always, on your own channel.
  • Moderators and VIPs (Twitch and Kick), if you tick them.
  • Other people allowed: their usernames, separated by commas, for a friend or an editor who is not a mod.

The commands

  • !timer +5m adds 5 minutes, !timer -30s removes 30 seconds. Durations are written 30s, 5m, 1h, 1h30; a number alone counts as minutes.
  • !timer pause and !timer start pause and restart the timer.
  • !timer hh on starts a 60-minute ×2 happy hour on every event; !timer hh on x3 30m picks the multiplier and the length; !timer hh off ends it.

Each command is switched on or off on its own: your mods can add time without being able to remove any.

Answering the time left

Tick Answer the time left when anyone types the command alone: any viewer who writes !timer gets the time left in the chat, for example ⏱️ Time left: 4:12:09.

  • One answer per Time between two answers (30 seconds by default) for the whole chat: twenty viewers typing the command at once get a single message.
  • On Twitch there is nothing more to allow. On Kick, then click Reconnect Kick: Kick asks for the permission to write in your chat.
  • YouTube is left out: every message would use up the quota that reading your chat needs.

The safeguards

  • Most time per command: a command asking for more is brought down to this limit. A typo cannot add a whole day.
  • Only while the timer is running: with the timer paused, adding or removing time and happy hours are refused. start and pause always work.
  • Once the subathon is over, commands are refused, except adding time if you let events revive the timer in Set Timer.
  • One person can run one command every two seconds: a line pasted twice by mistake only counts once.

The latest commands are listed at the bottom of the page, with who typed them and what they did: handy to know where an addition came from.