WhatDid - Personal Activity Tracker for macOS

WhatDid is a personal activity tracking application designed for macOS that captures application usage and web activities. It provides insightful summaries and reports to help you understand how you spend your time on your computer.

Features

Real-time Activity Tracking: Monitors and records active applications and visited URLs.
Activity Summarization: Offers detailed summaries for specified time periods (hours or minutes).
Timezone Conversion: Converts UTC timestamps to your local timezone for more relevant insights.
Database Management: SQLite database handles all activity records effortlessly.

Prerequisites

macOS
Python 3.12 or later
Homebrew (for installing any additional dependencies)

Installation

Clone the Repository:

git clone https://github.com/pradyuprasad/whatdid.git
cd whatdid

Install Poetry (if you haven't already):
```
brew install poetry
```
Install Dependencies and set up the shell:
```
poetry install
poetry shell
```
Set Up the Database:
```
python db_setup.py
```
Run the Tracker:
```
python main.py start
```

Usage

Create DBs

First run db_setup.py

Start Tracking

To start tracking your application and web usage, run the main.py script. This script will continuously log your active applications and URLs into the database.

Generate Activity Summary

To generate a summary of your activity over the past specified time period, use the activity_viz.py script. You can summarize by hours or minutes:

python activity_viz.py summary --hours 1  # for the last hour
python activity_viz.py summary --minutes 30  # for the last 30 minutes

Convert Timestamps

If you need to convert UTC timestamps in the database to your local timezone, run:

python conversion_script.py

File Descriptions

main.py: The main tracking script that logs application and URL usage.
activity_viz.py: Provides activity summaries for specified time periods.
conversion_script.py: Converts timestamps in the database to the local timezone.
db_setup.py: Creates the SQLite database and activities table.
tracker.db: SQLite database that stores all activity logs.
output.txt: Default output file for various scripts.
poetry.lock & pyproject.toml: Manage project dependencies and configurations.

Example Commands

To get an activity summary for the last 2 hours:

python activity_viz.py summary --hours 2

To convert all timestamps in tracker.db to the local timezone:

python conversion_script.py

Author

Pradyumna

pradyuprasad/LockedIn