Embed a GoTimer on your site

Every GoTimer works as an iframe. Grab a URL, paste it into your site, the OBS browser source, a Notion embed block, Google Slides, a classroom projector — anywhere. All customisation happens via URL parameters. No account needed.

Quickstart

<iframe src="https://gotimer.org/embed/countdown?duration=300"
  width="400" height="400" frameborder="0"></iframe>

For auto-resizing, add the resizer script once per page:

<script src="https://gotimer.org/embed.js"></script>

Parameters

Core

• label — display label, defaults to timer type
• controls — full | minimal | none
• autostart — 1 starts immediately
• started — ISO timestamp; duration is offset by elapsed time

Appearance

• theme — auto | light | dark | classroom | streaming | darkroom
• bg — transparent or a hex colour like %23112233
• accent — hex colour for the timer ring
• font — Google Font name, e.g. Orbitron
• size — xs | sm | md | lg | xl | full

Messages

• message — text shown above the timer while running
• expired_message — text shown when the timer hits zero

Watermark

• branding — full | minimal | corner | hidden (hidden requires pro_token)

Platform recipes

OBS / Twitch browser source

https://gotimer.org/embed/countdown?duration=300&theme=streaming&bg=transparent&message=Back+in+5+minutes&branding=corner

Notion embed block

https://gotimer.org/embed/countdown?duration=1500&label=Pomodoro&theme=light

Classroom projector

https://gotimer.org/embed/countdown?duration=300&theme=classroom&autostart=1