Hair Pulling Detector

An application that uses your webcam to detect and alert you when you're pulling your hair, helping you be mindful of this behavior.

Features

• Real-time pose detection using TensorFlow.js
• Choice of five previewable alert sounds when hair pulling is detected
• Visual feedback with detection area and distances
• Runs in the background with minimal UI

Development

1. Install dependencies:

npm install

2. Start the development version:

npm start

Building

1. Build the application:

# For development build
npm run pack

# For production build
npm run dist

The packaged application will be in the dist folder.

Offline verification

TensorFlow.js, pose detection, and MoveNet SinglePose Lightning v4 are packaged under assets/. assets/asset-manifest.json records the pinned versions, upstream model source, sizes, and SHA-256 checksums.

npm test
npm run pack
npm run verify:package

# macOS: launches the packaged app with public DNS disabled
npm run smoke:package

Usage

1. Launch the application
2. Grant camera permissions when prompted
3. The app will monitor your hand movements
4. Choose and preview an alert sound from the controls
5. The app plays your selected sound if hair pulling is detected

System Requirements

• macOS 10.13 or later
• Webcam
• System notifications enabled