Skip to content

achimmihca/DedoMouse

Repository files navigation

CircleCI License: MIT

DedoMouse

DedoMouse let's you control your computer mouse with your hands and a webcam.

DedoMouse-Demo

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.

Development

You are encouraged to contribute ideas and code.

DedoMouse is written in Python. The following explains how to set up a development environment.

Python Setup

  • 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

Code Style

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.

Create Executable

Open a console in the virtual environment, then run

pyinstaller main.spec

This should create a folder named dist with the executable.

Trivia

'Dedo' is Spanish and means 'finger'.