mmd-danz is a dancing game that requires players to mirror dance moves as they appear on the screen in real-time while watching themselves in a webcam preview. The game is written in Python and uses the OpenCV and Mediapipe libraries for image processing, and ffpyplayer for audio playback.
Click the image below for the demo:
To run mmd-danz, you need to have Python 3.x installed on your computer. Clone the project repository and navigate to the project directory:
git clone git@github.com:MuhammadAgf/mmd-danz.git
cd mmd-danzThen, install the required packages by running the following command:
pip install -r requirements.txtTo start the game, run the following command:
python main.py [--data-path DATA_PATH] [--cam-host CAM_URL]The command-line arguments are:
--cam-host: URL of the webcam feed or 0 for default camera.--data-path: path to the directory of the video file to be played.
For example, to start the game using a video file inside data/rolling girl, run the following command:
python main.py --data-path "./data/rolling girl/" --cam-host http://<URL>/camera/mjpegDuring the game, the player will see themselves in real-time in the webcam preview, and a series of dance moves that must be mirrored to earn points. The player's score, time elapsed, and current frame number are displayed in the top left corner of the screen.
Link to the original video that is used as the sample above: here.
for a data path to be valid as the directory to play the game, it needs 3 files inside it:
video.mp4the video file to be played.frame_dictionary.picklepreviously generated pickle file with processed video (video.mp4) frames.cues.picklepreviously generated pickle file with cues for the video.
use preprocess.py to generate the frame_dictionary.pickle and cues.pickle
python preprocess.py [--data-path DATA_PATH] [--fps FPS]If you find a bug or would like to contribute to the project, please create a pull request or an issue on the GitHub repository.