FaceCue is designed to provide an engaging, innovative gaming experience that combines real-time face tracking technology with reaction-based gameplay.

Introducing Genius Plus; the next-gen music companion that intelligently analyzes your music library on-device and builds cohesive flowing playlists and radio stations, all while keeping your data private.

Features:

• Library import & caching

  • Imports local Apple Music/iTunes library

  • Extracts metadata (title, artist, album, genre, duration) and optional ID3 BPM/key

  • Resolves local playable URLs when available

  • Persists the imported library to Application Support as JSON (fast startup)

  • Automatic invalidation and refresh

• On device audio analysis

  • BPM detection with beat time estimation

  • Chroma and musical key detection using Krumhansl profiles

  • Spectral centroid and RMS energy computation

  • Beat synchronous chroma aggregation (multi window averaging per beat)

  • L2 normalized 14 D vectors (12 chroma + centroid + RMS)

• Feature engineering

  • Per dimension weighting for chroma, BPM/centroid, RMS, and optional metadata

  • Configurable multi window averaging for centroid/RMS

  • Optional metadata embedding (artist/genre hash, BPM/duration normalization) with re normalization

• Vector optimization

  • L2 normalization for all vectors

  • Optional PCA (mock first components slicing, configurable target dimension)

  • Optional quantization (4 8 bits) persisted alongside doubles

  • Dequantization at query for memory efficient similarity

• Similarity & indexing

  • Weighted cosine similarity for in memory comparisons

  • HNSW style ANN index with:

    • Configurable max neighbors per node, max levels

    • Multiple entry points for robust search starts

    • Priority queue bottom layer search

    • JSON persistence with versioning

  • Lazy disk similarity index (keys only) with on demand vector loading

  • Incremental disk ANN for scalable approximate search (JSON with versioning)

• Resilience & performance

  • Retry wrappers for feature extraction

  • Cancellable batch processing with concurrency and rate limiting

  • Atomic, thread safe cache writes; expiry and cleanup

  • Progress reporting during analysis

• UI & UX

  • Library browser with filtering (artist/genre/BPM/key)

  • Track details show BPM, key, genre, and derived features

  • One tap Genius playlist from any track

  • Genius Plus Radio: continuous play seeded from any track

  • Settings screen with live bindings to analysis/similarity behavior

    • Automatic settings sync

    • Manual "Apply Settings" button with change tracking (disabled when no changes detected)

    • Visual confirmation alert when settings are applied

    • All settings sync in real-time as you adjust them

  • Premium gating: Analyze, Genius playlist, and Radio require active trial or purchase; non premium prompts paywall

  • On-boarding is not dismissed until continuing or starting the free trial (prevents bypassing trial)

• Background & widgets

  • Background audio playback configured

  • Live Activity (Lock Screen / Dynamic Island) shows title/artist/progress and status

  • Home Screen widget displays Now Playing from App Group and deep links to resume

  • Deep link resumes playback and navigates to Radio

• Privacy

  • All analysis and ANN computations are performed on device

  • No external analytics or tracking