A comprehensive activity monitoring and analytics tool with real-time TUI, session tracking, and productivity insights. Built with modern Python for macOS and Linux.
- Real-time TUI Dashboard - Beautiful terminal UI with sparklines, metrics, and live updates
- Session Tracking - Track activity across multiple sessions with start/end times
- Idle Detection - Distinguish between active work and idle time (3-minute threshold)
- Historical Comparison - Compare today's activity vs yesterday with visual indicators
- Focus Time Tracking - See actual time spent in each application
- Privacy-First - Optional encryption, local storage, configurable exclusions
- Rich Visualizations - Enhanced statistics with charts, graphs, and insights
- macOS Native - Full window tracking with PyObjC integration
- Linux Support - Cross-platform with fallback tracking
# From PyPI (when published)
pip install selfspy
# On macOS (recommended for full features)
pip install selfspy[macos]
# With pipx (isolated environment)
pipx install selfspy[macos]
# With uv (fastest)
uv tool install selfspy --with selfspy[macos]# Start monitoring with live TUI
selfspy daemon
# View enhanced statistics
selfspy stats summary --days 7
# View visualizations
selfspy viz enhanced
# Check terminal activity
selfspy terminal statsSee INSTALL.md for detailed installation instructions.
Comprehensive documentation is available in the docs/ directory:
- Installation Guide - Setup and dependencies
- Usage Guide - Commands and workflows
- Configuration - Settings and customization
- Architecture - System design and internals
- Troubleshooting - Common issues and solutions
- Python 3.10+
- macOS 10.12+ (for full features)
- Accessibility permissions (macOS)
For detailed installation instructions, see the Installation Guide.
This project is inspired by and based on the original Selfspy by Bjarte Johansen and David Fendrich. The original Selfspy pioneered the concept of comprehensive activity monitoring with privacy-first local storage and encryption.
This modern Python implementation builds upon that foundation with:
- Modern async/await patterns with SQLAlchemy 2.0
- Real-time TUI dashboard with Rich
- Session tracking and historical analytics
- Enhanced security and stability
- macOS native integration with PyObjC
- Comprehensive testing and documentation
We're grateful to the original authors for creating such an innovative tool and releasing it as open source.
GPL-3.0-or-later
This project maintains compatibility with the original Selfspy's GPL-3.0 license.