Martial Arts Analyser

Data Storage

Clip Structure

Each clip is stored as a folder:

Clips/
└── 2026-01-15T14-30-00/
    ├── video_2026-01-15T14-30-00.mov    # Video file
    ├── notes_2026-01-15T14-30-00.txt    # Annotations
    └── clip_info.json                   # Metadata

Location: ~/Documents/Clips/

Annotations Format

Annotations are plain text with optional timestamps and tags:

# Clip Name

[00:05] Opening stance #basics
[00:12.5] First combination #jab #cross
[1:01:25] Footwork drill

Notes:
- Good form on technique
- Need to work on speed

Configuration

You can modify constants in Core/Constants.swift:

enum AppConstants {
    enum Camera {
        static let continuityDiscoveryIntervalSeconds: TimeInterval = 10.0
        static let sessionRestartDelaySeconds: TimeInterval = 2.0
    }
    
    enum Recording {
        static let timerIntervalSeconds: TimeInterval = 0.1
    }
}

Continuity Camera Setup

To use your iPhone as a camera:

1. Same Apple ID - Both Mac and iPhone signed into same Apple ID
2. WiFi + Bluetooth - Both devices have WiFi and Bluetooth enabled
3. Nearby - Keep iPhone within wireless range of Mac
4. Unlocked - iPhone should be unlocked
5. Auto-Discovery - App checks for Continuity Camera every 10 seconds

The app will show "🎉 Continuity Camera appeared!" when your iPhone is detected.

Keyboard Shortcuts

Video Playback

• Space - Play/Pause
• ← - Step backward 1 frame (paused) / Skip back 5s (playing)
• → - Step forward 1 frame (paused) / Skip forward 5s (playing)

Project Structure

Generally speaking, add new interface features into their own subfolder of Features/, with separate folders for models, views, controllers, utilities, etc.