Skip to main content

An augmentative tool to use the mouse with the movement of the head.

Project description

Headmouse

The HeadMouse module provides an interface by opening the web camera anddetecting the user's face to control the mouse by tilting the head, using the tip of the nose as reference point. It can also be customized to trigger different functions instead of a mouse click when the user winks. To use the module it's necessary to have the file shape_predictor_68_face_landmarks.dat.

Features: Single user (closest one) detection. Detection of right and left eyes' wink. Detection of mouth's right corner movement. Improved nose threshold to avoid unvoluntary movement.

Compressed: http://dlib.net/files/shape_predictor_68_face_landmarks.dat.bz2

Uncompressed: https://github.com/rfontalva/dlib_shape_predictor_68_face_landmarks/tree/master'

This project is part of a larger one called "Tecnoapoyos y Sociedad", which aims to level the opportunities of access to technologies for those who are impaired by some kind of disability, motor or neurological.

An opensource project developed in UTN-FRBA by Ramiro Fontalva.

Run demo

from headmouse import Headmouse
import cv2

if __name__ == "__main__":
    predictor_path = "/path/to/shape_predictor_68_face_landmarks.dat"
    h = Headmouse(predictor_path=predictor_path)
    h.update_threshold(10, 5)
    while True:
        h.refresh()
        h.show_image()
        key = cv2.waitKey(1)
        if key == 27: #press escape
            h.destroy_window()
            h.quit()
            break
        if key == 32: #press spacebar
            h.calibrate()
            print("calibrated")

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

headmouse-1.0.6.3.tar.gz (7.6 kB view details)

Uploaded Source

File details

Details for the file headmouse-1.0.6.3.tar.gz.

File metadata

  • Download URL: headmouse-1.0.6.3.tar.gz
  • Upload date:
  • Size: 7.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.9 tqdm/4.63.1 importlib-metadata/4.11.3 keyring/18.0.1 rfc3986/2.0.0 colorama/0.4.3 CPython/3.8.10

File hashes

Hashes for headmouse-1.0.6.3.tar.gz
Algorithm Hash digest
SHA256 6418fff0ff03bee1e3de930961fa74d1a4bf64d6a4cfb769d3f3136fa365aaf5
MD5 f2eca11e01b297a6cbd5b167c73076ed
BLAKE2b-256 c44e00748085d5a769d5f94c9da69befe8644da6a192fe61d8009347a8c7926e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page