https://github.com/sukitsubaki/screen-time-tracker
A minimalist Python tracker that records the usage time of various applications and provides insights into your computer usage habits.
https://github.com/sukitsubaki/screen-time-tracker
application-usage data-analysis monitoring productivity python python-cli screen-time time-tracking
Last synced: 11 months ago
JSON representation
A minimalist Python tracker that records the usage time of various applications and provides insights into your computer usage habits.
- Host: GitHub
- URL: https://github.com/sukitsubaki/screen-time-tracker
- Owner: sukitsubaki
- License: mit
- Created: 2025-03-22T00:52:37.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-22T00:53:16.000Z (about 1 year ago)
- Last Synced: 2025-04-11T06:24:08.095Z (12 months ago)
- Topics: application-usage, data-analysis, monitoring, productivity, python, python-cli, screen-time, time-tracking
- Language: Python
- Homepage:
- Size: 13.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-time-tracking - screen-time-tracker - A minimalist Python tracker that records application usage time and provides insights into computer usage habits. ([Read more](/details/screen-time-tracker.md)) `open-source` `python` `usage-monitoring` `analytics` (Automated Time Tracking)
README
# Screen Time Tracker
A minimalist Python tracker to record the time spent using different applications on your computer.
## Features
- Monitors active applications and records usage time
- Creates daily, weekly, and monthly reports
- Simple command-line interface for easy operation
- Lightweight with minimal dependencies
## Installation
```bash
# Clone repository
git clone https://github.com/sukitsubaki/screen-time-tracker.git
cd screen-time-tracker
# Install core dependencies
pip install -r requirements.txt
# Install OS-specific dependencies
# For macOS:
pip install pyobjc
# For Windows:
pip install pywin32
# For Linux:
pip install python-xlib
```
## Usage
```bash
# Start tracking
python run-tracker.py start
# Generate report
python run-tracker.py report --period daily
# Alternatively, make the script executable first
chmod +x run-tracker.py
# Then run directly
./run-tracker.py start
```
For advanced usage options, check out the [documentation](docs/DOCUMENTATION.md).
## Requirements
- Python 3.8+
- Operating Systems: Windows, macOS, Linux
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.