Documentation

Learn everything you'll ever need to get the most out of Chronode

Data Storage

Chronode is built with a privacy-first approach: your time tracking data never leaves your Mac. No cloud accounts, no servers, no data collection.

How Your Data is Stored

100% Local Storage

  • Stored using Apple's Core Data framework
    Industry-standard database system that's reliable, efficient, and built into macOS
  • Saved in local SQLite database files
    Standard database format that's portable and can be backed up with your regular Mac backups
  • Located in your Mac's application support directory
    Stored in the standard macOS location for app data, protected by your user account permissions
  • Never transmitted to external servers
    Your time tracking data has no network uploads, no cloud storage, no external access of any kind
  • No internet connection required for free version
    Basic version works completely offline. Pro requires internet for license verification at app launch.

Storage location:

~/Library/Application Support/Chronode/

What Gets Stored

Session data

  • Start and end timestamps
    Exact date and time when you launched and quit each app
  • App name and bundle identifier
    Which application was running (e.g., "Xcode" with ID "com.apple.dt.Xcode")
  • Project name (for supported apps)
    The specific project you were working on, automatically detected from window titles
  • Duration calculations
    Total time spent in each session, computed from start/end times
  • Session status
    Whether the session ended normally, was force quit, or the app crashed

Daily summaries

  • Aggregated time by day, app, and project
    Sessions rolled up into daily totals for efficient storage and fast analytics
  • Session counts
    Number of times you launched each app per day
  • Historical records for analytics
    Long-term data that powers charts, trends, and statistics

User preferences

  • App monitoring settings
    Which apps you're tracking and whether monitoring is paused
  • Focus mode preferences
    Whether to track only active window time or all running time
  • Export format preferences
    Your preferred export format (CSV/PDF/JSON) and page size settings
  • Other configuration options
    Auto-start at login, minimum session duration, and similar settings

What is NOT stored

  • Screenshots or screen recordings
    Chronode never captures your screen in any way
  • Keyboard activity or typed content
    No keylogging, no recording of what you type
  • Visited websites or URLs
    Browser activity is not tracked or recorded
  • File contents or code
    Only file names for project detection, never the actual content
  • Personal identifiable information
    Beyond app usage, no personal data is collected or stored

Data Privacy Guarantees

No Cloud Sync

Chronode does not:

  • Upload data to cloud servers
    All data remains on your local Mac with no cloud storage or backup services
  • Sync across devices
    Each Mac has its own independent tracking data with no synchronization
  • Require online accounts
    No sign-up, no login, no account creation necessary to use Chronode
  • Transmit data over the internet
    Zero network activity related to your time tracking data

Limited Data Collection

Chronode collects minimal data to improve the app:

  • Crash reports (automatic)
    Technical diagnostics with sanitized file paths to help fix bugs. Cannot be disabled but contains no personal information, project names, or file contents.
  • Anonymous usage analytics (optional)
    Disabled by default. When enabled, tracks feature usage events to help improve the app. Can be toggled in Settings at any time.
  • License verification (Pro users)
    Email, license key, and hardware UUID transmitted at each app launch and during update checks to validate your Pro license.

What is NOT collected:

  • Your time tracking data
    All session data, project names, and work patterns remain 100% local
  • Keyboard activity or typed content
    No keylogging or recording of what you type
  • User behavior beyond crash/telemetry events
    No monitoring of your interaction patterns or workflow
  • Device information (except hardware UUID for Pro)
    No collection of your Mac's specs, serial numbers, or other identifiers
  • Location data
    No GPS, IP address, or location tracking of any kind

No Third-Party Access

  • No advertising networks
    Chronode is ad-free with no advertising SDKs or tracking pixels
  • No data brokers
    Your data is never sold, shared, or provided to third parties
  • No third-party SDKs with tracking
    Only uses Apple's native frameworks with no external dependencies
  • No social media integrations
    No connections to Facebook, Twitter, or other social platforms

macOS Permissions

Chronode requests only the permissions necessary to function:

Accessibility API

Purpose: Monitor which applications are running and detect active windows.

What Chronode can access:

  • Running application list
    See which apps are currently open on your Mac to track the ones you've chosen to monitor
  • Active window titles
    Read window titles to detect project names in supported apps (e.g., "MyProject.xcodeproj - Xcode")
  • App launch/quit events
    Receive notifications when monitored apps start and stop to begin and end tracking sessions

What Chronode cannot access:

  • Keyboard input or typed text
    No keylogging or recording of anything you type
  • Mouse movements or clicks
    No tracking of cursor position or what you click
  • Content of windows or screens
    Cannot read or capture what's displayed in app windows
  • Files or documents you're working on
    Only sees file names in window titles, never the actual content

To review or revoke:

System Settings  Privacy & Security  Accessibility  Chronode

File System Access

Purpose: Read project configuration files for automatic project detection in supported apps.

What Chronode can access:

  • Xcode project files
    .xcodeproj and .xcworkspace files to determine project names
  • IDE configuration directories
    .idea (JetBrains), .vscode (VS Code) folders for project detection
  • Only when detecting projects in supported apps
    File access is limited to specific project-related files, not general file browsing

What Chronode cannot access:

  • Your source code files
    Never reads .swift, .js, .py, or any source code files
  • Personal documents
    Cannot access your Documents, Downloads, or other personal folders
  • System files
    No access to macOS system directories or configuration
  • Other applications' data
    Cannot read data from other apps you have installed

To review or revoke:

System Settings  Privacy & Security  Files and Folders  Chronode

Background Processing

Purpose: Continue tracking when app is not in foreground.

What this enables:

  • Monitor apps while Chronode window is closed
    Tracking continues even when you've closed the Chronode interface
  • Track time without disrupting your workflow
    No need to keep Chronode visible or active while working
  • Update statistics in real-time
    Charts and time totals refresh automatically in the background

Resource usage:

  • Less than 1% CPU
    Minimal processor usage that won't slow down your Mac
  • Under 50MB RAM
    Small memory footprint that leaves resources for your work apps
  • Minimal battery impact
    Efficient background monitoring with negligible effect on battery life

Data Ownership & Control

You Own Your Data

  • All tracked time belongs to you
    You have full ownership rights to all time tracking data Chronode creates
  • No licensing restrictions on your data
    Use, share, or analyze your data however you want with no limitations
  • Export anytime in multiple formats
    Download your data in CSV, PDF, or JSON format whenever needed
  • Delete anytime with no recovery
    Permanently remove data at any time; it's gone forever with no cloud backup to restore from

Privacy Options in Exports

Chronode includes privacy controls when exporting data, allowing you to anonymize project names and round timestamps for confidentiality. For complete details on export privacy options and how to use them, see the Privacy Options section in Data Exporting .

Delete Your Data

In order to completely clear you system from Chronode data, you have two deletion options:

Remove specific apps/projects

  • Click the options menu (or right-click) of an app or project in the sidebar
  • Select Reset Data or Delete depending on what it is you wish to do
  • Associated time data deleted immediately for applications. Associated time is still linked to the an application when a project is deleted.
  • Once an application is deleted, data recovery is not possible. Deletion is permanent with no undo or restore option

Complete data reset

  • Fully close the application first and quit the app (right click on the app icon in your navbar)
  • Navigate to ~/Library/Application Support/CodelDev.Chronode/ or open this folder in Finder (use Go → Go to Folder)
  • Delete the folder entirely to erase all data and settings
  • Relaunch Chronode for fresh start which creates a new, empty database

Warning: Deletion is permanent. Export data before deleting if you want to keep records.


Security Considerations

Data at Rest

Local database protection

  • Stored in user-protected directory
  • Access controlled by macOS file permissions
  • Protected by FileVault (if enabled on your Mac)
  • No additional encryption layer (relies on system-level security)

Best practices

  • Enable FileVault for full-disk encryption
  • Use strong Mac user account password
  • Keep macOS updated for security patches

System Permissions

Chronode operates with necessary system access to track your projects:

  • Monitors active applications to detect which project you're working on
  • Tracks application focus and usage time
  • Not sandboxed, allowing full time-tracking functionality
  • All monitoring is local to your machine. Mo data is transmitted without your consent

No Network Access Required

Chronode works completely offline:

  • No internet connection needed
  • No data transmission occurs
  • No risk of data interception
  • No server vulnerabilities

Compliance & Standards

GDPR Compliance

  • No personal data processed by third parties
  • Complete data portability via exports
  • Right to deletion fully supported
  • No data transfers outside your Mac

Data Minimization

Chronode follows data minimization principles:

  • Collects only essential tracking information
  • No unnecessary metadata
  • No identifiable personal information beyond app usage
  • Minimal permission requests

Transparency

Open About Data Practices

Chronode is transparent about:

  • What data is collected (app usage times)
  • Where data is stored (locally on your Mac)
  • Who has access (only you)
  • How to export and delete data (documented)

No Hidden Tracking

What Chronode does NOT do:

  • Hidden background uploads
  • Silent data collection
  • Undisclosed third-party sharing
  • Tracking beyond stated functionality
Chronode app data export screen

Your Time Has Value.
Start Protecting It

Focus on your work while Chronode handles the timekeeping. Start tracking time in under a minute

No Subscription
Privacy-first
Analytics
Exporting
MacOS 14.6+
Chronode App Overview screen

Common Questions

We've got you covered. Quick answers to help you get started.

What is Chronode?

Chronode is a macOS menu bar application that automatically tracks time spent in your applications and projects (where supported). It monitors which apps you use and for how long, building an accurate picture of your computer usage without any manual input.

What are the system requirements?

Chronode requires macOS 14.6+ (Sonoma) or later and supports both Apple Silicon and Intel Macs. The app uses less than 50MB of disk space and runs at an average of 1% CPU usage with less than 50MB of memory during normal operation. No internet connection is required.

How much does Chronode cost?

Chronode basic is free. Chronode Pro is a one-time purchase with lifetime updates included. No subscriptions, no recurring fees. This makes Chronode more cost effective than subscription based time trackers.

Where is my data stored?

All data is stored locally on your Mac using Apple's native database framework. Nothing is sent to the cloud, synced to external servers, or shared with third parties. No account is required. Your time tracking data exists only on your computer, under your complete control.

Does Chronode collect any data about me?

No. Chronode has zero telemetry, no analytics, and no tracking of any kind. Your usage data never leaves your Mac. There are no background network connections, no automated crash reporting services, and no usage statistics sent to developers. What happens on your Mac stays on your Mac.

Which applications can Chronode track?

Chronode can monitor any macOS application you choose. Intelligent project detection is available for the supported applications displayed when adding an app. We intend to add additional project/file detection support for commonly used apps in the near future.

Does Chronode work automatically?

Yes. Once you've added apps to monitor, Chronode tracks time automatically from the moment you launch an application until you quit it. There are no timers to remember to start, no buttons to click when switching tasks, and no logs to fill out at the end of the day.

Simply use your computer as you normally would, and Chronode quietly records everything in the background. The app handles all the tracking mechanics so you can focus entirely on your work without interruptions.

What reporting does Chronode provide?

Out of the box, Chronode provides comprehensive visual analytics to help you understand your time usage patterns. See which days you're most productive, identify your peak working hours, and visualize how time is distributed across different projects and applications.

Track your work consistency over time with intuitive graphs and visualizations that update in real-time as you work. Whether you're analyzing session lengths, spotting weekly trends, or reviewing your activity patterns, Chronode gives you the insights you need to optimize your workflow without complex settings.

Have a question not answered here? Try our other help sections below.