KeepActive

A lightweight automation tool that prevents your computer from going idle by simulating mouse movements or keyboard inputs at randomized intervals.

Features

• Dual Mode Operation: Choose between mouse movement or keyboard input simulation
• Randomized Timing: Configurable min/max intervals to create human-like behavior
• Customizable Settings: Adjust all parameters including keys, intervals, and movement distance
• User-Friendly GUI: Clean interface with real-time status logging
• Safe Operation: Hold Q for 2 seconds to quit, preventing accidental exits
• Pause/Resume: Temporarily pause automation without stopping completely
• Standalone Executable: No Python installation required for end users

Download & Installation

Option 1: Download Pre-built Executable (Recommended for Most Users)

1. Go to the Releases page
2. Download KeepActive.exe from the latest release
3. Run the executable - no installation required!

Note: Windows SmartScreen may show a warning. Click "More info" → "Run anyway". This is normal for unsigned executables.

Option 2: Run from Source Code

Requirements:

• Python 3.7 or higher
• pip (Python package manager)

Installation:

# Clone the repository
git clone https://github.com/yourusername/keepactive.git
cd keepactive

# Install dependencies
pip install -r requirements.txt

# Run the application
python KeepActive.py

Usage

Basic Operation

1. Select Mode: Choose between "Mouse Movement" or "Keyboard Taps"
2. Configure Settings: Adjust intervals, movement distance, or keys as needed
3. Start Automation: Click the "Start" button
4. Monitor Status: Watch the status log for real-time feedback

Settings Guide

Setting	Default	Description
Interval Min	270 sec	Minimum time between automation cycles
Interval Max	330 sec	Maximum time between automation cycles
Mouse Movement	25 px	Distance the mouse moves (Mouse mode only)
Key Hold Time	60 ms	Duration to hold each key (Keyboard mode only)
First Key	d	First key to press (Keyboard mode only)
Second Key	a	Second key to press (Keyboard mode only)
Gap Min	50 ms	Minimum delay between left/right actions
Gap Max	150 ms	Maximum delay between left/right actions

Example Configurations

Prevent Screen Lock:

Mode: Mouse Movement
Interval: 240-300 seconds
Movement: 25 pixels
Gap: 50-100 ms

Gaming - Stay Active:

Mode: Keyboard Taps
Interval: 270-330 seconds
Keys: w and s
Key Hold: 60 ms
Gap: 80-150 ms
Note: Game window must be active

Video Streaming:

Mode: Mouse Movement
Interval: 180-220 seconds
Movement: 10 pixels
Gap: 60-120 ms

Controls

• Start Button: Begin automation
• Pause Button: Pause or resume automation
• Stop Button: Stop automation completely
• Hold Q (2 seconds): Quit the application (window must be active)

Building from Source

To create your own executable:

# Install PyInstaller
pip install pyinstaller

# Build the executable
python build_exe.py

# Or build manually
pyinstaller --onefile --windowed --name=KeepActive KeepActive.py

# Find your executable in the dist/ folder

How It Works

KeepActive uses randomized intervals to simulate human-like activity:

1. Randomized Timing: Waits a random duration between your configured min/max interval
2. Action Execution: Performs either mouse movement or keyboard input
3. Natural Gaps: Adds random delays between left/right actions
4. Repeat: Continues until paused or stopped

This randomization makes the automation less detectable and more natural-looking.

Troubleshooting

Nothing happens when I click Start

• Check interval settings are reasonable (not too long)
• For keyboard mode, ensure your target application is the active window
• Review the status log for error messages

Keyboard inputs not working

• Make sure the target application window is active and in focus
• Some applications block simulated input - try running as Administrator
• Certain anti-cheat systems may prevent this from working

Antivirus flags the executable

• This is a false positive common with PyInstaller executables
• The source code is available for review
• You can build your own executable from source

Mouse movement is too subtle/obvious

• Adjust the "Mouse Movement (pixels)" setting
• Lower values = more subtle, Higher values = more noticeable

Disclaimer

This tool is provided for legitimate use cases only, including:

• Preventing automatic screen locks during presentations
• Maintaining presence in applications during legitimate use
• Testing and development purposes
• Personal convenience within legal boundaries

Do NOT use this tool to:

• Violate terms of service of any application or online service
• Circumvent anti-cheat systems in online games
• Deceive employers or time-tracking systems
• Engage in any fraudulent or unauthorized activity

Important Notes:

• Some applications and games have policies against automation tools
• Using this tool may violate the terms of service of certain applications
• Users are solely responsible for ensuring their use complies with all applicable rules, policies, and laws
• The developers assume no liability for misuse of this software

Use this software responsibly and at your own risk.

Technical Details

• Language: Python 3.7+
• GUI Framework: Tkinter (built-in with Python)
• Automation: PyAutoGUI
• Build Tool: PyInstaller
• Executable Size: ~15-20 MB

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For issues, questions, or feature requests, please open an issue on the GitHub Issues page.

---

Version: 1.0.0
Author: Mxrkymxrk Repository: https://github.com/mxrkymxrk/keepactive