# NeuroFlow User Guide

Welcome to **NeuroFlow**, the intelligent focus-tracking desktop application designed to help you stay productive and mindful during your work sessions!

## Getting Started

1. **Launch the Application**
   Open NeuroFlow. You will be greeted by the stunning glassmorphic **Login Screen**.

2. **Select Your Profile**
   Choose a profile that matches your work style:
   - **Student**: Balanced monitoring for study sessions.
   - **Developer**: Stricter tracking tailored for intense coding.
   - **Normal User**: General tracking for everyday tasks.

3. **Set Session Duration**
   Select how long you plan to work (e.g., 30 Minutes, 60 Minutes, 90 Minutes, or Unlimited).

4. **Start Session & Permissions**
   Click the **Start Session** button.
   NeuroFlow will ask for permission to use your camera for advanced facial tracking.
   - **Allow**: Enables the full suite of features including Eye Aspect Ratio (EAR) tracking, phone detection, and facial mesh monitoring.
   - **Deny (Lite Mode)**: Falls back to a privacy-focused mode that tracks only mouse and browser activity without accessing your camera.

## The Floating Orb UI

Once your session starts, the main application window will minimize into a minimalist, non-intrusive **50px Floating Orb** that stays on top of your other windows.

- **Color Indicators**:
  - 🟢 **Green**: Focus State. You are doing great!
  - 🔴 **Red**: Distracted State. Triggered if you look away for too long or pick up your phone.
  - 🔵 **Blue**: Relaxed State (Privacy Mode). Triggered during breaks or inactivity.
  - 🟣 **Purple**: Puzzled State. Indicates mental blocks or confusion.
- **Interacting with the Orb**:
  - **Drag**: Click and drag the orb to move it anywhere on your screen.
  - **Single Click**: Opens the **Professional Dashboard**.
  - **Double Click**: Manually triggers the "Puzzled" state to log a mental block.

## The Professional Dashboard

When you click the orb, the dashboard will open. This is your command center for tracking your session in real-time.

- **Live Mesh Feed**: If camera permission was granted, this shows a live feed of your face with 468 tracked facial landmarks.
- **User Details**: Displays your current profile, active tracking duration, and a real-time **Focus Score**.
- **Progress Graph**: Visualizes your focus levels over time, helping you identify when you are most productive.
- **Minimize**: Click "Minimize to Orb" to return to the unobtrusive floating orb.

## Key Features Under the Hood

- **Real-Time Interventions**: If you become distracted, the built-in AI (using Piper TTS) will deliver personalized, non-repetitive vocal nudges to get you back on track.
- **Digital Radar**: Monitors active window titles to see if you're on productive apps or distracting websites.
- **Global Cursor Tracking**: Detects when you are stuck or idle based on mouse inactivity.
- **Privacy First**: Choose Lite Mode at startup if you prefer not to use the camera, or naturally transition into a "Relaxed" state during breaks.
- **Session Logging**: Everything is securely logged locally on your machine, ensuring your data never leaves your computer.

---
Enjoy your hyper-focused sessions with NeuroFlow!