App Help

  1. App Usage Summary
  2. Adding and Managing Users
  3. Scoring a Match
  4. Viewing Match and Career Statistics
  5. Deleting Users or Matches
  6. Coach Tab

1. App Usage Summary

The first step in using the Guruvi Basketball app is to add a user (i.e. Player) on the “Users” Tab. Then select the user that you would like to score a match for and go to the “Score” tab to start a new match. When starting a new match, you will be prompted to select a few brief details about the match, such whether it is played indoors or outdoors. After entering the match information, a new match is automatically started. For each event in the match that involves the player that you are tracking, simply select how the event started (such as the player received a pass or the player the stole ball from the opponent,) where the event ended on the court, and how the event ended (such as the player took a shot and scored.) Once you select how the event started, the app automatically takes you through the other steps needed to complete the data capture for the event. A brief statement at the bottom of the screen will tell you exactly what you’re expected to do next. The app is flexible and allows you to collect event information for more than one player in a given match. At any time go to the “Match” tab to see your stats for the current match in progress or any previous match. The “Career” tab shows your stats averaged over the last 20 matches and is updated when the current match in progress is completed.

2. Adding and Managing Users

To add a user (player) touch the “+” button on the “Users” tab and enter name and information for the user. To select a user, simply touch the name of the user on the “Users” tab and a checkmark will appear next to the name. Then the scoring information that you enter or statistics that you view on the other tabs will be for the selected user. You may update a user’s information by touching “Edit” on the “Users” tab then touching the desired user. A sheet is then shown with the current user information that you may edit and save.

3. Scoring a Match

Starting a New Match

A user from the “Users” tab must be selected and the previous match in progress must be completed or deleted prior to starting a new match. Touch the “New Match” button on the “Score” tab and a sheet will appear to set the match details. Change the default settings as you desire and use the note section to add a quick note that you want to remember such as name of opponent, etc. Touch “Save” and a new match is started.

New Match Match Info

Entering Event Information

Once a match is in progress, the “Score” tab displays a list of options to select how the event started. Here select the action performed by the user to start the event. The options are the user blocked a shot, was fouled or committed a foul, received pass, got rebound, free throw, won free ball, or user forced a turnover. At any time, the bottom of the screen shows a simple comment to guide you on what to do next. A comment at the top of the screen shows how many events have been captured for the particular user in the current match.

Once the start of the event is selected, the screen advances to the next step. Typically, the next step involves selecting the location on the court where the event ended. Simply touch the location on the court and the screen then advances to a menu to select how the event ended. The choices of how the event ended are dependent on how the event started.

First View Court View
End Event End Event 2

When the data entry for an event is complete the event counter automatically increments and the view for entering the start of the next event is shown.


Selecting cancel from the menus or touching the undo button when it is available will take you to the previous step for entering event information. When entering event information, successively selecting cancel or undo will take you all the way back to the first step for event information.

Changing Court Orientation

The view for selecting the location on the court where the event ended shows which end of the court is considered the offensive side of the court for the selected player and which side is considered the defensive side of the court. If you desire to switch the defensive and offensive sides of the court, simply touch the “Match” button and then select “Rotate Court” from the list of options.

Change Orientation

Changing Match Information

The match information such as the date of the match or the type of court played on can be changed from the first view where the event information entry begins. In this view touch the “Match” button and then select “Edit Match Information.”

Change Match Info

Ending or Deleting Match

To end a match touch the “Match” button and select “Match Done” from the menu. You may also delete a match in progress by touching the “Match” button and selecting “Delete Current Match.”

Tips for Scoring a Match

One of our main goals has been to make it very easy to capture the result of each event while still allowing for detailed data collection that can help you improve your game. For example, to reduce the complexity we don’t distinguish if the free throw was the result of you being fouled or the opponent getting a technical foul. What is important is to be consistent in the way that you score events. Here are some suggestions to help you stay consistent.

4. Viewing Match and Career Statistics

Match Stats

Selecting the “Match” tab displays all the matches that have been captured for the selected user. The matches are organized in a list by reverse order that they were entered into the app. Scroll down or up to find the match of interest. Touching the entry in the list for a particular match shows the detailed results of that match. You can scroll down to see all the statistics for the match. The first section shows the notes associated with a match.

Matches List Match Stats

Scroll down to the 2nd section to see the match summary for the match such as the number of points, assists, rebounds, etc. by the selected player. The 3rd section shows the shooting summary for the selected user. This section shows the user’s field goal, 3-point field goal, and free throw percentages.

The 4th section shows the scoring breakdown which is what percentage of the user’s points were obtained through 2-point field goals, 3-point field goals, and free throws.

The 5th section analyzes the events for the selected user. First events on the offensive side of the court are broken down by the end result of the event (shot taken, successful pass, unsuccessful pass, lost ball, was fouled by opponent, or user committed foul.) Next events on the defensive side of the court are broken down by the end result of the events. Then a breakdown is shown on how the selected user obtained the ball (receiving a pass, getting a defensive rebound, getting an offensive rebound, stealing ball from opponent, or winning a free ball.)

In each section next to the stats for the selected match is a comparison of how the user performed relative to their Career average. This difference is shown in blue colored numbers if the difference is greater than zero and brown colored numbers if the difference is less than zero. For example if 20% of the user’s events in the match were shots and for the career this stat was 15%, then the difference will show 5% (20%-15%) meaning that in the current match a higher percentage of the events for the user ended by the user taking a shot. By comparing a match to the career average, you can get a feel whether the player was playing better or worse than they normally play.

Career Stats

Selecting the “Career” tab displays the career stats for the selected user. The career stats are the stats averaged over the last 20 matches. Every time the selected user completes data entry for a match, career stats are re-calculated.

Meaning of the Statistics Shown

5. Deleting Users or Matches

Users or matches can be deleted from the “Users” or “Match” tabs by touching the “Edit” button in the upper left side of the screen then touching the round red button next to the item to be deleted and then touching the “Delete” button. When a user is deleted, all associated match and career data are also deleted.

6. Coach Tab

The Coach tab connects you to the app’s webpage, which requires an Internet connection, where you may find tips for how to improve your game using the statistics collected by the app or find other interesting information for interpreting the results of the data that you have collected.