gitwtfhub

wtf is motion-fighter-control?

narcissus29/motion-fighter-control — explained in plain English

Analysis updated 2026-05-18

2PythonAudience · generalComplexity · 2/5LicenseSetup · moderate

TL;DR

A webcam tool that lets you control keyboard games with hand gestures, like fists for punches and open palms for kicks.

Mindmap

mindmap
  root((motion-fighter-control))
    What it does
      Hand gesture tracking
      Webcam input
      Sends key presses
    Tech stack
      Python
      MediaPipe
      pydirectinput
    Use cases
      Play TEKKEN 7
      Control any keyboard game
      Use phone as webcam
    Audience
      Gamers
      Hobbyist tinkerers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Play a fighting game like TEKKEN 7 using hand gestures instead of a keyboard

REASON 2

Remap gesture to key bindings to control any other keyboard controlled game

REASON 3

Use a phone running a webcam app as the camera source for gesture tracking

What's in the stack?

PythonMediaPipepydirectinputpynput

How it stacks up

narcissus29/motion-fighter-control0-bingwu-0/live-interpreter0cm-labs/tokenizer-benchmark
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity2/52/52/5
Audiencegeneralgeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Needs a webcam and Python 3.9+, the camera overlay only works over windowed or borderless games.

Free to use, modify, and share for any purpose under the MIT license.

Wtf does this do

This project lets you play keyboard controlled games using hand gestures captured by your webcam, instead of a physical controller or keyboard. It watches your hands through a camera using a hand tracking library called MediaPipe, then turns specific gestures into key presses. Making a fist with your left hand sends a left punch key, a fist with your right hand sends a right punch key, an open palm on either hand sends a kick key on that side, and moving both hands to the left or right sends direction keys for dashing or moving that way. The tool comes preconfigured for the fighting game TEKKEN 7, but the gesture to key mapping is stored in a simple JSON configuration file, so you can point it at any game that accepts keyboard input, not just fighting games. You install it with Python 3.9 or newer and a short pip install command, then run one script, or double click a Windows batch file to start it. A small camera window floats on top of your game window and shows your hands along with the gestures it detects, so you can see what the program is reading in real time. Setup includes automatic camera detection: if you have one webcam it is selected for you, and if you have several you get a list to choose from. This also works with phone camera apps used as webcams, such as Camo or DroidCam. Key sending starts disabled by default and only turns on after a short countdown, or when you press a key to arm it manually, which is meant as a safety measure so nothing gets typed before you are ready. You can remap which keys correspond to which gestures, adjust gesture sensitivity thresholds, and toggle features like double tap dashing for non fighting games. The camera overlay window only sits on top of games running in borderless or windowed display mode, not exclusive fullscreen. The project is released under the MIT license, meaning it is free to use, modify, and share.

Yoink these prompts

Prompt 1
Walk me through installing Python 3.9 and the requirements for motion-fighter-control so I can run gesture_control.py
Prompt 2
Help me write a config.json for motion-fighter-control that maps hand gestures to the keys my game uses
Prompt 3
Explain how the fist and open palm gesture thresholds work in this project's config so I can tune them
Prompt 4
Show me how hand_energy.py's MediaPipe hand tracker tells apart a fist from an open palm gesture

Frequently asked questions

wtf is motion-fighter-control?

A webcam tool that lets you control keyboard games with hand gestures, like fists for punches and open palms for kicks.

What language is motion-fighter-control written in?

Mainly Python. The stack also includes Python, MediaPipe, pydirectinput.

What license does motion-fighter-control use?

Free to use, modify, and share for any purpose under the MIT license.

How hard is motion-fighter-control to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is motion-fighter-control for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.