Documentation
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
Quit
Start / Resume
Stop / Pause
Skip
Reset
Hide
Show
Get remaining time
Get current phase
Made with ♥ in Germany
© 2018-2022 Yugen GmbH | Mail: support@flowapp.info