Quick Start
How Does HoopPop Work?
HoopPop uses cutting-edge AI technology to analyze your shooting form in real-time through your iPhone camera. We combine YOLO object detection to identify the basketball and hoop, along with Apple's Vision framework for human body pose estimation, to precisely track every shot you take and automatically record makes and misses.
Step 1: Grant Camera Access
When you first open the app, allow HoopPop to access your camera. This is essential for AI analysis.
Step 2: Position Your Phone
Place your phone in a stable position where it can capture both you and the hoop.
Step 3: Start Training
Tap the record button to begin your workout. The AI will automatically detect and track your shots.
Camera Setup Guide
Optimal Camera Angle Diagram
📍 Phone Placement
Position your phone on the side of the court at a 45-90 degree angle to the basket. We recommend using a tripod or propping it against a stable object at about 3-5 feet height to ensure a steady frame.
📐 Recording Distance
Place your phone approximately 10-15 feet from your shooting spot. Make sure the frame captures your entire body, the ball trajectory, and the hoop clearly.
Pro Tip
Using landscape orientation gives you a wider field of view, making it easier to capture both you and the hoop. Train in well-lit environments and avoid backlighting for best results.
Start Training
Tap to Start
Press the red record button to begin your session
AI Real-Time Tracking
Automatic body pose and basketball detection
Auto Statistics
Every shot is automatically tracked and recorded
Save & Finish
Tap stop to save your workout data locally
🎯 How Shot Detection Works
When the AI detects you completing a shooting motion (arm extension and ball release), the system tracks the ball trajectory. If the ball passes through the hoop area and meets the scoring criteria, it's recorded as a make. All data is displayed in real-time on your screen.
Stats & Analytics
📊 Workout Data
After each session, you can view detailed statistics including total shots attempted, makes, field goal percentage, and workout duration. All data is securely stored on your device using Apple's SwiftData framework.
📈 History & Trends
Access all your past workouts in the History tab. Filter and sort by date, shooting percentage, and more to track your progress over time and identify areas for improvement.
🏀 Shot-by-Shot Details
Tap on any workout to see detailed information about each individual shot, including timestamps and make/miss status, helping you analyze patterns in your performance.
Best Practices
💡 Lighting Conditions
Choose a well-lit environment with even lighting. Avoid harsh direct sunlight or backlighting, as these can affect AI detection accuracy. Indoor courts with artificial lighting typically work best.
👕 What to Wear
Wear clothing that contrasts with the background and avoid overly loose garments. This helps the AI more accurately identify your body pose and track your movements.
🔋 Battery & Storage
Real-time AI analysis consumes significant battery power. Make sure your phone is charged to at least 50% before training, and ensure you have adequate storage space available.
📱 Phone Stability
Use a tripod or phone mount to ensure a stable frame. Shaky footage will significantly impact detection accuracy. If you don't have a mount, prop your phone against a water bottle or other stable object.