Documentation

Find out about Flow’s features, controls, keyboard shortcuts, and API. If you still need help, don’t hesitate to ask us.

Learn more

Need Help?

Controls UI Shortcuts Calendar Sync Commitment Mode Web Blocker API Scripts

Controls and UI Elements

Flow offers some neat controls to handle your pomodoro experience. Since most of the UI elements are kept as minimalistic as possible, their exact functionality may not always be that obvious.

Menubar Timer left-click to show/hide the Flow window, right-click to toggle the timer

Reset pomodoro counter to easily start over (does not affect the statistics)

Main menu leading to settings, durations, statistics and our App Blocker

Pomodoro counter showing the remaining sessions before a long break (filled = completed session, half-filled = session in progress)

Skip a break

Keyboard Shortcuts

Flow comes with a very useful global and non-global keyboard shortcuts.

ctrl ⌥ ⌘ + f

Start / Stop the Flow timer

ctrl ⌥ ⌘ + s

Skip current session

ctrl ⌥ ⌘ + r

Reset pomodoro counter

ctrl ⌥ ⌘ + h

Show / Hide app window

⎵

Start / Stop the Flow timer (non-global)

esc

Hide app window / Close fullscreen break (non-global)

Calendar Sync

In Flow Pro, you can synchronize your completed sessions to your calendar.

If the setting is enabled, your completed focus session will be visible as calendar entries in your Apple Calendar. Flow currently only supports syncing to Apple Calendar. We plan to support other calendar services in the future, such as Google Calendar.

Flow automatically selects your Default Calendar to sync to. We plan on implementing the option to select a calendar in the future. Learn more about our future plans on our roadmap.

If you don’t see any entries in your calendar after activating the calendar synchronization, try restarting Flow and then start a new session. If that doesn’t help, or if you have any other issues, please contact us.

Commitment Mode

Commitment mode is a Pro feature located in the Flow settings. With commitment mode enabled, you can’t pause the timer. You need to disable the commitment mode first. It’s used for self-control, if you tend to pause the timer too often and lose focus as a result.

Web Blocking

Flow Pro on Mac offers a web blocker that allows you to block distracting websites during a Flow session so you can concentrate better.

Please note that the URLs in the list are only blocked during a flow session, not during a break or when the timer is paused. You can add up to 25 websites to the list and choose between different browsers. Supported browsers are Safari, Chrome, Edge, Opera, Brave, Vivaldi.

You can also change the list to an allow-list, i.e. all URLs other than those in the list will be blocked. You can also use simple keywords, e.g. ‘facebook’, to block all URLs that contain the word ‘facebook’, i.e. you do not need ‘www’ or ‘http’. However, if you want to block exactly one specific domain without blocking other parts of the website or certain subdomains, you can use the prefix ‘*’. Example: If you add *https://www.facebook.com to the list, this exact URL will be blocked, but https://business.facebook.com will be allowed.

API / Scripts