ThirdEye

Smartphone-based driving safety assistant. Two modes: Road (hazard detection) and Driver (attention monitoring). Optional Demo mode uses a video file when camera isn't available (e.g. simulator). See PROJECT_SPEC.MD for full specification.

How to run

Option 1: Xcode (recommended)

1. Open the project

   open ThirdEye.xcodeproj

2. Select a run destination
   In Xcode’s toolbar, choose an iPhone Simulator (e.g. iPhone 16) or a connected iOS device.

3. Build and run
   Press ⌘R or click the Run button.

Option 2: Command line

From the repo root:

1. Build for simulator (replace with a simulator name from xcrun simctl list devices if needed):

   xcodebuild -project ThirdEye.xcodeproj -scheme ThirdEye \
     -destination 'platform=iOS Simulator,name=iPhone 16' \
     -configuration Debug build

2. Run on simulator (after building):

   xcrun simctl boot "iPhone 16" 2>/dev/null || true
   xcrun simctl install booted build/Debug-iphonesimulator/ThirdEye.app
   xcrun simctl launch booted com.hackbrown.ThirdEye

Or from the ThirdEye directory:

• open ThirdEye.xcodeproj — open in Xcode
• Then use ⌘R in Xcode to run.

Requirements

• macOS with Xcode (iOS 15+)
• iOS Simulator or a physical iPhone/iPad for running the app

Project layout

• Alerts/ — TTS and alert handling
• App/ — SwiftUI views and view model
• Camera/ — Live camera and video file input
• Driver/ — Driver attention / Presage integration
• HUD/ — Overlay UI
• Road/ — Object detection and road heuristics