Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fastily/im-present

🙋‍♂️ Periodically shakes your mouse pointer
https://github.com/fastily/im-present

mouse-wiggler python

Last synced: about 1 month ago
JSON representation

🙋‍♂️ Periodically shakes your mouse pointer

Awesome Lists containing this project

README

        

# im-present
[![Python 3.11+](https://upload.wikimedia.org/wikipedia/commons/6/62/Blue_Python_3.11%2B_Shield_Badge.svg)](https://www.python.org)
[![License: GPL v3](https://upload.wikimedia.org/wikipedia/commons/8/86/GPL_v3_Blue_Badge.svg)](https://www.gnu.org/licenses/gpl-3.0.en.html)

Simple utility which moves your mouse by 1 pixel and then back at a specified interval. Useful for pretending to be at your computer and fooling apps which track your productivity.

## Installation
```bash
pip install im-present
```

👉 Installs a CLI alias called `present` which can be used to invoke the program directly

## Run
```bash
# Run indefinitely until quit (ctrl+c)
present

# Wiggle the mouse every 30s and wait 2s before moving it back to the original posotion
present -i 30 -j 2
```

👉 `im-present` also checks if you're using your computer (i.e. did you manually move the mouse), in which case the mouse will not be moved until the next interval.

## Usage
```
usage: present [-h] [-i secs] [-j secs] [-t secs]

periodically shakes the mouse pointer to prove you're here

options:
-h, --help show this help message and exit
-i secs number of seconds to wait in between mouse movements. Defaults to 600.
-j secs number of seconds to wait in between mouse jitters. Defaults to 0.5.
-t secs if set, exit after this many seconds have elapsed from the time this program was first started.
```