Skip to content

A simple three js file which does handtracking and displays images

Notifications You must be signed in to change notification settings

Shreyas-S-809/palm-testing

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 

Repository files navigation

🚀 palm-testing

GitHub stars](https://github.com/Shreyas-S-809/palm-testing/stargazers) GitHub forks GitHub issues GitHub license

Real-time Hand Tracking with Three.js for Interactive Image Display

📖 Overview

This project is a simple, client-side web application that demonstrates real-time hand tracking and integrates it with a 3D scene rendered using Three.js. It captures live video from the user's webcam, detects hand movements and gestures using a computer vision library, and then uses this input to interactively display and manipulate images within a dynamic 3D environment. This creates an engaging and hands-free interactive experience directly in the browser.

✨ Features

  • 🎯 Real-time Hand Tracking: Detects and tracks human hand landmarks and gestures from a live webcam feed.
  • 🖼️ 3D Image Display: Renders images within a Three.js 3D scene, allowing for dynamic visual feedback.
  • 🖐️ Gesture-Controlled Interaction: Images and 3D elements can respond to specific hand movements or positions.
  • 📹 Webcam Integration: Seamlessly accesses and processes video input from the user's default webcam.
  • 🌐 Pure Client-Side: Runs entirely in the browser without requiring any server-side components.

🖥️ Screenshots

Screenshot 1 Screenshot 2

🛠️ Tech Stack

Frontend: HTML5 CSS3 JavaScript Three.js MediaPipe

🚀 Quick Start

This project is designed to run directly in your web browser.

Prerequisites

  • A modern web browser (e.g., Google Chrome, Mozilla Firefox, Microsoft Edge)
  • A working webcam connected to your device.

Installation

  1. Clone the repository

    git clone https://github.com/Shreyas-S-809/palm-testing.git
    cd palm-testing
  2. Open in your browser Simply open the index.html file in your preferred web browser.

    # On macOS
    open index.html
    
    # On Windows
    start index.html
    
    # On Linux
    xdg-open index.html

    Alternatively, for development and to avoid potential browser security restrictions with local file access (especially for webcam), you can use a simple local HTTP server (e.g., live-server from npm):

    # If you have Node.js and npm/yarn/pnpm installed
    npm install -g live-server
    live-server

    This will typically open the application at http://127.0.0.1:8080 or http://localhost:8080.

📁 Project Structure

palm-testing/
├── index.html       # Main application file containing all HTML, CSS, and JavaScript logic.
└── README.md        # Project overview and documentation.

Check it out Live

🙏 Acknowledgments

  • Three.js: For the powerful 3D rendering capabilities.
  • MediaPipe Hands: For enabling robust real-time hand tracking.

📞 Support & Contact


⭐ Star this repo if you find it helpful!

Made with ❤️ by Shreyas-S-809

About

A simple three js file which does handtracking and displays images

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages