ScreenGuard

ScreenGuard — Digital Wellbeing for Linux
ScreenGuard is an innovative open-source wellness application tailored for Linux, designed to enhance productivity and promote healthier digital habits. Built using Flutter, this privacy-first application incorporates key features inspired by Android's Digital Wellbeing, including a digital dashboard, daily app limits, and a focus mode to aid users in managing screen time effectively on both Wayland and X11 environments.

Key Features

1. Digital Wellbeing Dashboard

   • Overview Cards: Provides instant access to today's screen time along with cumulative totals for the past 30 days and daily averages.
   • Interactive Weekly Bar Chart: Visual representation of weekly screen time with user-friendly tooltips.
   • App Usage Breakdown: Detailed app usage statistics displayed through color-coded donut charts and custom progress bars.

   

2. Week-by-Week Navigation

   • Navigate through previous weeks with ease along an interactive day inspector for detailed app usage breakdowns.

   
   

3. Daily App Limits & Lockout Screen

   • Custom & Preset Quotas: Set daily application limits with easy-to-use buttons or custom values.
   • Additional features include notifications when nearing limits and a lockout screen for when thresholds are reached, allowing temporary extensions or modifications to limit settings.

   

4. Focus Mode

   • An integrated Pomodoro timer with customizable session durations and breaks helps maintain focus.
   • During focus sessions, distracting apps can be automatically minimized or closed for enhanced concentration.

   
   

5. User Settings & Controls

   • Environment personalization is possible with customizable themes, notifications, and application settings to control app behavior.

   
   
   

6. Privacy-Focused Local Storage

   • All data is stored locally using SQLite, ensuring privacy as no information is shared with external servers or cloud services.

Architecture

ScreenGuard consists of a user-friendly GUI built with Flutter, a lightweight background daemon to manage tracking and limits, and a native GNOME Shell extension that facilitates interaction with display servers. The architecture promotes efficiency and smooth operation within both X11 and Wayland environments.

graph TD  
    A[ScreenGuard Flutter GUI] -->|SQLite WAL| DB[(usage.db)]  
    B[screenguard-daemon] -->|SQLite WAL| DB  
    B -->|Poll active window| C{Display Server}  
    C -->|Wayland GNOME| D[GNOME Shell Extension D-Bus]  
    C -->|X11 Desktop| E[X11 EWMH xprop / xdotool]  
    B -->|Enforce Limits & Focus| F[Desktop Notification / Minimize Window]  

Future Enhancements

Looking ahead, planned developments for ScreenGuard include a major UI overhaul, enhanced tracking for browser tabs, categorized app limits, and broader support for various Linux environments.

Join the community:
Contributions are welcomed; users can report bugs, suggest features, or participate in translation efforts. Visit the project repository to learn more and contribute to ScreenGuard's growth.