Lifelogger

Personal activity tracking daemon with LLM summarization.

Features

• Keyboard and mouse event capture
• Automatic screenshots (on click and/or cron schedule)
• LLM-powered activity summarization
• Cross-platform (macOS, Windows, Linux)
• Background daemon with CLI control

Installation

pip install lifelogger-daemon

Quick Start

# Initialize configuration
lifelogger init

# (Optional) Set your OpenAI API key for summarization
lifelogger config-set --openai-key YOUR_API_KEY

# Start the daemon
lifelogger start

# Check status
lifelogger status

# View activity summary
lifelogger summary

# Stop the daemon
lifelogger stop

Usage

Commands

Configuration

Configuration is stored in ~/.lifelogger/config.json. You can modify it via CLI:

# Enable/disable capture types
lifelogger config-set --keypress/--no-keypress
lifelogger config-set --mouseclick/--no-mouseclick
lifelogger config-set --screenshot-on-click/--no-screenshot-on-click

# Configure cron screenshots
lifelogger config-set --cron-screenshot/--no-cron-screenshot
lifelogger config-set --cron-schedule "*/5 * * * *"

# Configure summarization
lifelogger config-set --summarizer/--no-summarizer
lifelogger config-set --model gpt-4o-mini
lifelogger config-set --openai-key YOUR_KEY

Environment variables are also supported:

• LIFELOGGER_OPENAI_API_KEY
• LIFELOGGER_CAPTURE_ENABLE_KEYPRESS
• LIFELOGGER_CAPTURE_ENABLE_MOUSECLICK
• etc.

Platform Notes

macOS

Requires accessibility permissions for keyboard/mouse capture. Grant permissions in System Preferences > Privacy & Security > Accessibility.

Linux

May require running as root or adding user to the input group for keyboard/mouse capture.

Windows

Should work out of the box. Some antivirus software may flag keyboard monitoring.

Development

# Clone the repo
git clone https://github.com/JacobFV/lifelogger.git
cd lifelogger

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Type checking
mypy lifelogger

# Linting
ruff check lifelogger

License

MIT