DedoMouse let's you control your computer mouse with your hands and a webcam.
Therefor, it uses the hand and finger tracking of Google's MediaPipe.
For available mouse actions and the corresponding hand gestures see the wiki.
Feel free to suggest ideas, ask questions, and report issues on GitHub.
You are encouraged to contribute ideas and code.
DedoMouse is written in Python. The following explains how to set up a development environment.
- Install a recent version of Python (3.8 or newer)
- Clone the repo and navigate to the project folder
- Create a virtual environment:
python -m venv env
- Activate the virtual environment:
env\Scripts\activate.bat
(for Windows) - Install dependencies:
pip install -r requirements.txt
- Start
src/main.py
This project uses
- pylint for code style checks (see
.pylintrc
). - mypy for static type checks (see
mypy.ini
).
As a rule of thumb, Python conventions should be followed.
Open a console in the virtual environment, then run
pyinstaller main.spec
This should create a folder named dist
with the executable.
'Dedo' is Spanish and means 'finger'.