> For the complete documentation index, see [llms.txt](https://docs.shootxp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shootxp.com/platform-release-notes.md).

# Platform Release Notes

## Version 2.0.0 (2025.08.11)  🚀🚀

Features & Functionality:

* Shot Tagger (new)
  * intended for live tagging of shots during a game, practice session etc
  * accessible by any ShootXP user, with minimalist UI specifically designed for use on phones and tablets
  * tagged shots include timecode and result (make/miss)
  * live display of total makes, attempts and shooting percentage
  * export/save as a CSV file
  * import CSV file once video of game/session is added to ShootXP Video Library
* Channels (new)
  * create channels and optionally assign members (users) to make them "private"
  * videos can be categorised into one or multiple channels
* Activities & Constraints (major enhancement)
  * create multiple activities for a single Video Library entry (ie a video of a practice session), capturing...
    * activity type
    * start & end times
    * notes
    * constraints used in the activity
      * start & end times (if not applied for the whole activity)
      * specific player(s) the constraint was applied to (if any)
      * observations
  * view history of how/when constraints have been used in activities (with links to load and play corresponding section of video)
* Badges (major enhancement)
  * given above, badges can now be awarded for specific or all activities, along with specific/all shooters (as was previously the case)
  * badges can be created and achievement determined based on "assigner" discretion, rather than automatically computed from shot data
  * the 'Player Details' (editor) popup window now also displays the badges the player has achieved, and players can be assigned "general" badges here (as opposed to being assigned for a specific activity)
    * the assigner can enter comments/notes when awarding these general badges
    * comments can be viewed by players in their "badge locker"
* Video Details & Resources
  * upload/remove video to/from cloud storage
  * (re-)run 'shot detection' (inference) on uploaded video
  * change camera perspective and if moving/fixed
  * add general notes/description to a video, which can be searched/filtered by in Video Library
  * remove (hide) from Video Library (aka "unpublished" status)
  * disable video playback from ShootXP cloud for a specific video (overrides a users cloud playback rights)
* Shot List, Analytics & Visualisations
  * shooting summary now displays breakdown between mid-range and 3pt range (makes and attempts)
  * filter by:
    * (un)contested shots
    * activity and constraints start/end times
* Import & Export Shot Data
  * import shots from XML (Sportscode, Angles etc)
  * import shot times and outcomes (make/miss) from CSV (generated in Shot Tagger or other tools)
  * export shots to JSON (includes shooter and defender x/y location data)
  * tweaks to improve accuracy and efficiency of identifying "makes" during shot detection inference and import processes
* User Permissions
  * user rights/permissions are now specific to the "active account" (only relevant when user belongs to multiple accounts)
  * users can be added to accounts as a "guest" (restricted to "view only" access)

UI/UX:

* video playback
  * buttons to skip forward/back 10 seconds in video
  * upon selection from Video Library, uploaded video automatically loads from ShootXP cloud (if cloud playback is enabled for the user)
* shot editor
  * court diagram is now shown alongside video frame
  * when plotting shooter/defender path locations on court diagram there is an option to show the location(s) before/after as a reference point to help with plotting accuracy
  * zoom in/out functionality when plotting locations or calibrating
  * additional option to assign shooter for current shot to all other shots without a shooter
* frame annotator
  * filter annotated frames by date updated
  * label counts now shown for each annotated frame
* video management
  * popup window with new UI for (advanced) filtering of Video Library
  * displays number of videos in library/channel (and responsive to filtering)
  * cancel in-progress video uploads
  * video uploading is dynamically enabled/disabled based on account credits/limits for transcoding and storage
* visualisations
  * contested shot markers are depicted by a ShootXP "purple" outline (instead of red)
* copy n paste calibration points when in "calibrate video" popup window, not just the shot editor
* button color/styling matches ShootXP theme ("purple")
* badge styling
* badge count and display button are now overlayed on a ShootXP basketball icon, positioned above the analytics and visualisation UI
* changed approach to syncing of data so app loads relatively quickly on start and when switching accounts, and then short wait for data to sync again when selecting a video from the video library

Bugs & Fixes:

* more secure api and cloud storage (checks against user rights and accounts)
* more robust and flexible handling of frame annotation data and manifest generation for ShootXP AI model training
* transcoded video file size not being updated
* copying and pasting calibration points now works correctly
* magnifying glass icon in search bars not "sticking" when scrolling a list
* badge description being displayed on all badges when shown for one

***

## Version 1.6.0 (2025.06.29)

Features & Functionality:

* capture shooter & defender locations using court diagram (for cases when a "moving" camera perspective and cannot calibrate video frame)

UI/UX:

* cleaner UI for shooter path editing
* changed color schemes for shooter plotting/highlighting
  * when capturing shot location on video frame or court diagram, it is plotted in orange (not white)
  * shooter highlight color on video - orange when have ball, yellow when not

***

## Version 1.5.0 (2025.06.23)

Features & Functionality:

* video library & playback
  * upload only option when adding video to library (skip shot detection)
  * load & play video from ShootXP cloud storage (if user is granted rights to do so)
  * add and play video from external online sources (mp4 & HLS formats)
* shot clips and playlist
  * 'quick tag' whether a shot was made or missed
  * set a specific lead-in time when playing video of shots
  * shot clip navigation buttons (next/previous/replay)
  * option to highlight shooter & defender in video when shot clip selected
* shooter path
  * track position/movement of opponent guarding the shooter (manually or using auto-detection)
  * assign whether shooter has the ball at any point in the path (manually or using auto-detection)
  * auto-detect shooter/defender paths on a shot-by-shot basis (using basic or advanced tracking AI models)
* analytics & visualisations
  * pre-shot movement direction radar
  * contest distance & direction radar
  * shooter-defender separation timeline
  * filter shots using "brush" selection to select multiple shots in a specific region of a chart
  * shots on shot chart and shooter-defender separation can be filtered/highlighted from start of shooter path
  * hide all other shots when hovering over a shot marker in shot and shooter-defender separation charts
  * when shooter has the ball it is displayed on charts as orange line or highlight around shot markers
* calibration
  * auto-calibration of video taken from non-fixed camera (pan/tilt/zoom)
    * for configured camera perspectives only
    * executed automatically on video upload, and can be re-executed at anytime by user in calibration section of app
    * visualise calibration results to assess accuracy
  * line (intersection) method to calibrate when 4 points of keyway are not all within video frame
  * assign calibration points to all shooter locations before/after current frame
  * copy n paste calibration points
  * "nudge" all or specific calibration points using Left/Right/Up/Down arrow buttons
* ShootXP model training
  * annotation category for "ball"

UI/UX

* layout re-arrangement (charts on right, shot list under video, dynamic chart sizes)
* selected shot is highlighted in shot playlist (and scrolls into view if necessary when selected)
* shortcut keys for navigating through shooter locations when editing/saving
* video frame and calibration options are hidden in shot editor if a video is not loaded
* explanation text for shot editing and shooter path now appears above the video frame
* new half court diagram (FIBA)
* more informative "status" of videos in video library list - 'local', 'uploaded', 'shot detection', 'external link'

Bugs & Fixes:

* remove video from storage when deleting video from library
* save any shot and shooter path times as a multiple of 0.2 (ie 0,0.2,0.4,0.6,0.8,1.0)
* shot filter drop downs disappearing when filter removes all shots
* changed the way imported shot times and shooter paths are stored (saving the shot time/frame as 0.4 seconds before the detected shot frame so we don't have to keep adjusting for "grounded" shot time in numerous functions)
* calibration points not clearing correctly

***

## Version 1.2.0 (2025.03.24)

Features & Functionality:

* highly enhanced frame annotator for efficient labelling and training of a shooting AI model based on camera-perspective (venue)
* adjust confidence thresholds when importing shots
* XML export now includes shot location, range and shooter movement

UI/UX

* calibration can now be done by entering/adjusting numerical values, as well as clicking on frame
* placement of activation button for video details side panel

Bugs & Fixes:

* video not displaying if loading same video from file system twice in a row
* newly trained models were not starting during video processing (inference) workflow

***

## Version 1.1.3 (2025.03.01)

Bugs & Fixes:

* video name not being updated and displayed when activity name is changed by user

***

## Version 1.1.2 (2025.02.27)

Features & Functionality:

* filter by shot result (make/miss)

***

## Version 1.1.1 (2024.06.06)

Bugs & Fixes:

* tweaks to re-enable access to game-xp page

***

## Version 1.1.0 (2024.01.11)

Features & Functionality:

* can now upload and process videos longer than 10 minutes
* can upload videos with resolution greater than 480p (they will then be automatically transcoded before processing)

Bugs & Fixes:

* shot chart linked to wrong video timepoint when filters applied
* inaccurate processing time approximation when multiple videos queued for processing
* issues with importing shots from more than one video (without page refresh)
* issue with tracking shooter in some cases

***

## Version 1.0.0 (2024.01.03) 🚀

The first release of the app contains the following major features:

* upload & process videos (using ShootXP AI)
* import shots from processed videos
* create players and add to groups
* shot editing (inc. manually adding shots, shooter movement paths and 'quick tagging' to ID shooters)
* shot analytics (inc. filtering by players, groups and time periods)
* activity information (inc. notes, activity type & constraints used)
* view badges and assign to players
* badge locker (for players to view on devices)
* export shot data to XML (Sportscode format)
* train ShootXP AI models
* "install" as a Web App on computer or device
