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.

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