Todos los parámetros de URL del widget de Tomatoro, explicados

El widget de Tomatoro no tiene panel de ajustes ni archivo de configuración. Todo lo que necesita viene de la URL que incrustas. Eso lo hace portátil — el mismo enlace se comporta igual en Notion, un sitio web, una wiki o una app de notas. Aquí está la referencia completa.

La URL base

https://tomatoro.com/widget

Por sí sola, esta carga el temporizador y sigue la preferencia del sistema operativo del usuario para modo claro u oscuro. Para muchos embeds, eso es todo lo que necesitas.

Control de tema

Agrega un parámetro theme en la URL para fijar la apariencia sin importar el sistema operativo del usuario:

URL	Resultado
/widget	Sigue el sistema operativo
/widget?theme=light	Siempre claro
/widget?theme=dark	Siempre oscuro
/widget?theme=system	Sigue el sistema explícitamente

Usa un tema fijo cuando la página que lo rodea tiene un look fijo — un espacio de trabajo claro en Notion, una bóveda oscura en Obsidian, un sitio de marca. Usa system (o ningún parámetro) cuando el widget vive en un lugar que ya se adapta al sistema operativo.

Combinándolo con el tamaño

El tamaño no es un parámetro de URL — lo define el contenedor donde incrustas (el width/height de un iframe, o el ancho del bloque en una herramienta no-code). Los dos trabajan juntos:

<iframe
  src="https://tomatoro.com/widget?theme=light"
  width="460"
  height="620"
  style="border: 0; border-radius: 24px;"
  title="Temporizador Pomodoro de Tomatoro"
></iframe>

• 460 × 620 px muestra la tarjeta completa — selector de segmento, anillo de cuenta regresiva, cosecha del día y controles.
• Baja la altura a unos 560 px para mostrar solo la cuenta regresiva y los controles.
• Mantén el ancho por encima de 320 px para que los botones sigan siendo cómodos de tocar.

Una nota sobre parámetros desconocidos

Cualquier cosa que el widget no reconoce simplemente se ignora, así que es seguro dejar parámetros de seguimiento o anclas en la URL — no romperán el embed. Ante la duda, empieza desde la URL base y agrega solo theme.