1. What the app is for

Handball Tracker is a cloud-based match-tracking app for handball teams. It records the attacking movement before the shot, the release area, the shot location, the attacking team, the goalkeeper faced, the shooter number, and the outcome.

Any club or team can use it. It is designed for goalkeeper analysis, opponent goalkeeper scouting, offensive shot maps, player profiles, and post-match statistics.

2. What you can analyse

• Your goalkeeper: which movements, distances, release zones, and shot zones create the most goals against.
• Opponent goalkeeper: where your team scores or misses against the opponent goalkeeper.
• Your attack: which players and release areas produce goals.
• Opponent attack: which opponent players are dangerous and from where.
• Movement patterns: start area → release area, with frequency and goal percentage.

3. Login, team selection, and access

1. Log in or sign up.
2. Select your organization/team.
3. If you are a new team, create your own team. The creator becomes admin.
4. Team data is separated. Users only see teams they have access to.

4. Organizations, teams, and permissions

• Organization Admin: manages the organization, sees all teams, invites or removes organization members, manages users in every team, and can delete teams.
• Team Admin: manages membership of that team but cannot change or delete the organization.
• Coach: starts with game tracking and old-game editing enabled. An Admin can adjust either permission.
• Player: starts with both permissions disabled. An Admin can enable either permission.
• Viewer: starts with both permissions disabled. An Admin can enable either permission when needed.
• Organization member without a team: sees no team data, but can create a new team from the organization/team access screen.

Use Manage organization as Organization Admin to see organization-only members first, followed by expandable team lists and their members. Only the Organization Admin can delete a team.

4. Starting a game

1. Your team is filled from the team selected after login.
2. Enter the opponent team.
3. Select My team is home or My team is away.
4. The game name is created automatically as Home Team-Away Team.
5. Enter My goalkeeper. Opponent attacks are linked to this goalkeeper.
6. Enter Opponent goalkeeper. Your team's attacks are linked to this goalkeeper.
7. Optionally enable and configure the match clock.
8. Optionally enable on-court lineup tracking for both teams, only your team, or only the opponent. Enter separate offensive and defensive lineups; the defensive fields are auto-filled from offense but can be changed independently.
9. Press Start game. The synchronized score starts at 0–0.

5. Filling in a shot during the game

1. Normal shot: drag from the attacker’s start position to the shot release point.
2. Penalty shot: press Penalty shot (7m). The app places the release point straight in front of goal, skips the movement drawing, and opens the shot-location screen. Penalties are included in release, goalkeeper, and goal-location statistics but excluded from movement matrices.
3. Press Next: shot location.
4. Tap the shot location in or around the goal.
5. Choose the attacking team.
6. Enter the shooter number.
7. Choose Goal or Miss.
8. Press Save shot. A Goal automatically adds one goal for the attacking team.

Use the score's plus and minus buttons for untracked goals or corrections. Each event stores the score before and after it for later score-context analysis.

Correcting or deleting a previous shot during a live game

1. Expand Live graphs below the tracker.
2. Press I want to adjust a previous shot.
3. Tap the attack in the graph. The selected attack is highlighted while the others fade.
4. Press Change this attack.
5. The old movement path, shot location, attacking team, player number, and result are loaded.
6. Keep them, redraw the attack, tap a new shot location, clear the entry, or delete the attack.
7. Save to update the existing attack rather than creating an extra one.

6. Goalkeeper linking logic

• Opponent attacks → shot is linked to My goalkeeper.
• My team attacks → shot is linked to Opponent goalkeeper.
• This allows one match file to show both your goalkeeper’s performance and the opponent goalkeeper’s weaknesses.

7. Outcome logic

• Use Goal when the ball enters the goal.
• Use Miss for saves, wide shots, high shots, post, or crossbar.
• The app decides whether a Miss is a Save or Off target based on where you tapped the shot location.
• Save percentage excludes off-target shots.

8. Filters

Choose Home or Away once for the current view. That team choice controls the dashboard, graphs, and Player card, while dashboard filters and graph filters remain independent. Both can filter by half, free time range, and attacking score difference. For example, -4 means the attacking team was four goals behind before that event. Press Set filter after changing time or score-difference values.

Useful examples:

• Choose opponent attacking team + your goalkeeper to analyse your goalkeeper.
• Choose your team attacking + opponent goalkeeper to scout the opponent goalkeeper.
• Choose one player to see their shot map and movement pattern.
• Choose one shot location to see which movements created that shot.

9. Statistics you can get and how to read them

The statistics are built to answer four different questions: how did our goalkeeper do?, where is the opponent goalkeeper weak?, how did our attack create shots?, and how did the opponent create shots?

• Dashboard: the quick overview. Read total shots, goals, saves, off-target shots, save percentage, and goal percentage. Use the filters to make the dashboard about one team, one goalkeeper, one player, one release area, one shot location, one result, or one distance band.
• Team dashboards in Excel: each attacking team gets its own statistics. This is important because shots by your team and shots by the opponent are two different stories.
• Goalkeeper Stats: read this as shots faced by a goalkeeper. For your goalkeeper, this shows opponent attacks. For the opponent goalkeeper, this shows your attacks. The main number is save percentage, but always check shot quality and distance before judging.
• Player Stats: read this as attacking output. It tells you which player shoots most, scores most, misses most, and from which situations they are dangerous.
• Release Matrix: rows are where the shot is released; columns are where the ball is placed in or around the goal. This helps connect shooting position with goal placement.
• Movement Stats: rows are the start areas and columns are the release areas. A cell like 3 / 67% means the movement happened 3 times and 67% became goals. This is especially useful for goalkeeper and defensive scouting, because it shows which movement creates dangerous shots.
• Distance Stats: compare close range, mid range, and long range. A goalkeeper conceding many goals from 6m may simply face clear chances; conceding too much from 8–9m may point more toward reading, timing, position, or lack of defensive pressure.
• Shot Location / Goal Zone: shows where the ball is placed. Use it to find repeated goalkeeper weaknesses, such as Top Right, Low Far Corner, or Low Mid.
• Graph Pack ZIP: gives picture files split by home team and away team. Use these to visually confirm the patterns found in the tables.
• Game review: starts with the final score, numeric Home-vs-Away comparison, goal timeline, and lead graph per half. Above zero means Home led; below zero means Away led.
• Player card: choose a player and optional lineup position to see basic output, field and goal graphs, and every detailed breakdown. Blocked shots count as attempts in the shooting percentages.
• Shot Data: the complete raw/enriched table, including score before/after and the attacking score difference before the event.

Good analysis order: first choose the attacking team, then goalkeeper or player, then check release area, movement, distance, and shot location. Do not overreact to one shot. Repeated patterns are the things to train, scout, or discuss with the team.

10. Old games and crash recovery

Old games can be reviewed or continued. If the app closes during a match, go to Old games and press Continue tracking. Choose this device’s tracking side. The server safely continues event order and score state for simultaneous trackers.

Games are organised in expandable folders and subfolders. Create top-level folders or subfolders such as Home games, use the three-dot menu to move or delete a game, and select complete folder trees or individual games for comparison. Pressing Review opens the dedicated Game review screen with Game overview, Home team, and Away team tabs. Each team contains Offense, Defense, and one-player Player card.

11. Exports

• Export statistics Excel: tables, dashboards, release matrices, distance stats, movement stats, and goalkeeper/player data.
• Export graph pack ZIP: picture files of the graphs, split into home-team and away-team folders.
• Export enriched CSV: all rows with calculated zones, distances, teams, and goalkeeper links.

12. Phone use

Open the app in Chrome or Safari and use Add to Home Screen. The app is designed for phone use during games, but reports are often easier to review on a computer.

Account recovery, verification, invitations, and contact

• Forgot password: use the login-page button and follow the email link back to the app.
• Verification: new accounts return to the app after confirming their email.
• Adding users: existing accounts are added immediately. New users receive an invitation email. The assigned team role controls what they can change.
• Contact: the Contact button at the top of the page opens a form. The recipient email address stays hidden.