desk-awake 1.0.0__tar.gz

desk_awake-1.0.0/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: desk-awake
+Version: 1.0.0
+Summary: Cross-platform idle activity simulator with AnyDesk integration
+Author: Abhinav Hudda
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: pynput>=1.7.0
+Provides-Extra: mac
+Requires-Dist: pyobjc-core>=9.0; extra == "mac"
+Requires-Dist: pyobjc-framework-ApplicationServices>=9.0; extra == "mac"
+Requires-Dist: pyobjc-framework-Cocoa>=9.0; extra == "mac"
+Requires-Dist: pyobjc-framework-Quartz>=9.0; extra == "mac"
+
+# Desk Awake
+
+Cross-platform idle activity simulator. Keeps your session active by generating mouse movements and keyboard actions until a specified time.
+
+Auto-detects the OS and uses appropriate modifier keys (`Cmd` on macOS, `Ctrl` on Linux/Windows) and system commands.
+
+## Installation
+
+```bash
+pip install desk-awake
+
+# On macOS, include the optional mac dependencies
+pip install "desk-awake[mac]"
+```
+
+## Usage
+
+Once installed, the `desk-awake` command is available globally:
+
+```bash
+# Run until a specific time (24h format)
+desk-awake --until "18:30"
+
+# Run until a specific date and time
+desk-awake --until "2025-01-15 17:00"
+
+# Short flag works too
+desk-awake -u "18:30"
+```
+
+### Multi-day mode
+
+Run daily on a schedule until a specific end date:
+
+```bash
+# Run every day from 09:00 to 18:30, until June 15th
+desk-awake -u "18:30" --start "09:00" --end-date "2026-06-15"
+```
+
+### Exit behavior flags
+
+| Flag | Description |
+|------|-------------|
+| `--close-anydesk` | Close AnyDesk when done (default) |
+| `--no-close-anydesk` | Don't close AnyDesk when done |
+| `--sleep` | Put machine to sleep when done |
+| `--no-sleep` | Don't sleep when done |
+
+### OS-specific defaults
+
+| OS | Close AnyDesk | Sleep |
+|----|---------------|-------|
+| macOS | ✅ | ✅ |
+| Linux | ✅ | ❌ |
+| Windows | ✅ | ✅ |
+
+Override any default with the flags above.
+
+### Examples
+
+```bash
+# Ubuntu: run until 6:30 PM, close AnyDesk, no sleep (default)
+desk-awake -u "18:30"
+
+# macOS: run until 6:30 PM, close AnyDesk, sleep (default)
+desk-awake -u "18:30"
+
+# macOS: skip sleep
+desk-awake -u "18:30" --no-sleep
+
+# Linux: force sleep too
+desk-awake -u "18:30" --sleep
+
+# Multi-day: run 09:00–18:30 daily until a date
+desk-awake -u "18:30" -s "09:00" -e "2026-06-15"
+
+# Keep everything running, don't close anything
+desk-awake -u "18:30" --no-close-anydesk --no-sleep
+```
+
+## Running without installing
+
+```bash
+python -m desk_awake --until "18:30"
+```
+
+## Requirements
+
+- Python 3.8+
+- `pynput` (installed automatically)
+- On macOS: `pyobjc` packages (install with `pip install "desk-awake[mac]"`)
+- On Linux: may need `xdotool` or X11 libs depending on your display server

desk_awake-1.0.0/README.md

@@ -0,0 +1,92 @@
+# Desk Awake
+
+Cross-platform idle activity simulator. Keeps your session active by generating mouse movements and keyboard actions until a specified time.
+
+Auto-detects the OS and uses appropriate modifier keys (`Cmd` on macOS, `Ctrl` on Linux/Windows) and system commands.
+
+## Installation
+
+```bash
+pip install desk-awake
+
+# On macOS, include the optional mac dependencies
+pip install "desk-awake[mac]"
+```
+
+## Usage
+
+Once installed, the `desk-awake` command is available globally:
+
+```bash
+# Run until a specific time (24h format)
+desk-awake --until "18:30"
+
+# Run until a specific date and time
+desk-awake --until "2025-01-15 17:00"
+
+# Short flag works too
+desk-awake -u "18:30"
+```
+
+### Multi-day mode
+
+Run daily on a schedule until a specific end date:
+
+```bash
+# Run every day from 09:00 to 18:30, until June 15th
+desk-awake -u "18:30" --start "09:00" --end-date "2026-06-15"
+```
+
+### Exit behavior flags
+
+| Flag | Description |
+|------|-------------|
+| `--close-anydesk` | Close AnyDesk when done (default) |
+| `--no-close-anydesk` | Don't close AnyDesk when done |
+| `--sleep` | Put machine to sleep when done |
+| `--no-sleep` | Don't sleep when done |
+
+### OS-specific defaults
+
+| OS | Close AnyDesk | Sleep |
+|----|---------------|-------|
+| macOS | ✅ | ✅ |
+| Linux | ✅ | ❌ |
+| Windows | ✅ | ✅ |
+
+Override any default with the flags above.
+
+### Examples
+
+```bash
+# Ubuntu: run until 6:30 PM, close AnyDesk, no sleep (default)
+desk-awake -u "18:30"
+
+# macOS: run until 6:30 PM, close AnyDesk, sleep (default)
+desk-awake -u "18:30"
+
+# macOS: skip sleep
+desk-awake -u "18:30" --no-sleep
+
+# Linux: force sleep too
+desk-awake -u "18:30" --sleep
+
+# Multi-day: run 09:00–18:30 daily until a date
+desk-awake -u "18:30" -s "09:00" -e "2026-06-15"
+
+# Keep everything running, don't close anything
+desk-awake -u "18:30" --no-close-anydesk --no-sleep
+```
+
+## Running without installing
+
+```bash
+python -m desk_awake --until "18:30"
+```
+
+## Requirements
+
+- Python 3.8+
+- `pynput` (installed automatically)
+- On macOS: `pyobjc` packages (install with `pip install "desk-awake[mac]"`)
+- On Linux: may need `xdotool` or X11 libs depending on your display server

desk_awake-1.0.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "desk-awake"
+version = "1.0.0"
+description = "Cross-platform idle activity simulator with AnyDesk integration"
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+authors = [
+    {name = "Abhinav Hudda"}
+]
+
+dependencies = [
+    "pynput>=1.7.0",
+]
+
+[project.optional-dependencies]
+mac = [
+    "pyobjc-core>=9.0",
+    "pyobjc-framework-ApplicationServices>=9.0",
+    "pyobjc-framework-Cocoa>=9.0",
+    "pyobjc-framework-Quartz>=9.0",
+]
+
+[project.scripts]
+desk-awake = "desk_awake.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

desk_awake-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

desk_awake-1.0.0/src/desk_awake/__init__.py

@@ -0,0 +1,3 @@
+"""Desk Awake - Cross-platform idle activity simulator."""
+
+__version__ = "1.0.0"

desk_awake-1.0.0/src/desk_awake/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running the package directly with: python -m desk_awake"""
+
+from .cli import main
+
+raise SystemExit(main())

desk_awake-1.0.0/src/desk_awake/cli.py

@@ -0,0 +1,80 @@
+import argparse
+from datetime import datetime
+
+from .core import CURRENT_OS, parse_datetime, parse_date, perform_actions
+
+
+def main():
+    """CLI entry point for desk-awake."""
+    parser = argparse.ArgumentParser(
+        prog='desk-awake',
+        description='Simulate idle activity until a specified time. '
+                    'Auto-detects OS and uses appropriate keys/commands.',
+        epilog='Defaults: On macOS — closes AnyDesk and sleeps. '
+               'On Linux — closes AnyDesk only (no sleep). '
+               'Use flags to override.'
+    )
+    parser.add_argument('--until', '-u', type=str, required=True,
+                        help='Daily stop time in format "YYYY-MM-DD HH:MM" or "HH:MM" (24h format)')
+    parser.add_argument('--end-date', '-e', type=str, default=None,
+                        help='Run daily until this date (format: YYYY-MM-DD). '
+                             'Script repeats each day from --start to --until time.')
+    parser.add_argument('--start', '-s', type=str, default=None,
+                        help='Daily start time in "HH:MM" format (used with --end-date). '
+                             'Defaults to now if not specified.')
+    parser.add_argument('--close-anydesk', action='store_true', dest='close_anydesk', default=None,
+                        help='Close AnyDesk when done')
+    parser.add_argument('--no-close-anydesk', action='store_false', dest='close_anydesk',
+                        help='Do NOT close AnyDesk when done')
+    parser.add_argument('--sleep', action='store_true', dest='sleep', default=None,
+                        help='Put machine to sleep when done')
+    parser.add_argument('--no-sleep', action='store_false', dest='sleep',
+                        help='Do NOT put machine to sleep when done')
+
+    args = parser.parse_args()
+
+    # Apply OS-specific defaults when user hasn't explicitly set a flag
+    if args.close_anydesk is None:
+        close_anydesk_on_exit = True  # Default: always close AnyDesk
+    else:
+        close_anydesk_on_exit = args.close_anydesk
+
+    if args.sleep is None:
+        # macOS/Windows: sleep by default. Linux: don't sleep by default.
+        sleep_on_exit = CURRENT_OS != "linux"
+    else:
+        sleep_on_exit = args.sleep
+
+    # Parse end date if provided
+    end_date = None
+    if args.end_date:
+        try:
+            end_date = parse_date(args.end_date)
+        except ValueError as e:
+            print(f"Error: {e}")
+            return 1
+
+        from datetime import date as date_cls
+        if end_date < date_cls.today():
+            print("Error: --end-date must be today or in the future!")
+            return 1
+
+    try:
+        stop_time = parse_datetime(args.until)
+
+        # For single-run mode (no end-date), stop_time must be in the future
+        if not end_date and stop_time <= datetime.now():
+            print("Error: Stop time must be in the future!")
+            return 1
+
+        print(f"Starting activity simulation: ~50 keys/min, ~60 mouse movements/min")
+        perform_actions(stop_time, close_anydesk_on_exit, sleep_on_exit,
+                        end_date=end_date, start_time_str=args.start)
+        return 0
+    except ValueError as e:
+        print(f"Error: {e}")
+        return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

desk_awake-1.0.0/src/desk_awake/core.py

@@ -0,0 +1,203 @@
+import time
+import subprocess
+import random
+import platform
+from datetime import datetime, timedelta, date
+from pynput.mouse import Controller as MouseController
+from pynput.keyboard import Controller as KeyboardController, Key
+
+# Initialize pynput controllers
+mouse = MouseController()
+keyboard = KeyboardController()
+
+# Detect OS
+CURRENT_OS = platform.system().lower()  # 'darwin' for macOS, 'linux' for Ubuntu/Linux, 'windows' for Windows
+
+
+def get_modifier_key():
+    """Return the appropriate modifier key for the current OS."""
+    if CURRENT_OS == "darwin":
+        return Key.cmd
+    else:
+        return Key.ctrl
+
+
+def close_anydesk():
+    """Close AnyDesk based on the current OS."""
+    try:
+        if CURRENT_OS == "darwin":
+            subprocess.run(['osascript', '-e', 'tell application "AnyDesk" to quit'], check=False)
+            subprocess.run(['pkill', '-f', 'AnyDesk'], check=False)
+        elif CURRENT_OS == "linux":
+            subprocess.run(['pkill', '-f', 'anydesk'], check=False)
+        elif CURRENT_OS == "windows":
+            subprocess.run(['taskkill', '/F', '/IM', 'AnyDesk.exe'], check=False)
+        print("AnyDesk closed.")
+    except Exception as e:
+        print(f"Error closing AnyDesk: {e}")
+
+
+def put_to_sleep():
+    """Put the machine to sleep based on the current OS."""
+    try:
+        if CURRENT_OS == "darwin":
+            subprocess.run(['osascript', '-e', 'tell application "System Events" to sleep'], check=False)
+            print("Mac is going to sleep...")
+        elif CURRENT_OS == "linux":
+            subprocess.run(['systemctl', 'suspend'], check=False)
+            print("Linux is going to sleep...")
+        elif CURRENT_OS == "windows":
+            subprocess.run(['rundll32.exe', 'powrprof.dll,SetSuspendState', '0,1,0'], check=False)
+            print("Windows is going to sleep...")
+    except Exception as e:
+        print(f"Error putting machine to sleep: {e}")
+
+
+def parse_datetime(datetime_str):
+    """Parse datetime string in format YYYY-MM-DD HH:MM or HH:MM."""
+    try:
+        return datetime.strptime(datetime_str, '%Y-%m-%d %H:%M')
+    except ValueError:
+        try:
+            return datetime.strptime(datetime_str, '%H:%M').replace(
+                year=datetime.now().year,
+                month=datetime.now().month,
+                day=datetime.now().day
+            )
+        except ValueError:
+            raise ValueError("Invalid datetime format. Use 'YYYY-MM-DD HH:MM' or 'HH:MM'")
+
+
+def parse_date(date_str):
+    """Parse date string in format YYYY-MM-DD."""
+    try:
+        return datetime.strptime(date_str, '%Y-%m-%d').date()
+    except ValueError:
+        raise ValueError("Invalid date format. Use 'YYYY-MM-DD'")
+
+
+def random_mouse_movement():
+    """Move the mouse by a small random offset."""
+    dx = random.randint(-30, 30)
+    dy = random.randint(-30, 30)
+    mouse.move(dx, dy)
+
+
+def random_keyboard_action():
+    """Press a random navigation key."""
+    actions = [Key.page_up, Key.page_down, Key.up, Key.down, Key.left, Key.right]
+    if random.random() < 0.8:
+        key = random.choice(actions)
+        keyboard.press(key)
+        time.sleep(random.uniform(0.02, 0.08))
+        keyboard.release(key)
+
+
+def _run_activity_loop(stop_time):
+    """Core activity loop — runs until stop_time."""
+    actions_per_second = (50 + 60) / 60  # ~1.83 actions per second
+
+    while datetime.now() < stop_time:
+        start_time = time.time()
+
+        # Perform a burst of actions
+        actions_this_cycle = random.randint(3, 8)
+
+        for _ in range(actions_this_cycle):
+            if random.random() < 0.55:  # Slightly favor mouse movements
+                random_mouse_movement()
+            else:
+                random_keyboard_action()
+
+            time.sleep(random.uniform(0.02, 0.1))
+
+        # Maintain target rate
+        elapsed = time.time() - start_time
+        target_time = actions_this_cycle / actions_per_second
+
+        if elapsed < target_time:
+            time.sleep(target_time - elapsed)
+
+        # Occasionally add a brief pause (10% chance)
+        if random.random() < 0.1:
+            idle_time = random.uniform(0.5, 2.0)
+            print(f"Brief pause for {idle_time:.2f} seconds...")
+            time.sleep(idle_time)
+
+
+def perform_actions(stop_time, close_anydesk_on_exit, sleep_on_exit, end_date=None, start_time_str=None):
+    """
+    Run simulated activity until stop_time, then optionally close AnyDesk and sleep.
+
+    If end_date is provided, the script runs daily:
+      - Each day it runs from start_time_str (or now) until the --until time.
+      - After each day's session, it sleeps until the next day's start time.
+      - On the final day (end_date), it runs the last session and then exits.
+    """
+    print(f"Detected OS: {CURRENT_OS}")
+    print(f"Modifier key: {'Cmd' if CURRENT_OS == 'darwin' else 'Ctrl'}")
+    print(f"On exit: close AnyDesk={'yes' if close_anydesk_on_exit else 'no'}, "
+          f"sleep={'yes' if sleep_on_exit else 'no'}")
+
+    if end_date:
+        daily_stop_hour = stop_time.hour
+        daily_stop_minute = stop_time.minute
+        daily_start_hour = int(start_time_str.split(':')[0]) if start_time_str else datetime.now().hour
+        daily_start_minute = int(start_time_str.split(':')[1]) if start_time_str else datetime.now().minute
+
+        print(f"Multi-day mode: running daily {daily_start_hour:02d}:{daily_start_minute:02d} → "
+              f"{daily_stop_hour:02d}:{daily_stop_minute:02d} until {end_date}")
+        print("-" * 50)
+
+        current_date = date.today()
+
+        while current_date <= end_date:
+            today_start = datetime(current_date.year, current_date.month, current_date.day,
+                                   daily_start_hour, daily_start_minute)
+            today_stop = datetime(current_date.year, current_date.month, current_date.day,
+                                  daily_stop_hour, daily_stop_minute)
+
+            now = datetime.now()
+
+            # If we haven't reached start time yet today, wait
+            if now < today_start:
+                wait_seconds = (today_start - now).total_seconds()
+                print(f"[{current_date}] Waiting {wait_seconds/60:.0f} min until start time "
+                      f"{daily_start_hour:02d}:{daily_start_minute:02d}...")
+                time.sleep(wait_seconds)
+
+            # If we've already passed today's stop time, skip to next day
+            if datetime.now() >= today_stop:
+                print(f"[{current_date}] Already past stop time, skipping to next day.")
+                current_date += timedelta(days=1)
+                continue
+
+            print(f"[{current_date}] Running until {today_stop.strftime('%H:%M')}...")
+            _run_activity_loop(today_stop)
+            print(f"[{current_date}] Day session complete.")
+
+            current_date += timedelta(days=1)
+
+            # If there are more days, sleep overnight (idle wait)
+            if current_date <= end_date:
+                next_start = datetime(current_date.year, current_date.month, current_date.day,
+                                      daily_start_hour, daily_start_minute)
+                wait_seconds = (next_start - datetime.now()).total_seconds()
+                if wait_seconds > 0:
+                    print(f"Sleeping until next session: {next_start.strftime('%Y-%m-%d %H:%M')} "
+                          f"({wait_seconds/3600:.1f} hours)")
+                    time.sleep(wait_seconds)
+
+        print("End date reached. All sessions complete.")
+    else:
+        # Single-run mode (original behavior)
+        print(f"Running until {stop_time.strftime('%Y-%m-%d %H:%M')}...")
+        print("-" * 50)
+        _run_activity_loop(stop_time)
+        print("Stop time reached. Exiting script.")
+
+    if close_anydesk_on_exit:
+        close_anydesk()
+
+    if sleep_on_exit:
+        put_to_sleep()

desk_awake-1.0.0/src/desk_awake.egg-info/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: desk-awake
+Version: 1.0.0
+Summary: Cross-platform idle activity simulator with AnyDesk integration
+Author: Abhinav Hudda
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: pynput>=1.7.0
+Provides-Extra: mac
+Requires-Dist: pyobjc-core>=9.0; extra == "mac"
+Requires-Dist: pyobjc-framework-ApplicationServices>=9.0; extra == "mac"
+Requires-Dist: pyobjc-framework-Cocoa>=9.0; extra == "mac"
+Requires-Dist: pyobjc-framework-Quartz>=9.0; extra == "mac"
+
+# Desk Awake
+
+Cross-platform idle activity simulator. Keeps your session active by generating mouse movements and keyboard actions until a specified time.
+
+Auto-detects the OS and uses appropriate modifier keys (`Cmd` on macOS, `Ctrl` on Linux/Windows) and system commands.
+
+## Installation
+
+```bash
+pip install desk-awake
+
+# On macOS, include the optional mac dependencies
+pip install "desk-awake[mac]"
+```
+
+## Usage
+
+Once installed, the `desk-awake` command is available globally:
+
+```bash
+# Run until a specific time (24h format)
+desk-awake --until "18:30"
+
+# Run until a specific date and time
+desk-awake --until "2025-01-15 17:00"
+
+# Short flag works too
+desk-awake -u "18:30"
+```
+
+### Multi-day mode
+
+Run daily on a schedule until a specific end date:
+
+```bash
+# Run every day from 09:00 to 18:30, until June 15th
+desk-awake -u "18:30" --start "09:00" --end-date "2026-06-15"
+```
+
+### Exit behavior flags
+
+| Flag | Description |
+|------|-------------|
+| `--close-anydesk` | Close AnyDesk when done (default) |
+| `--no-close-anydesk` | Don't close AnyDesk when done |
+| `--sleep` | Put machine to sleep when done |
+| `--no-sleep` | Don't sleep when done |
+
+### OS-specific defaults
+
+| OS | Close AnyDesk | Sleep |
+|----|---------------|-------|
+| macOS | ✅ | ✅ |
+| Linux | ✅ | ❌ |
+| Windows | ✅ | ✅ |
+
+Override any default with the flags above.
+
+### Examples
+
+```bash
+# Ubuntu: run until 6:30 PM, close AnyDesk, no sleep (default)
+desk-awake -u "18:30"
+
+# macOS: run until 6:30 PM, close AnyDesk, sleep (default)
+desk-awake -u "18:30"
+
+# macOS: skip sleep
+desk-awake -u "18:30" --no-sleep
+
+# Linux: force sleep too
+desk-awake -u "18:30" --sleep
+
+# Multi-day: run 09:00–18:30 daily until a date
+desk-awake -u "18:30" -s "09:00" -e "2026-06-15"
+
+# Keep everything running, don't close anything
+desk-awake -u "18:30" --no-close-anydesk --no-sleep
+```
+
+## Running without installing
+
+```bash
+python -m desk_awake --until "18:30"
+```
+
+## Requirements
+
+- Python 3.8+
+- `pynput` (installed automatically)
+- On macOS: `pyobjc` packages (install with `pip install "desk-awake[mac]"`)
+- On Linux: may need `xdotool` or X11 libs depending on your display server

desk_awake-1.0.0/src/desk_awake.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+src/desk_awake/__init__.py
+src/desk_awake/__main__.py
+src/desk_awake/cli.py
+src/desk_awake/core.py
+src/desk_awake.egg-info/PKG-INFO
+src/desk_awake.egg-info/SOURCES.txt
+src/desk_awake.egg-info/dependency_links.txt
+src/desk_awake.egg-info/entry_points.txt
+src/desk_awake.egg-info/requires.txt
+src/desk_awake.egg-info/top_level.txt

desk_awake-1.0.0/src/desk_awake.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

desk_awake-1.0.0/src/desk_awake.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+desk-awake = desk_awake.cli:main

desk_awake-1.0.0/src/desk_awake.egg-info/requires.txt

@@ -0,0 +1,7 @@
+pynput>=1.7.0
+
+[mac]
+pyobjc-core>=9.0
+pyobjc-framework-ApplicationServices>=9.0
+pyobjc-framework-Cocoa>=9.0
+pyobjc-framework-Quartz>=9.0

desk_awake-1.0.0/src/desk_awake.egg-info/top_level.txt

@@ -0,0 +1 @@
+desk_awake