Screeni - Digital Wellbeing Chrome Extension

Screeni is an open-source Chrome extension designed to help you track your browsing habits, boost productivity, and build healthier digital routines—all through an elegant and intuitive interface.

Features

• Real-Time Tracking: Monitor your browsing sessions with live updates and visual breakdowns.
• Detailed Analytics: Gain daily and weekly insights through interactive charts and progress bars.
• Site Blocking: Eliminate distractions with one-click site blocking and customizable grace periods.
• Elegant Design: Sleek and intuitive interface with light and dark theme options.
• Privacy-Focused: All data is stored locally in your browser—no accounts or external tracking required.
• Open Source: Free to use and fully customizable under the GNU GPL v3.0 license.

Getting Started

Installation

1. Install from the Chrome Web Store

2. Or build from source:
   Clone the repository and build Screeni locally:

   git clone https://github.com/s000ik/screeni
   cd screeni
   npm install
   npm run build
   

How It Works

Screeni operates quietly in the background, tracking your browsing activity and presenting insights through an intuitive dashboard. Below are the key views and features:

Session View

• Monitor your current browsing session in real-time.
• View interactive progress bars and site-specific time breakdowns.

Daily View

• Review a detailed summary of your browsing activity for the day.
• Use quick controls to block distracting sites directly.

Weekly View

• Analyze your 7-day browsing patterns using interactive charts.
• Gain insights into average daily usage and overall productivity.

Settings

• Switch between light and dark themes for a personalized interface.
• Manage your data with privacy-focused options.

Privacy & Security

Screeni prioritizes your privacy by design:

• No accounts required: Use the extension immediately without sign-ups.
• Local data storage: All data is securely stored in your browser, with no external servers or cloud storage involved.
• Complete control: Manage your browsing data directly from the settings.

Technology Stack

• Frontend: React + TypeScript
• Styling: TailwindCSS
• Data Visualization: Recharts
• APIs: Chrome Extension APIs
• Build System: Vite

Contributing

We welcome contributions to improve Screeni. Follow these steps to get started:

1. Fork the repository.

2. Create a feature branch:

   git checkout -b feature/YourFeatureName
   

3. Commit your changes:

   git commit -m 'Add YourFeatureName'
   

4. Push to your branch:

   git push origin feature/YourFeatureName
   

5. Open a pull request.

For detailed guidelines, please refer to the CONTRIBUTING.md file.

License

This project is licensed under the GNU General Public License v3.0.

Made by

Satwik Singh and Parth Gupta - Team Bloomware

Support

If you encounter any issues or have feature requests, please open an issue in the GitHub Issue Tracker.

Take control of your digital wellbeing with Screeni.
Get started today!