ScreenGuard v0.1.0 — Digital Wellbeing for Linux

ScreenGuard v0.1.0 — Digital Wellbeing for Linux

ScreenGuard is an open-source, privacy-first Digital Wellbeing desktop application for Linux. It provides per-app screen time tracking, daily app time limits with lockout screens, a Focus Mode / Pomodoro timer with distraction app blocking, and weekly activity history. All data is stored 100% locally in SQLite.

---

✨ Features & Highlights

• 📊 Weekly & 30-Day Activity Charts: Interactive bar charts and app share donut charts with active vs. idle/away breakdown.
• 🎯 Focus Mode (Pomodoro Timer): 15, 25, 45, and 60-minute focus sessions with automatic distraction app minimization/blocking.
• ⏱️ Daily App Limits & Lockout Screen: Set custom daily thresholds per app with 90% warnings and 100% time's up lockout screens (with "+5 min" extensions).
• 🧩 GNOME Shell Integration & Desktop Detection: Real-time active window detection via native GNOME Shell Extension D-Bus service (screenguard@screenguard.app) and X11 EWMH backend.
• 🔒 100% Offline & Private: Zero cloud sync or telemetry. SQLite database with WAL journal mode stored in ~/.local/share/screenguard/usage.db.

---

📦 Quick 1-Line Installation (No Git Cloning Needed!)

Copy and paste the single-line command for your distro:

🐧 Ubuntu / Debian / Zorin OS / Linux Mint / Pop!_OS (.deb)

wget https://github.com/adityakrishnan005-a11y/ScreenGuard/releases/download/v0.1.0/screenguard_0.1.0_amd64.deb && sudo apt update && sudo apt install ./screenguard_0.1.0_amd64.deb -y

🎩 Fedora / RHEL / Rocky Linux (.rpm)

sudo dnf install https://github.com/adityakrishnan005-a11y/ScreenGuard/releases/download/v0.1.0/screenguard-0.1.0-1.x86_64.rpm -y

🏹 Arch Linux / Manjaro (AUR)

yay -S screenguard-bin

---

🛠️ Building from Source (Developers)

git clone https://github.com/adityakrishnan005-a11y/ScreenGuard.git
cd ScreenGuard
flutter pub get
flutter build linux --release
dart compile exe bin/daemon.dart -o build/linux/x64/release/bundle/screenguard-daemon