# movement-tracking

**Repository Path**: mirrors_trending/movement-tracking

## Basic Information

- **Project Name**: movement-tracking
- **Description**: UP - DOWN - LEFT  - RIGHT movement tracking.
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-04
- **Last Updated**: 2026-02-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Realtime Face Movement Tracking ![](https://bit.ly/surya-veer-movement-tracking)
90 Lines of code to convert your face movement into keyboard commands.

# Description
This is a basic face movement tracking that can convert face movement into keyboard commands like **UP - DOWN - LEFT  - RIGHT**. I used facial landmarks to detect face and get the nose out of it for better referencing. I have created two versions of it, v1 is using a fixed reference boundary which not work expected properly because we need to come at the same position after each movement. To save this I created V2 which uses position change with respect to the previous position. This is more dynamic and easy to control the moves. No need to set position again and again.

## movement-v1.py
In version1, I used a fixed reference boundary. If nose reference is out of boundary then I calculate the direction of movement. After getting direction I am converting it into keyboard commands using the keyboard library.

## movement-v2.py
In version2, I am using reference change with respect to the previous position in a particular time window and then calculating the direction vector to get direction and converting it to keyboard command.

## Dependencies
This is the list of dependencies for running this application. Use pip to install them.
 * **opencv**
 * **keyboard**

 ```
 $ pip install -r requirements.txt
 ```

## How to use
1. Download or clone this repository.
2. Extract to some location.
3. First, run **```movement-v1.py```** (for fix boundary) or run **```movement-v2.py```**(for dynamic movement) <br>
  NOTE: If you are getting 215 assertion failed!! on line 81 check this (https://github.com/surya-veer/movement-tracking/issues/4#issuecomment-664018021)

4. open any online atari game like Subway surfers or temple run.
5. Start doing movements to play game. It will press up-down-left-right based on your movements.

# Fun with face movements
Open any online game on the browser which needs UP-DOWN-LEFT-RIGHT movements following games, you can find many games if you search on google.
1. Subway surfer https://www.kiloo.com/subway-surfers/
2. Temple run https://m.plonga.com/adventure/Temple-Run-2-Online-Tablet

### You can do a lot more things by the small code change.

### ** SUPPORT OPEN SOURCE **