Activity Tracker

A beautiful, privacy-focused browser extension that tracks your browsing activity and time spent on websites. Features a minimalistic dark theme UI, comprehensive analytics, and optional daily email summaries.

✨ Features

Time Tracking

• Automatic tracking of time spent on every website
• Real-time badge showing current domain time on the extension icon
• Idle detection - pauses tracking when you're away (60 seconds)
• 1 year of history - data is automatically retained for up to one year

Comprehensive Analytics

• Domain grouping - aggregate time by website
• Page-level details - see individual pages within each domain
• Multiple time ranges - Today, Week, Month, Year
• Calendar view - browse activity for any specific day
• Search - quickly find domains or pages

Daily Email Summaries (Optional)

• Receive a beautifully formatted daily summary at 11 PM
• Top websites with time spent
• Total browsing statistics
• Powered by Resend (free tier available)

Privacy First

• 100% local storage - all data stays on your device
• No external tracking - we don't collect any data
• Open source - audit the code yourself
• Export your data - download as JSON anytime

Screenshots

Main Interface

Calendar View

Email Summary

🚀 Installation

Manual Installation (Developer Mode)

1. Download the extension

   git clone https://github.com/Aryan3902/activity-tracker.git

   Or download and extract the ZIP file.

2. Open Chrome Extensions

   • Navigate to chrome://extensions
   • Enable Developer mode (toggle in top-right corner)

3. Load the extension

   • Click Load unpacked
   • Select the activity-tracker folder

4. Done!

   • The extension icon will appear in your toolbar
   • Click it to view your activity

Firefox

1. Navigate to about:debugging#/runtime/this-firefox
2. Click Load Temporary Add-on
3. Select manifest.json from the extension folder

Microsoft Edge

1. Navigate to edge://extensions
2. Enable Developer mode
3. Click Load unpacked
4. Select the extension folder

⚙️ Configuration

Email Summaries (Optional)

To receive daily email summaries:

1. Get a Resend API Key

   • Sign up at resend.com (free)
   • Create an API key from your dashboard

2. Configure in Extension

   • Click the extension icon
   • Open Settings (gear icon)
   • Enable Daily Email Summary
   • Enter your email address
   • Enter your Resend API key
   • Click Save Settings

3. Test

   • Click Test to send a test email
   • You'll receive emails daily at 11 PM (local time)

📁 Project Structure

activity-tracker/
├── manifest.json       # Extension configuration
├── background.js       # Service worker (tracking logic)
├── popup.html         # Main popup UI
├── popup.css          # Styles (dark theme)
├── popup.js           # Popup interactions
├── icons/             # Extension icons
│   ├── icon16.png
│   ├── icon32.png
│   ├── icon48.png
│   └── icon128.png
├── screenshots/       # Store screenshots here
├── LICENSE            # MIT License
└── README.md          # This file

🔐 Privacy Policy

Activity Tracker is committed to your privacy:

• Local Storage Only: All browsing data is stored locally in your browser using Chrome's storage API. Nothing is sent to external servers.

• No Analytics: We don't use Google Analytics, Mixpanel, or any tracking services.

• No Account Required: The extension works entirely offline without any login.

• Optional Email Feature: If you enable email summaries, your data is sent to Resend's API only to deliver emails to your specified address. We don't store copies.

• Open Source: The entire codebase is available for review. What you see is what runs.

• Data Control: You can export or delete all your data at any time from the Settings menu.

🛠️ Development

Prerequisites

• Node.js (for icon generation only)

Generate Icons

npm install
npm run generate-icons

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Changelog

v1.0.0

• Initial release
• Time tracking with domain grouping
• Dark theme UI
• Calendar view for historical data
• Daily email summaries
• Export functionality

License

This project is licensed under the MIT License - see the LICENSE file for details.

💖 Acknowledgments

• Icons generated with custom Canvas rendering
• Fonts: Space Grotesk, JetBrains Mono
• Email delivery by Resend

---

Made with ❤️ for better productivity awareness

Report Bug · Request Feature