# 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.
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>'
## 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.
An opensource project developed in UTN-FRBA by Ramiro Fontalva.
## Run demo
```python
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)
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")
```
Raw data
{
"_id": null,
"home_page": "https://github.com/rfontalva",
"name": "headmouse",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "headmouse,HeadMouse,Headmouse,augmentative,image processing,mouse",
"author": "Ramiro Fontalva",
"author_email": "ramirofontalva@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/05/b5/bb59b29833c42ece0130e0aed5722ed9c045931349f95cccd1d871595820/headmouse-1.1.0.tar.gz",
"platform": null,
"description": "# Headmouse\n\nThe HeadMouse module provides an interface by opening the web camera anddetecting the user's face to control the mouse by tilting the head,\n using the tip of the nose as reference point.\nIt can also be customized to trigger different functions instead of a mouse click when the user winks.\nTo use the module it\\'s necessary to have the file shape_predictor_68_face_landmarks.dat.\n\nCompressed:\n<http://dlib.net/files/shape_predictor_68_face_landmarks.dat.bz2>\n\nUncompressed:\n<https://github.com/rfontalva/dlib_shape_predictor_68_face_landmarks/tree/master>'\n\n## Features\n\nSingle user (closest one) detection.\nDetection of right and left eyes' wink.\nDetection of mouth's right corner movement.\nImproved nose threshold to avoid unvoluntary movement.\n\nAn opensource project developed in UTN-FRBA by Ramiro Fontalva.\n\n## Run demo\n\n```python\nfrom headmouse import Headmouse\nimport cv2\n\nif __name__ == \"__main__\":\n predictor_path = \"/path/to/shape_predictor_68_face_landmarks.dat\"\n h = Headmouse(predictor_path=predictor_path)\n while True:\n h.refresh()\n h.show_image()\n key = cv2.waitKey(1)\n if key == 27: #press escape\n h.destroy_window()\n h.quit()\n break\n if key == 32: #press spacebar\n h.calibrate()\n print(\"calibrated\")\n```\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "An augmentative tool to use the mouse with the movement of the head.",
"version": "1.1.0",
"split_keywords": [
"headmouse",
"headmouse",
"headmouse",
"augmentative",
"image processing",
"mouse"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "05b5bb59b29833c42ece0130e0aed5722ed9c045931349f95cccd1d871595820",
"md5": "9a156101f40986219c0320092528391e",
"sha256": "f8df9cfd192700c0a0628685915319a80e25ee5ebd2088429afa3f086f18fa94"
},
"downloads": -1,
"filename": "headmouse-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "9a156101f40986219c0320092528391e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7693,
"upload_time": "2023-01-16T02:28:12",
"upload_time_iso_8601": "2023-01-16T02:28:12.748987Z",
"url": "https://files.pythonhosted.org/packages/05/b5/bb59b29833c42ece0130e0aed5722ed9c045931349f95cccd1d871595820/headmouse-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-16 02:28:12",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "headmouse"
}