TomatoTimer User Manual

Installation

Web app

Go to tomatotimer.sovkit.com
Start using it right away — no sign-up required
Choose Install app from your browser menu (Add to Home Screen on mobile) to open it as a standalone app

Browser extension

Visit the Chrome Web Store, Firefox Add-ons, or Edge Add-ons
Click Add to browser and confirm the permissions
Pin the extension icon to your toolbar for quick access

The extension and the web app offer the same features; differences are noted where they apply.

Running a pomodoro

The dial on the home page shows the status and the time left:

Click Start, and the ring fills clockwise in the theme colour; click again to Pause, then Resume to continue
Abandon is greyed out while the timer is idle; clicking it discards the current session

A reminder appears when the session ends. By default, there are no breaks and the next pomodoro never starts on its own.

Adjusting the length on the fly

The − and + buttons beside the dial take off or add 5 minutes at a time. They only affect the current run and leave Features untouched:

Before you start, they change the length of the next session
While a session is running or paused, they change that session; with pomodoros in a row on, the rest of the run keeps the new length too

The length stays within the range Features allows, and at least 1 minute of the current session must remain; at a limit, the matching button is greyed out.

Keyboard shortcut (browser extension)

Press the shortcut to start, pause, or resume without opening the side panel. The keys are shown on the Start/pause shortcut row under Features; click them to change them on your browser's shortcuts page. In Firefox, open about:addons, click the gear icon, and choose Manage Extension Shortcuts.

If the row shows "Not assigned", the keys clash with the browser or another extension; pick a different combination. The shortcut only works while a browser window is in the foreground.

Breaks and back-to-back rounds

Both are off by default; turn them on under Features:

Break length (1–30 minutes) — every pomodoro moves straight into a break, the ring turns green, and you are reminded again when it ends
Pomodoros in a row (2–12) — one click on Start runs that many pomodoros back to back, each starting on its own. The current count appears below the time; click it to jump to this setting. The timer stops after the last one and its break

Breaks can be paused, and Abandon becomes Skip break, which starts the next pomodoro straight away; skipping the break after the last pomodoro completes the run. Clicking Abandon during a pomodoro ends the whole run.

Break time never counts as focus time. Changes to either setting after you click Start apply the next time you start.

Focus statistics

Only completed sessions count, each for its full configured length; abandoned ones count for nothing. A session that crosses midnight counts towards the day it started. With syncing on, records from all your devices are combined.

Today

The top row of the home page shows today's pomodoros and focus time, with your streak of focus days on the right. Completing one pomodoro keeps the streak going for that day; until you do, the streak counts from yesterday, so it never breaks before the day is over.

Statistics card

Switch between 7d, 30d, and All (Pro) in the top-right corner:

Pomodoros and Focus time — totals for the range
Active days — days with a completed pomodoro
Daily avg. — averaged over every day in the range, including days without focus; All counts from your first record
Best streak — the longest run of consecutive focus days
Peak day — the weekday with the most focus time

The heatmap shows each day of the last six months, one week per column, deeper colours meaning more focus time. Point at or tap a cell to see that day's pomodoros and focus time at the bottom; otherwise that line shows a playful comparison, such as how many movies your focus time adds up to.

Daily focus goal (Pro)

Set Daily goal in Features to 1–20, and the right side of the Today row becomes a progress bar comparing today's count with your goal. It turns the theme colour once reached, and anything beyond is shown in full. Set it to 0 to show your streak again.

Exporting statistics (Pro)

Click the download button next to the statistics card's title to export your daily pomodoro counts and focus minutes, covering only days with a completed pomodoro. Choose the format under Features: CSV (default) or JSON (for scripts).

Reminders

A system notification arrives when a pomodoro or a break ends, replacing the previous one. Closing the panel does not stop the timer: the extension still reminds you on time, while the web app needs its tab to stay open.

Browser extension — clicking the notification opens the side panel; on Firefox, only the toolbar icon can open the sidebar
Web app — your browser asks for notification permission the first time you click Start. If permission is denied, the app tells you so; re-enable it in your browser's site settings

The sound is on by default and can be turned off under Features; on Firefox, the extension's sound follows your system notification settings.

Extension icon status

While the timer runs, the icon shows the whole minutes left (43 minutes 30 seconds shows as 43), "<1" below one minute, and "⏸" when paused; during a break, the background turns green.

Settings

Features

Pomodoro length — 45 minutes by default; any whole number from 10 to 120, with out-of-range values snapping to the nearest limit

Other settings are covered in the sections above.

Storage

Once your own storage is set up, feature settings, language and theme preferences, and focus statistics sync across the web app, the extension, and your computers. A running timer does not sync.

Under Settings → Storage, enter your S3-compatible bucket, endpoint, and access credentials step by step, then click Test & Save. Once the test passes, turn syncing on.

When you save, the browser asks whether the extension may reach that storage address; the connection works only after you allow it.

The web app takes one more step: apply the CORS rule on your storage provider. The rule can be copied right from that step.

Your storage credentials never leave this device. Without a storage configured, everything stays on this device and no feature is affected.

FAQ

The session ended but no notification appeared

In the web app, check that you allowed notifications for the site
Check that a system focus or do-not-disturb mode is not suppressing them

My statistics do not match on another device

Check that syncing is on for both devices and that both point at the same bucket
Data is pulled on a fixed schedule, so new records may take a moment to appear