← Back to Auto-Focus

Guide

Get started and find answers

Getting Started

1

Download & Install

Download Auto-Focus and the required "Toggle Do Not Disturb" shortcut. Install both to get started.

  • • Extract the downloaded ZIP file
  • • Drag Auto-Focus to Applications
  • • Install the shortcut from the package
Download Auto-Focus
2

Configure Focus Apps

Launch Auto-Focus and select which applications should trigger focus mode when you're working.

  • • Add your development tools (Xcode, VS Code, etc.)
  • • Configure browser focus URLs
  • • Set focus thresholds and buffer times
3

Install Browser Extension

Install the Chrome extension to track focus URLs like GitHub, Linear, Figma, and other work sites.

4

Start Focusing

Auto-Focus will now monitor your work and automatically manage Do Not Disturb mode.

  • • Focus for 12 minutes to trigger DND
  • • Track sessions in the insights view
  • • Access controls from the menu bar

Frequently Asked Questions

How does Auto-Focus detect when I'm focused?

Auto-Focus monitors your active application and tracks how long you stay focused on configured "focus apps." When you focus for your set threshold time (default 12 minutes), it automatically enables Do Not Disturb mode.

What happens when I switch away from a focus app?

When you switch to a non-focus app, Auto-Focus starts a buffer timer (default 3 minutes). If you don't return to a focus app within this time, it ends the focus session and re-enables notifications.

Does Auto-Focus work with web applications?

Yes! The included Chrome extension tracks focus on specific websites like GitHub, Linear, Figma, and other productivity tools. Configure focus URLs in the main app to include web-based work.

Do I need to add Chrome as a focus app to track websites?

No! The Chrome extension works independently and handles website-specific focus detection. You should not add Chrome as a focus app - doing so would make Auto-Focus activate focus mode whenever Chrome is open, regardless of which websites you're visiting. The extension only activates focus mode when you're on your configured focus websites.

What's the difference between Free and Auto-Focus+?

Auto-Focus Free limits you to 2 focus apps and basic insights. Auto-Focus+ removes all limits, adds advanced analytics, data export capabilities, and includes priority support and future updates.

Is my data private and secure?

Absolutely. Auto-Focus operates completely offline with no data collection, tracking, or cloud sync. All your focus data stays on your Mac, and you can export it anytime in CSV or JSON format.

What macOS versions are supported?

Auto-Focus requires macOS 12.0 (Monterey) or later. It's built with SwiftUI for optimal performance and native system integration, including proper Do Not Disturb control.

Why do I need to install a Shortcut?

macOS doesn't allow apps to directly control Do Not Disturb for security reasons. The "Toggle Do Not Disturb" shortcut acts as a bridge, allowing Auto-Focus to toggle DND through Apple's official Shortcuts system.

Still have questions?

We're happy to help. Reach out anytime.

Email [email protected]