https://github.com/fitzy1321/clickpy
Automated mouse clicker script
https://github.com/fitzy1321/clickpy
coverage poetry poetry-python pyautogui pytest pytest-cov pytest-mock python python-3 python-poetry python3 python39 typer
Last synced: 4 months ago
JSON representation
Automated mouse clicker script
- Host: GitHub
- URL: https://github.com/fitzy1321/clickpy
- Owner: fitzy1321
- License: mit
- Created: 2021-08-01T03:56:56.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-01-29T08:40:35.000Z (almost 3 years ago)
- Last Synced: 2025-03-10T12:55:28.895Z (10 months ago)
- Topics: coverage, poetry, poetry-python, pyautogui, pytest, pytest-cov, pytest-mock, python, python-3, python-poetry, python3, python39, typer
- Language: Python
- Homepage:
- Size: 271 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# clickpy
[](https://pypi.org/project/clickpy/)
Automated mouse clicker script using [PyAutoGUI](https://github.com/asweigart/pyautogui) and [Typer](https://github.com/tiangolo/typer).
This app will randomly click your mouse between 1 second and 3 minutes, to prevent your screen and apps from sleeping or displaying an `away` status.
The rational behind the random interval is: if the mouse contiually clicked every second or millisecond, it could easily be detected as an automated process.
The random interval provides a sembalance of feasability, although the interval could be reduced and extended as needed, or move the cursor after a couple consecutive clicks. (Possibe future feature?)
PyAutoGUI provides a simple interface to the mouse, and Typer provides simple cli parsing. You can find out more about these libraries with the links provided above.
## Installation
This package supports Python 3.6 through 3.9. It does not support any version of Python 2, nor any version of 3 lower than 3.6. Please upgrade our Python version, if possible.
I highly recommend using [pipx](https://github.com/pypa/pipx) for installing standalone packages, as it adds a layer of isolation to your installation. But pip will also work.
```bash
pipx install clickpy
# -- or --
pip install clickpy
```
If you're using macOS or Linux, you may have to install additional dependencies for PyAutoGUI to work properly. Please review their [docs](https://github.com/asweigart/pyautogui/blob/master/docs/install.rst) for additional information.
Windows users don't have to install any additional software.
To uninstall, type in your terminal:
```bash
pipx uninstall clickpy
# -- or --
pip uninstall clickpy
```
## Running
Once this package is installed, and any additional dependencies too, run the app like so:
```bash
clickpy
```
To stop it, press `ctrl+c`.
There are 3 flags you can use; `-d` will display debug information, `-f` will speed the app up to 1 click every second, and `--help` will display the help menu.
## For Developers
Please read [contributing.md](./CONTRIBUTING.md) for more information about this repo, how it's maintained and developed. And feel free to make PRs.