RuiFlow

A native macOS focus, time-tracking, and notch workspace.
Find your rhythm. Track your time.

RuiFlow turns the MacBook notch into a compact command surface for focused work. It combines Pomodoro sessions, flexible countdowns, project time tracking, media controls, system insight, and quick utilities in one native SwiftUI app.

Highlights

• Pomodoro focus cycles with configurable focus, short-break, and long-break stages.
• Countdown timers with pause, recovery, and overtime support.
• Independent project stopwatches with categories and editable time intervals.
• Optional one-way synchronization of project records to macOS Calendar.
• Timer state across the notch, popover, floating controls, and Lock Screen widgets.
• Media controls for Apple Music, Spotify, Cider, and other supported players.
• CPU, GPU, memory, network, disk, weather, clipboard, Shelf, and quick utilities.
• Native SwiftUI presentation with responsive notch and Dynamic Island layouts.

Requirements

• macOS 14.6 or later; macOS 15 or later is recommended.
• A MacBook with a notch for the primary experience.
• Xcode 15 or later when building from source.
• Permissions vary by feature and can include Accessibility, Camera, Calendar, Screen Recording, Music, and Automation.

Build from Source

git clone https://github.com/PPSherry/RuiFlow.git
cd RuiFlow
xcodebuild -project DynamicIsland.xcodeproj \
  -scheme DynamicIsland \
  -configuration Debug \
  -derivedDataPath /tmp/RuiFlowDerivedData \
  CODE_SIGNING_ALLOWED=NO build
open /tmp/RuiFlowDerivedData/Build/Products/Debug/RuiFlow.app

Data

RuiFlow stores its default project timing data at:

~/Library/Application Support/RuiFlow/TimerTracking/time-tracking.json

On first launch, RuiFlow copies compatible settings and local data from an existing Atoll installation when the corresponding RuiFlow data does not already exist. The original Atoll data is left in place so both apps can coexist.

The migration has two parts:

• UserDefaults values are copied key by key from the legacy domains com.Ebullioscopic.Atoll and com.Ebullioscopic.Atoll.dev into RuiFlow's current bundle domain. Existing RuiFlow values take precedence, and the legacy preference files are not deleted.
• The following directories are copied on demand from ~/Library/Application Support/DynamicIsland/ to ~/Library/Application Support/RuiFlow/: TimerTracking, Shelf, AppIcons, and IdleAnimations. Copying occurs only when the RuiFlow destination does not already exist. If a user selected a custom time-tracking file, its security-scoped bookmark remains the source of truth and that custom file is not relocated automatically.

This migration does not transfer macOS privacy grants, login-item registration, Sparkle update state, or arbitrary files outside the listed locations. RuiFlow may therefore request permissions again after the bundle identifier changes.

License and Attribution

RuiFlow is free software distributed under the GNU General Public License, version 3 or, where stated by the source headers, any later version. See LICENSE for the complete terms.

RuiFlow is a modified version of Atoll:

• Original work copyright © 2024–2026 Atoll Contributors.
• RuiFlow modifications copyright © 2026 Rui XU.
• RuiFlow was renamed and materially modified in 2026 with Pomodoro workflows, project time tracking, Calendar synchronization, data recovery, and related interface changes.

The original copyright and license notices remain in the source files. See NOTICE.md for the modification notice and upstream attribution.

Acknowledgments

RuiFlow retains Atoll's acknowledgments because much of the inherited implementation builds on or was inspired by these projects:

• Atoll — the upstream project from which RuiFlow is derived.
• Boring.Notch — foundational media, AirDrop, Shelf, and notch interaction work inherited through Atoll.
• Alcove — inspiration for minimalistic and Lock Screen layouts.
• Stats — system metrics collection architecture.
• Open-Meteo — weather data.
• SkyLightWindow — Lock Screen window rendering.
• rtaudio — real-time music visualizer work adapted by Atoll.
• SwiftTerm — terminal integration.
• DynamicNotch — battery HUD assets used by Atoll with permission.
• Wick / Nate — permission granted to Atoll to reproduce the iOS-style Lock Screen timer design.
• OpenUsage — LLM usage tracking inspiration.
• OpenRouter — model pricing data API.

RuiFlow is an independent modified version and is not an official Atoll release.