================================================================================
                         SESSION KEEP-AWAKE v1.1.0
================================================================================

Author: Doug Hesseltine
Date: 2025-10-31
Copyright (C) Technologist.Services 2025
Source: https://technologist.services/tools/session-keep-awake/

================================================================================
PURPOSE
================================================================================

Session Keep-Awake prevents Windows from locking your session due to inactivity
by simulating minimal user activity at regular intervals.

This tool is useful when:
- You need to keep your session active during long-running processes
- You want to prevent screen lock without disabling security policies
- You need to stay connected to remote sessions or VPNs

================================================================================
HOW IT WORKS
================================================================================

Every 4 minutes, the script performs two non-intrusive actions:

1. Mouse Movement: Moves the cursor 1 pixel to the right, then immediately 
   back to its original position. This is virtually unnoticeable to the user.

2. ScrollLock Toggle: Sends the ScrollLock key twice in succession, leaving 
   the ScrollLock state unchanged. This key is rarely used and won't 
   interfere with your work.

These actions are enough to prevent Windows from considering your session 
idle, without disrupting your actual work.

================================================================================
INSTALLATION
================================================================================

1. Extract all files from session-keep-awake.zip to a temporary folder

2. Run install-session-keep-awake.bat (double-click the file)

3. The installer will:
   - Create a Scripts folder in your user profile: C:\Users\{YourUsername}\Scripts
   - Copy session-keep-awake.bat, session-keep-awake.ps1, and this README
     to the Scripts folder
   - Create a shortcut in your Windows Startup folder
   - Launch the tool immediately
   - Verify the tool started successfully
   - Open the Scripts folder to show installed files

4. Session Keep-Awake is now running and will start automatically at login

================================================================================
REQUIREMENTS
================================================================================

- Windows 10 or Windows 11
- No administrator privileges required
- PowerShell execution (handled automatically by the batch launcher)
- Approximately 10KB of disk space

================================================================================
FILE INTEGRITY VERIFICATION
================================================================================

To verify the downloaded ZIP file hasn't been tampered with, you can check
its MD5 hash. Open PowerShell and run the following command:

Get-FileHash -Path "session-keep-awake.zip" -Algorithm MD5

Compare the output with the MD5 hash displayed on the download page at:
https://technologist.services/tools/session-keep-awake/

If the hashes match, the file is authentic and hasn't been modified.

================================================================================
UNINSTALLATION
================================================================================

To remove Session Keep-Awake:

1. Delete the startup shortcut:
   %APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\session-keep-awake.lnk

2. Delete the files from your Scripts folder (C:\Users\{YourUsername}\Scripts):
   - session-keep-awake.bat
   - session-keep-awake.ps1
   - README-session-keep-awake.txt

3. (Optional) Delete the Scripts folder if you're not using it for anything else

4. Stop any running instances via Task Manager (find PowerShell process running
   session-keep-awake.ps1)

================================================================================
TROUBLESHOOTING
================================================================================

If the tool doesn't start automatically at login:
- Check that the shortcut exists in your Startup folder:
  %APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup
- Try running session-keep-awake.bat manually from the Scripts folder
- Verify the Scripts folder exists: C:\Users\{YourUsername}\Scripts

If the tool doesn't seem to be working:
- Open Task Manager and look for a PowerShell process
- Check if the process command line includes "session-keep-awake.ps1"
- Try running the BAT file manually to see any error messages

================================================================================
TECHNICAL DETAILS
================================================================================

Files included:
- session-keep-awake.bat: Launcher that bypasses PowerShell execution policy
- session-keep-awake.ps1: Main PowerShell script that performs the keep-awake
                          actions
- install-session-keep-awake.bat: Installer script
- README-session-keep-awake.txt: This file

The tool runs minimized and hidden in the background. To stop it, open Task
Manager and end the PowerShell process running session-keep-awake.ps1.

================================================================================
SUPPORT
================================================================================

For more information, visit:
https://technologist.services/tools/session-keep-awake/

================================================================================
