Documentation

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

Introduction

Chronode is a macOS menu bar application that automatically tracks time spent in your applications. It runs silently in the background, detecting which apps you use and how long you work without requiring any manual start/stop actions.


Why use Chronode?

  • Completely Automatic
    Launch your apps and start working. Chronode handles all time tracking in the background without interrupting your workflow.
  • Project Detection
    For supported apps, Chronode automatically detects which project you're working on and tracks time accordingly.
  • Privacy First
    All data stays on your Mac. No cloud accounts, no servers, no tracking. Your time data never leaves your computer.
  • Beautiful Analytics
    Over six reporting charts help you understand your work patterns: daily activity, hourly productivity, project distribution, trends, calendar heatmap, and session analysis.
  • Flexible Exports
    Export your data in CSV, PDF, or JSON formats for invoicing, reporting, or custom analysis.

How Chronode Works

Getting started with Chronode is simple:

  1. Add apps to monitor
    Choose which applications you want to track from your Applications folder
  2. Work normally
    Launch your apps and focus on your work; Chronode tracks time automatically
  3. View your statistics
    Click the menu bar icon anytime to see time summaries, charts, and detailed session logs
  4. Export when needed
    Generate reports in your preferred format for billing, productivity analysis, or record keeping

No timers to remember, no buttons to click, no manual logging required.


Who Uses Chronode

Freelancers & Consultants
Track billable hours automatically with accurate time logs for client invoicing.

Remote Workers
Monitor productivity patterns and demonstrate work hours with detailed reports.

Development Teams
Understand time allocation across projects without manual time entry.

Students & Learners
Track study time and coding practice to build consistent habits.

Anyone Tracking App Usage
Monitor how you spend time on your Mac with automatic, effortless tracking.


Key Features at a Glance

Automatic App Monitoring
Chronode detects when you launch and quit monitored apps, creating accurate session records without manual intervention.

Intelligent Project Detection
Supports 11 development environments including Xcode, VS Code, PhpStorm, IntelliJ IDEA, PyCharm, WebStorm, Android Studio, and Sublime Text. Projects are detected automatically from window titles and configuration files.

Focus Mode
Choose to track only active window time (Focus Mode on) or total app runtime (Focus Mode off). Perfect for accurate billable hours.

Session Management
Chronode handles edge cases gracefully: force quits, crashes, and system sleep are all detected and handled properly so no time data is lost.

Real-Time Updates
Watch your time accumulate as you work with live updates in the sidebar and charts. All analytics include currently active sessions.

Comprehensive Analytics
Six chart types provide insights into your work patterns: Activity (by weekday), Hourly Productivity, Project Distribution, Trends, Calendar Heatmap, and Focus Sessions.

Professional Exports
Generate reports in CSV (for spreadsheets), PDF (for clients), or JSON (for integrations) with privacy options to anonymize projects and round timestamps.

Complete Privacy
100% local storage using Core Data. No cloud sync, no accounts required. Automatic crash reports help improve stability, with optional anonymous telemetry (disabled by default). Your time tracking data belongs to you alone.


System Requirements

  • macOS 14.6+ (Sonoma) or later
  • Requires under 50MB of disk space.
  • Uses less than nder 50MB RAM usage
  • Uses less than 1% CPU usage during normal operation
  • Optimized for Apple Silicon, fully compatible with Intel Macs

Quick Start

Ready to begin? Setup takes less than 5 minutes:

  1. Download and Install Chronode
  2. Grant Accessibility permissions when prompted
  3. Add your first app to monitor
  4. Start working and tracking begins automatically

For detailed setup instructions, see the Getting Started Guide.


Why Choose Chronode?

Privacy You Can Trust
Your time tracking data never leaves your Mac. No cloud servers, no accounts required. Only essential crash reports and optional telemetry (disabled by default) are transmitted. Pro users need internet for license verification at launch.

Lightweight & Efficient
Uses less than 1% CPU and under 50MB RAM. You'll forget it's running.

One-Time Purchase
Basic is always Free. Pro has no monthly subscriptions. Pay once, use forever with lifetime updates included.

Built for Automatic Tracking
Unlike manual time trackers that require constant attention, Chronode works invisibly in the background.


Explore the Documentation

New to Chronode?

Ready to dive deeper?

Need help?

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.