> 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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.shootxp.com/platform-release-notes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
