{"id":24580542,"url":"https://github.com/kevinjanbarluado/idle-assistant","last_synced_at":"2025-08-27T01:33:13.522Z","repository":{"id":260410375,"uuid":"869599202","full_name":"kevinjanbarluado/idle-assistant","owner":"kevinjanbarluado","description":"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.","archived":false,"fork":false,"pushed_at":"2024-10-08T17:28:17.000Z","size":22113,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-24T01:54:28.134Z","etag":null,"topics":["automation","desktop-application","keyboard-control","mit-license","mouse-control","open-source","python","system-tray"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kevinjanbarluado.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-08T15:06:44.000Z","updated_at":"2024-10-08T17:38:38.000Z","dependencies_parsed_at":"2024-10-31T07:04:13.427Z","dependency_job_id":null,"html_url":"https://github.com/kevinjanbarluado/idle-assistant","commit_stats":null,"previous_names":["kevinjanbarluado/idle-assistant"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjanbarluado%2Fidle-assistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjanbarluado%2Fidle-assistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjanbarluado%2Fidle-assistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinjanbarluado%2Fidle-assistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kevinjanbarluado","download_url":"https://codeload.github.com/kevinjanbarluado/idle-assistant/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244059988,"owners_count":20391445,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","desktop-application","keyboard-control","mit-license","mouse-control","open-source","python","system-tray"],"created_at":"2025-01-24T01:54:41.718Z","updated_at":"2025-03-17T15:43:24.030Z","avatar_url":"https://github.com/kevinjanbarluado.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src='https://raw.githubusercontent.com/kevinjanbarluado2/idle-assistant/main/icon.ico' width=\"40\" height=\"40\" /\u003e Idle Assistant\n\n**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.\n\n## Features\n\n- **Random Mouse Movement**: Moves the mouse cursor randomly across the screen to simulate user activity.\n- **Auto Alt-Tab**: Automatically switches between open windows at random intervals.\n- **Random Keystrokes**: Sends random keystrokes to keep applications active.\n- **System Tray Icon**: Runs silently in the system tray with an easy way to exit the application.\n\n## Installation\n\n### Prerequisites\n\n- Python 3.x installed on your machine.\n- `pip` (Python package installer) for managing Python packages.\n\n### Download Executables\nFor 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.\n\n### Steps to Install\n\n1. **Clone the Repository**:\n   ```bash\n   git clone https://github.com/kevinjanbarluado2/idle-assistant.git\n   cd idle-assistant\n   \n3. **Install Required Packages**:\n   ```bash\n   pip install pyautogui keyboard pystray pillow\n\n## Running the Application\n\n1. **Run the script**:\n   ```bash\n   python idleassistant.py\n\n2. **Exit the Application**:\n   ```bash\n   Click the ESC key or right-click on the system tray icon and select Exit.\n\n## Usage\nOnce 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.\n\n## Contributing\nContributions are welcome! If you'd like to contribute to IdleAssistant, please fork the repository and create a pull request.\n\n## License\nThis project is licensed under the MIT License. See the [LICENSE](https://github.com/kevinjanbarluado2/idle-assistant/blob/main/LICENSE) file for more details.\n\n## Acknowledgements\n- [pyautogui](https://pyautogui.readthedocs.io/en/latest/) - For automating mouse and keyboard actions.\n- [keyboard](https://keyboard.readthedocs.io/en/latest/) - For capturing keyboard events.\n- [pystray](https://pystray.readthedocs.io/en/latest/) - For creating a system tray icon.\n- [Pillow](https://python-pillow.org/) - For image processing.\n   \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinjanbarluado%2Fidle-assistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkevinjanbarluado%2Fidle-assistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinjanbarluado%2Fidle-assistant/lists"}