Documentation

Timer widgets

See the templates, Inputs, and Parts of each Blocky timer for Notion, from the Stopwatch and World clock to the Countdown and Pomodoro timers.

Blocky has 4 timer Widget types: the Stopwatch, World clock, Countdown timer, and Pomodoro timer. This page lists the templates, the Inputs, and the Parts of each timer. The controls that every widget shares, such as Size, Colors, and Corners, are on the settings page.

Create a timer

In the create dialog, pick Timer under Category, the timer in Widget type, and a template under Style. Then click Open editor. Create a widget gives every step.

Timers do not take Notion data. Only charts, quotes, and flashcards take Notion data.

Elements and Parts of a timer

Each timer has its own Elements, in the tab with the name of its Widget type in the Add element dialog. A template starts with some of them, and you can add the others. The Parts of an Element are indented under it in the Elements panel. Work with Elements explains how to add an Element.

Stopwatch

The Stopwatch counts up. Press play to start, press it again to pause, and press reset to go back to zero.

In the create dialog, the Stopwatch is Stopwatch. It has 5 templates: Normal, Minimalist, Retro, Neomorphic, and Neon. The Stopwatch has no Inputs tab.

The Stopwatch tab of the Add element dialog has this Element:

ElementPartsTemplates with it
StopwatchNone. You can make the time pulse with Pulse while running and Pulse while paused.All

World clock

The World clock shows the current time and date in a time zone. Add a Clock for each city that you follow.

In the create dialog, the World clock is World. It has 5 templates: Normal, Minimalist, Gradient, Retro, and Analog. The World clock has no Inputs tab. Each Clock sets its zone in its Time zone Part.

The World clock tab of the Add element dialog has two Elements named Clock:

ElementPartsTemplates with it
Clock with a digital timeTime zone, with its Icon. Readout, which keeps Time and Date together in some templates.Normal, Minimalist, Gradient, Retro
Clock with a clock faceTime zone, with its Icon. Dial, the analog face. Time, the digital time under the Dial.Analog

The Time zone Part sets the zone that the whole Clock follows, and the name that it shows.

Countdown timer

The Countdown timer counts down to a date. It shows the date and the days, hours, minutes, and seconds left, and it can show your own words when the time runs out.

In the create dialog, the Countdown timer is Countdowns. It has 6 templates: Normal, Minimalist, Digital, Holiday, Space, and Circular.

Its Inputs tab has Counting down to, the date that the countdown runs to. A new Countdown timer counts down to one month from today.

The Countdown tab of the Add element dialog has this Element:

ElementPartsTemplates with it
CountdownTarget date, with its Icon. Panel, the box around the readout, with its Numbers and Captions. Ring, the circular progress ring, with its Percent. Only the Circular template has a Ring.All

Pomodoro timer

The Pomodoro timer runs focus sessions. When you start it, the time counts down from your Focus time.

In the create dialog, the Pomodoro timer is Pomodoro. It has 7 templates: Normal, Minimalist, Retro, Gamified, Nature, Zen, and Boss.

Its Inputs tab has the inputs for the Elements that the widget has, including hidden Elements:

  • Focus sets the length of a focus session, from 1 to 480 minutes. The default is 25.
  • Short break and Long break appear when the widget has a Mode switch. Each one takes 1 to 60 minutes. The defaults are 5 and 15.
  • Boss name and Boss health appear when the widget has a Boss. The name has up to 40 characters. The health goes from 10 to 10,000,000. The defaults are "Procrastination Dragon" and 100.

The Pomodoro tab of the Add element dialog has these Elements:

ElementPartsTemplates with it
TimerTime, Status, Dial, and ProgressAll
Timer progressNone. It sets a Start label and an End label.Minimalist, Boss
Mode switchNone. It sets the Focus name, Short break name, and Long break name.Minimalist
SessionsNone. It sets a Label and a Dot count.Gamified
Level & XPLevel, with its Icon. Title and XP.Gamified
BossSprite, Health, and PhaseBoss
StatsNone. It sets a Completed label and a Damage label.Boss
PlantNone. It sets the Size and the colors of the Petal, Leaf, Seed, and Soil.Nature

To see each template before you create a timer, open the timer widgets in the Widget catalogue.