add time tracker program

belkhoujaons · belkhoujaons · commit 525edb961146 · 2025-10-12T15:56:45.000+01:00
diff --git a/TIME_TRACKER/README.md b/TIME_TRACKER/README.md
@@ -0,0 +1,68 @@
+# Break Reminder (Python)
+
+A simple cross-platform Python script that tracks how long your system has been running and reminds you to take a short break every hour.  
+Works on **Windows, macOS, and Linux** — no external libraries required.
+
+---
+
+## 🚀 Features
+- Tracks system uptime in real time  
+- Sends a **notification every hour** to remind you to rest  
+- Lightweight and under **100 lines of code**  
+- Uses only the **Python standard library**  
+- Works silently in the background (optional)
+
+---
+
+## 🧩 Requirements
+- **Python 3.8+**
+- Works on:
+  - Windows 10 / 11  
+  - macOS  
+  - Linux (with `notify-send`)
+
+---
+
+## 💻 Installation
+
+1. Download or copy the file `break_reminder.py`.
+2. Make sure Python is installed and added to PATH.
+3. Open a terminal or command prompt.
+4. Run the script:
+
+   ```
+   python break_reminder.py
+   ```
+
+You should see:
+
+```
+Break reminder started! You'll get notified every hour.
+
+System on for 0h 5m
+```
+
+After an hour of uptime, a notification will appear:
+> You’ve been working for an hour! Time to take a short break ☕
+
+---
+
+## ⚙️ Run Silently (Optional)
+If you don’t want the console window to stay open:
+1. Rename the file to `break_reminder.pyw`.
+2. Run it using:
+   ```
+   pythonw break_reminder.pyw
+   ```
+3. Or add it to **Task Scheduler** → “Run at logon” for automatic startup.
+
+---
+
+## 🧠 How It Works
+- Retrieves system uptime:
+  - Windows → `GetTickCount64`
+  - Linux → `/proc/uptime`
+  - macOS → `sysctl kern.boottime`
+- Every 3600 seconds, displays a platform-specific notification.
+- Checks uptime every 30 seconds to avoid heavy resource use.
+
diff --git a/TIME_TRACKER/time_tracker_app.py b/TIME_TRACKER/time_tracker_app.py
@@ -0,0 +1,83 @@
+"""
+Break Reminder — A simple cross-platform Python script
+that reminds you to take a break every hour based on system uptime.
+
+✅ Works on Windows, macOS, and Linux
+✅ Uses only the Python standard library
+✅ Under 100 lines and well-commented
+"""
+
+import time
+import platform
+import ctypes
+import os
+import sys
+import datetime
+import subprocess
+
+def get_uptime_seconds():
+    """Return the system uptime in seconds for the current OS."""
+    system = platform.system()
+
+    try:
+        if system == "Windows":
+            # Windows: milliseconds since last boot
+            return ctypes.windll.kernel32.GetTickCount64() / 1000
+
+        elif system == "Linux":
+            # Linux: read uptime from /proc/uptime
+            with open("/proc/uptime", "r") as f:
+                return float(f.readline().split()[0])
+
+        elif system == "Darwin":
+            # macOS: use sysctl to get boot time
+            boot_time = subprocess.check_output(["sysctl", "-n", "kern.boottime"]).decode()
+            sec = int(boot_time.split("sec =")[1].split(",")[0])
+            boot = datetime.datetime.fromtimestamp(sec)
+            return (datetime.datetime.now() - boot).total_seconds()
+
+        else:
+            raise NotImplementedError("Unsupported OS")
+
+    except Exception as e:
+        print("Error detecting uptime:", e)
+        return 0
+
+
+def notify(message):
+    """Display a cross-platform notification with the given message."""
+    system = platform.system()
+
+    if system == "Windows":
+        ctypes.windll.user32.MessageBoxW(0, message, "Break Reminder", 0x40)
+    elif system == "Darwin":
+        os.system(f'''osascript -e 'display notification "{message}" with title "Break Reminder"' ''')
+    else:  # Linux
+        os.system(f'notify-send "Break Reminder" "{message}"')
+
+
+def main():
+    """Main loop — checks uptime and reminds user every hour."""
+    print("☕ Break Reminder started! You'll be notified every hour.\n")
+
+    last_reminder = 0  # Tracks how many hours have passed
+
+    while True:
+        uptime = get_uptime_seconds()
+        hours_on = int(uptime // 3600)
+        mins_on = int((uptime % 3600) // 60)
+
+        # Show live uptime in the terminal
+        sys.stdout.write(f"\rSystem on for {hours_on}h {mins_on}m")
+        sys.stdout.flush()
+
+        # Send a reminder every hour
+        if uptime // 3600 > last_reminder:
+            notify("You’ve been working for an hour! Time to take a short break ☕")
+            last_reminder += 1
+
+        time.sleep(30)  # Check every 30 seconds
+
+
+if __name__ == "__main__":
+    main()
