Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/JerryZLiu/Dayflow/llms.txt

Use this file to discover all available pages before exploring further.

​
System Requirements

  • macOS 13.0+ (Ventura or later)
  • ~100MB RAM during operation
  • 25MB disk space for the app
  • 1GB-20GB for recordings (configurable storage limits)
Building from source requires Xcode 15+

​
Installation Methods

The easiest way to install Dayflow is to download the pre-built DMG:
1

Download the DMG

Download Dayflow.dmg from the latest release.
2

Install the App

  1. Open the downloaded Dayflow.dmg file
  2. Drag Dayflow into your Applications folder
  3. Eject the DMG
3

Launch Dayflow

Open Dayflow from your Applications folder. You’ll be prompted to grant permissions in the next step.

​
From Homebrew

If you use Homebrew, you can install Dayflow with a single command: 
brew install --cask dayflow
This will download and install Dayflow automatically. Launch it from your Applications folder or Spotlight.

​
Building from Source

Developers can build Dayflow from source for maximum transparency and customization:
1

Clone the Repository

git clone https://github.com/JerryZLiu/Dayflow.git
cd Dayflow
2

Open in Xcode

open Dayflow.xcodeproj
Requires Xcode 15+. Download from the Mac App Store if you don’t have it installed.
3

Configure Signing (if needed)

  1. Select the Dayflow target in Xcode
  2. Go to Signing & Capabilities
  3. Select your development team or use automatic signing
4

Add Environment Variables (Optional)

If you plan to use Gemini from your development build:
  1. Select Product → Scheme → Edit Scheme
  2. Go to Run → Arguments
  3. Under Environment Variables, add:
5

Build and Run

  1. Select the Dayflow scheme
  2. Choose your Mac as the target device
  3. Click Run (⌘R) or Product → Run

​
Granting Permissions

Dayflow requires Screen & System Audio Recording permissions to capture your activity.
Without these permissions, Dayflow cannot record your screen or generate timelines.

​
Automatic Permission Request

When you first launch Dayflow, macOS will prompt you to grant Screen Recording permissions. Click Open System Settings and enable Dayflow.

​
Manual Permission Setup

If you need to grant permissions manually or if something went wrong:
1

Open System Settings

Click the Apple menu → System Settings
2

Navigate to Privacy & Security

In the sidebar, select Privacy & Security
3

Select Screen & System Audio Recording

Scroll down and click Screen & System Audio Recording
4

Enable Dayflow

  1. Find Dayflow in the list
  2. Toggle the switch to enable it
  3. You may need to authenticate with Touch ID or your password
5

Restart Dayflow

Quit and relaunch Dayflow for the permissions to take effect.
For more information about Screen Recording permissions, see Apple’s documentation.

​
Data Storage Location

All Dayflow data is stored locally on your Mac: 
~/Library/Application Support/Dayflow/
├── recordings/          # Video chunks of your screen capture
└── chunks.sqlite        # Local database with timeline metadata

​
Accessing Recordings

You can open your recordings folder at any time:
  1. Click the Dayflow icon in your menu bar
  2. Select Open Recordings…
Or navigate to it manually in Finder: 
open ~/Library/Application\ Support/Dayflow/recordings/

​
Storage Management

Dayflow includes automatic storage cleanup with configurable limits:
  • Set limits from 1GB to 20GB or choose unlimited
  • Older recordings are automatically purged when the limit is reached
  • Configure in Dayflow Settings → Storage

​
Complete Reset

To completely remove all Dayflow data and start fresh:
This will permanently delete all your recordings and timeline data. This action cannot be undone.
# Quit Dayflow first
rm -rf ~/Library/Application\ Support/Dayflow/
# Relaunch Dayflow to start fresh

​
Next Steps

Now that Dayflow is installed: