{"id":28762205,"url":"https://github.com/epicboi-deepubhai/fingercommander","last_synced_at":"2026-05-15T18:08:21.128Z","repository":{"id":298658744,"uuid":"1000670892","full_name":"epicboi-deepubhai/FingerCommander","owner":"epicboi-deepubhai","description":"A Linux utility that uses your webcam to recognize hand gestures and run system commands like opening VS Code, locking the screen, or shutting down — all controlled by your fingers.","archived":false,"fork":false,"pushed_at":"2025-06-12T06:58:23.000Z","size":4,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-12T07:45:03.848Z","etag":null,"topics":["gesture","gesture-recognition","mediapipe","opencv-python","shortcut"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/epicboi-deepubhai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-12T06:34:47.000Z","updated_at":"2025-06-12T06:58:26.000Z","dependencies_parsed_at":"2025-06-12T07:45:08.924Z","dependency_job_id":"9ed53b48-71d4-4488-ae17-0eb97c41aa42","html_url":"https://github.com/epicboi-deepubhai/FingerCommander","commit_stats":null,"previous_names":["epicboi-deepubhai/fingercommander"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/epicboi-deepubhai/FingerCommander","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epicboi-deepubhai%2FFingerCommander","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epicboi-deepubhai%2FFingerCommander/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epicboi-deepubhai%2FFingerCommander/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epicboi-deepubhai%2FFingerCommander/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/epicboi-deepubhai","download_url":"https://codeload.github.com/epicboi-deepubhai/FingerCommander/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epicboi-deepubhai%2FFingerCommander/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260318706,"owners_count":22991120,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gesture","gesture-recognition","mediapipe","opencv-python","shortcut"],"created_at":"2025-06-17T08:07:27.918Z","updated_at":"2026-05-15T18:08:21.098Z","avatar_url":"https://github.com/epicboi-deepubhai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FingerCommander\n\nA Linux utility that uses your webcam to recognize hand gestures and run system commands like opening VS Code, locking the screen, or shutting down — all controlled by your fingers.\n\nPowered by **OpenCV** + **MediaPipe**\n\n\n## 📽️ How It Works\n\nThis app captures live webcam footage, detects your hand using MediaPipe, and matches the finger positions to predefined gestures. If a gesture matches, a mapped system command is executed (with a cooldown to avoid rapid repeats).\n\n##  Setup Instructions\n\nMake sure Python 3 is installed (optionally create a venv), then run:\n\n```bash\npip install opencv-python mediapipe\n```\n\n\n### 2. Project Structure\n\n```\nFingerCommander/\n│\n├── gestures.py              # Contains gesture-command mappings\n├── gesture_control.py       # Main script \n├── venv/                    # (optional) your virtual environment\n└── README.md\n```\n\n### Define Your Gestures\n\nEdit the `gestures.py` file like so:\n\n```python\nGESTURE_COMMANDS = {\n    \"peace\": (\"code\", [0, 1, 1, 0, 0]),  # VS Code\n    \"middle\": (\"shutdown now\", [0, 0, 1, 0, 0]),  # Shutdown\n    \"pinky\": (\"gnome-screensaver-command -l\", [0, 0, 0, 0, 1])  # Lock screen\n}\n```\n\nEach entry is a tuple of:\n\n* Shell command to execute\n* Finger pattern list: `[thumb, index, middle, ring, pinky]`\n  (`1` for raised, `0` for folded)\n\n###  Run the App\n\nIf you’re using a virtual environment:\n\n```bash\nsource venv/bin/activate\npython gesture_control.py\n```\n\nQuit the app by pressing `q`.\n\n\n## Optional Custom Command Alias\n\nCreate a quick command (`camsequence`) to launch it:\n\n```bash\nalias camsequence='cd \u003cproject-dir\u003e \u0026\u0026 source venv/bin/activate \u0026\u0026 python gesture_control.py'\n```\n\nThen just type `camsequence` in your terminal.\n\n\n\n## 👨‍💻 Author\n\nDeveloped by [epicboi-deepubhai](https://github.com/epicboi-deepubhai)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fepicboi-deepubhai%2Ffingercommander","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fepicboi-deepubhai%2Ffingercommander","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fepicboi-deepubhai%2Ffingercommander/lists"}