Loading repository data…
Loading repository data…
rsamwilson2323-cloud / repository
🧩 Gesture-based game developer passionate about Computer Vision, AI, and Python. Building interactive projects with OpenCV, MediaPipe, and CVZone to create touch-free experiences. Exploring AI, Machine Learning, and Human-Computer Interaction through innovative real-time applications.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
Solve a Jigsaw Puzzle Using Only Your Hands
🖐️ Hand Tracking • 🎮 Gesture Controls • 📷 Webcam-Based • 🧩 Interactive Puzzle
Virtual Puzzle with Hand Gesture Controls is a Python-based computer vision project that allows users to solve a 4×4 jigsaw puzzle using real-time hand gestures detected through a webcam. Powered by OpenCV, MediaPipe, and CVZone, the game offers an intuitive touch-free experience where puzzle pieces are picked up and swapped using simple pinch gestures.
This project is ideal for learning Computer Vision, Hand Tracking, Human-Computer Interaction, and Gesture-Based Gaming with Python.
🖐️ Real-Time Hand Tracking Detects and tracks both hands using MediaPipe and CVZone.
🤏 Pinch Gesture Controls Use thumb and index finger pinches to interact with the puzzle.
🧩 Interactive 4×4 Puzzle Automatically slices an image into 16 pieces and shuffles them.
📦 Custom Puzzle Area Create your own puzzle box by selecting the top-left and bottom-right corners with your hands.
🔄 Piece Swapping Drag puzzle pieces to swap their positions with other pieces.
✅ Solved Piece Highlight Correctly placed pieces are highlighted with a green border.
🎨 Custom Puzzle Image Place your own puzzle.jpg file in the project folder to use a custom image.
Virtual-puzzle-with-hand-gesture-controls
│
├── puzzle_game.py
├── requirements.txt
├── README.md
├── LICENSE
└── puzzle.jpg (Optional)
git clone https://github.com/rsamwilson2323-cloud/Virtual-puzzle-with-hand-gesture-controls.git
cd Virtual-puzzle-with-hand-gesture-controls
pip install -r requirements.txt
Or install manually:
pip install opencv-python cvzone mediapipe numpy Pillow
Run the game using:
python puzzle_game.py
Allow access to your webcam when prompted.
If puzzle.jpg is not found, the game automatically generates a colorful placeholder puzzle.
✋ Left Hand Pinch Sets the Top-Left Corner of the puzzle.
🤚 Right Hand Pinch Sets the Bottom-Right Corner.
📦 Hold both pinches together to preview the puzzle area.
✅ Release both pinches to generate the puzzle.
🤏 Pinch over a puzzle piece to grab it.
🖐️ Drag the piece to another grid position.
🔄 Release to swap pieces.
🟩 Correctly placed pieces are highlighted in green.
🏆 Arrange all pieces correctly to complete the puzzle.
| Key | Action |
|---|---|
| ENTER | Quit the game |
| SPACE | Reset the puzzle |
To use your own image:
puzzle.jpg
The game will automatically slice it into a 4×4 puzzle.
Contributions are welcome and appreciated.
Steps to contribute:
💡 OpenCV Community
🖐️ Google MediaPipe Team
🚀 CVZone Library
🐍 Python Community
If you like this project:
⭐ Star the repository
🍴 Fork it
💬 Share your feedback
Sam Wilson
🌐 GitHub
This project is licensed under the MIT License.