Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kevinjanbarluado/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.
https://github.com/kevinjanbarluado/idle-assistant
automation desktop-application keyboard-control mit-license mouse-control open-source python system-tray
Last synced: 18 days ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/kevinjanbarluado/idle-assistant
- Owner: kevinjanbarluado
- License: mit
- Created: 2024-10-08T15:06:44.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-10-08T17:28:17.000Z (4 months ago)
- Last Synced: 2024-10-31T06:52:09.011Z (3 months ago)
- Topics: automation, desktop-application, keyboard-control, mit-license, mouse-control, open-source, python, system-tray
- Language: Python
- Homepage:
- Size: 21.1 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 
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**:
```bash
git clone https://github.com/kevinjanbarluado2/idle-assistant.git
cd idle-assistant
3. **Install Required Packages**:
```bash
pip install pyautogui keyboard pystray pillow
## Running the Application
1. **Run the script**:
```bash
python idleassistant.py
2. **Exit the Application**:
```bash
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](https://github.com/kevinjanbarluado2/idle-assistant/blob/main/LICENSE) file for more details.
## Acknowledgements
- [pyautogui](https://pyautogui.readthedocs.io/en/latest/) - For automating mouse and keyboard actions.
- [keyboard](https://keyboard.readthedocs.io/en/latest/) - For capturing keyboard events.
- [pystray](https://pystray.readthedocs.io/en/latest/) - For creating a system tray icon.
- [Pillow](https://python-pillow.org/) - For image processing.