CounterZap iPhone Guide

Welcome to CounterZap

CounterZap is an iOS-first scouting tool that recognizes football managers in photos, assesses their tactics, and keeps your counter-strategy library in sync with the latest matches. This guide covers what the app does and how to get the most out of it on your iPhone.

What CounterZap Does

  • Manager Recognition: Uses Vision face-detection (and Vision embeddings on iOS 13+) to match a face inside the top-left region of a photo with a curated library of manager portraits.
  • Fast Startup: Reference vectors are cached to Library/Caches/manager_refs.json so repeated launches skip redundant computation.
  • Flexible Thresholding: Adjust the similarity threshold (0.80 default) to make detection more or less permissive.
  • Batch Processing: Drop a folder of images into the detector and export results to CSV for larger analysis.
  • Embedded Demo UI: ExampleViewController shows detection results and allows cache refresh for testing.

Preparing Your iPhone

  1. Install CounterZap from the App Store and complete onboarding.
  2. Grant camera and photo access to enable image capture and import.
  3. Configure Reference Images: Add or update portraits inside the bundle folder (Fotos managers png), naming each file with the manager’s display name.
  4. Start with the Demo Image: A sample asset named test_input is preloaded for verification.

Using CounterZap on iPhone

  1. Capture or Choose a Photo: Tap the camera button or import from your photo library. Make sure the manager’s face is mostly in the top-left third.
  2. Run Detection: Tap “Run Detection.” The app compares embeddings and updates the label with the matched name or “No manager detected.”
  3. Check Embedding Mode: The app displays whether Vision embeddings or pixel vectors are active.
  4. Recompute References: Tap “Recompute References” if you add new portraits or modify the reference set.

Tips for Reliable Detection

  • Keep managers centered in the top-left for optimal results.
  • Use consistent lighting and neutral backgrounds for reference images.
  • Lower the threshold slightly if reference data is limited.

Troubleshooting

  • No manager detected: Ensure the reference name matches and the face is clearly visible in the target zone.
  • Slow detection: First-time caching can delay startup; allow it to finish recomputing or refresh through ExampleViewController.
  • Vision embeddings unavailable: Older iPhones use pixel vectors instead; the status label shows your current mode.