swiftcast/dwellpy

Dwellpy

A simple tool that simulates a mouse click if the cursor remains stationary for a predetermined amount of time. This project is useful for users looking for accessibility options or those who need automated clicking solutions.

Table of Contents

• Background
• Install
• Usage
• Converting to Executable
• Maintainers
• Contributing
• License

Background

Dwellpy is designed to help individuals who may have difficulty with manual clicking or anyone who can benefit from automatic clicking after a dwell period. This script uses Python and the pynput library to monitor mouse movement and clicks, triggering a click action when the mouse has been still for a set amount of time.

Install

This project uses Python and pynput. Go to Python's website to download and install Python. Installation of pynput is managed through pip.

pip install pynput

Ensure you have Python and pip installed prior to installing the pynput library.

Usage

To run Dwellpy, you need to have Python installed on your system as well as the pynput library. Save the script as dwell.py.

Run the script in your terminal or command prompt:

python dwell.py

By default, the dwell time is set to 2 seconds. You can adjust the dwell time by changing the dwell_time variable inside the script.

Controls

• Move Mouse: Resets the dwell timer.
• Manual Click: Cancels the automatic click if performed before the dwell timer finishes.

Stopping the Script

To stop the Dwellpy, simply interrupt the process by pressing Ctrl+C in your terminal or command prompt.

Converting to Executable

To convert dwell.py into a standalone executable file:

Requirements

Install PyInstaller from PyPI:

pip install pyinstaller

Creating the Executable

Navigate to the script's directory and run PyInstaller:

pyinstaller --onefile --windowed dwell.py

• --onefile - Tells PyInstaller to bundle everything into a single executable.
• --windowed - Prevents a command prompt window from appearing when you run the executable (useful for GUI applications).

Locate the Executable

After running PyInstaller, find the executable in the dist folder inside your script's directory. This .exe file can now be distributed and run on any compatible Windows machine without needing Python installed.

Maintainers

@swiftcast.

Contributing

Feel free to dive in! Open an issue or submit PRs.

Standard Readme adheres to the Contributor Covenant code of conduct.