Select Page

Documen­tation

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

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

Flow comes with a simple API which makes it easy to control the app via AppleScripts or certain programs like Alfred. We’ve prepared a simple Alfred workflow which can be downloaded for free.

Action

Script

Launch

tell application "Flow" to launch

Quit

tell application "Flow" to quit

Start / Resume

tell application "Flow" to start

Stop / Pause

tell application "Flow" to stop

Skip

tell application "Flow" to skip

Reset

tell application "Flow" to reset

Hide

tell application "Flow" to hide

Show

tell application "Flow" to show

Get remaining time

tell application "Flow" to getTime

Get current phase

tell application "Flow" to getPhase

Pin It on Pinterest