Help & User Guide

Getting Started

  1. Upload Your Target Image: Click "Analyze Your Shots" and select a clear photo of your target
  2. Set Your Parameters: Enter the distance to target and select your firearm type
  3. Begin Analysis: Use the mode buttons to mark aim points and shots

Analysis Modes

📍 Set Aim Points Mode

Click on your target to mark where you were aiming. You can:

  • Double-click to create new aim points
  • Drag existing aim points to reposition them
  • Click the × button to delete aim points

🎯 Mark Shots Mode

Click on bullet holes to mark your shots. Features:

  • Double-click to create new shot markers
  • Drag shots to adjust their position
  • Delete shots with the × button
  • Shots are automatically assigned to the nearest aim point

📏 Set Reference Line Mode

Draw a reference line for accurate measurements:

  • Click and drag to draw a line across a known distance
  • Enter the real-world length in the Reference Length field
  • Click "Set" to apply the reference for calculations

Tips for Best Results

  • Image Quality: Use clear, high-resolution photos
  • Camera Angle: Take photos straight-on, not at an angle
  • Lighting: Ensure good lighting with minimal shadows
  • Reference Lines: Use target borders or known measurements for scaling
  • Precision: Zoom in for more accurate marking of small details

Understanding Your Results

Key Metrics

  • Avg Distance from Aim Point: Average distance from shots to their nearest aim point
  • Mean Group Radius: Average distance from the center of all shots to individual shots
  • Group Size: Diameter of the circle containing all shots in a group
  • Standard Deviation: Measure of shot consistency and precision

Saving and Loading Sessions

  • Save Locally: Save your analysis to browser storage for quick access later
  • Load Previous Sessions: Click "Analyses" in the menu to view and load saved sessions
  • Save Status Indicator: Track whether your work is saved with the status indicator
  • Export as File: Download your session as a .shottracker.json file for backup
  • Export as PDF: Generate a detailed PDF report with image and analysis
  • Upload Saved File: Click to select .shottracker.json files from previous sessions
  • Session Data: Add date and notes to document your shooting sessions
  • Auto-Compression: Large images are automatically compressed when saving locally

Session Management

  • Save Status: The indicator shows if your work is saved, unsaved, or has pending changes
  • Overwrite Protection: When you load and modify a session, saving will update the same session
  • Session List: View all saved sessions sorted by date, with search functionality
  • Storage Limits: Browser storage has limits; export important sessions as files for backup
  • Session Names: Sessions are automatically named with date and basic info

Controls & Navigation

  • Desktop:
    • Zoom: Use +/- buttons or mouse wheel
    • Pan: Click and drag in viewing mode
  • Mobile:
    • Navigate: Use Previous/Next buttons to move between steps
    • Zoom: Pinch to zoom on touch devices
    • Pan: Touch and drag to move around
  • Menu System:
    • Home: Return to landing page
    • Analyses: View and load saved sessions
    • Help: Access this help guide
  • Toggle Visibility: Use checkboxes to show/hide different elements
  • Reset View: Click "Reset" to return to original zoom level
  • Start Over: Clear all data and return to the beginning

Privacy & Security

Shot Tracker Pro processes images locally in your browser and calculations happen on your computer. We collect tracking and data metrics for analysis and improving the product.

System Requirements

  • Device Support: Works on desktop, tablet, and mobile devices
  • Browser: Modern web browser with JavaScript enabled
  • File Types: JPG, PNG, and other common image formats
  • Mobile: Optimized for touch screens with mobile-specific interface

Troubleshooting

Common Issues

  • Image won't load: Check file format and size, try a different image
  • Measurements seem wrong: Verify your reference line length is correct
  • Can't place markers: Make sure you're in the correct mode (aim points or shots)
  • App not responding: Refresh the page and try again