/idle-assistant

Idle Assistant is a lightweight automation tool designed to simulate user activity on your computer, ensuring that your system stays active even when you are away from the keyboard. This application is ideal for users who need to prevent their screens from going idle, avoid timeouts during long tasks, or maintain uninterrupted sessions.

Primary LanguagePythonMIT LicenseMIT

Idle Assistant

Idle Assistant is a lightweight application designed to automate simple user interactions on your computer, including random mouse movements, keystrokes, and automatic window switching. It's particularly useful for preventing inactivity timeouts during long periods of non-use.

Features

  • Random Mouse Movement: Moves the mouse cursor randomly across the screen to simulate user activity.
  • Auto Alt-Tab: Automatically switches between open windows at random intervals.
  • Random Keystrokes: Sends random keystrokes to keep applications active.
  • System Tray Icon: Runs silently in the system tray with an easy way to exit the application.

Installation

Prerequisites

  • Python 3.x installed on your machine.
  • pip (Python package installer) for managing Python packages.

Download Executables

For convenience, pre-built executables for both Windows and macOS are available in the Releases section of the repository. You can download the appropriate executable for your operating system and skip the installation steps.

Steps to Install

  1. Clone the Repository:
    git clone https://github.com/kevinjanbarluado2/idle-assistant.git
    cd idle-assistant
    
  2. Install Required Packages:
    pip install pyautogui keyboard pystray pillow
    

Running the Application

  1. Run the script:
    python idleassistant.py
    
  2. Exit the Application:
    Click the ESC key or right-click on the system tray icon and select Exit.
    

Usage

Once the application is running, it will start performing random mouse movements, Alt-Tabbing between open windows, and sending random keystrokes according to the predefined intervals.

Contributing

Contributions are welcome! If you'd like to contribute to IdleAssistant, please fork the repository and create a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Acknowledgements

  • pyautogui - For automating mouse and keyboard actions.
  • keyboard - For capturing keyboard events.
  • pystray - For creating a system tray icon.
  • Pillow - For image processing.