Your home base

Everything at a glance #

Open the dashboard and you immediately see where you stand. Win rate, play time, serve percentage, return wins. Your recent matches are right there with full scores and tags. Set weekly goals and track them without opening a spreadsheet.

Dashboard showing stats overview, activity timeline, recent matches, and goals

During the match

Let someone else watch the score #

While you play, the live scoreboard streams the match to any browser. Friends waiting for the next court, your coach at home, or just your phone on the bench. Big, clean numbers that update in real time, point by point.

Live scoreboard showing a doubles match in progress

After the match

Every match, saved and searchable #

Scroll through your match history and filter by sport, player, location, or tags. Every match card shows the score, duration, sport type, and who played. Tap into any match for point-by-point detail, swing data, and serve stats.

Match history showing a grid of past matches across multiple sports

Where you play

Pin every court on the map #

GPS tags each match automatically. Over time, you build a map of every place you've played, from your local club to that court you found on vacation. Tap any pin to see what happened there.

Map view showing match locations across Europe with match details

Go deeper

Find out what's actually working #

Do you win more in shorter matches or longer ones? What's your win rate when your heart rate stays low? How do you stack up against a specific opponent across serve %, return %, clutch moments, and tiebreaks? Pick any two players and compare them side by side.

Player analytics showing win rate by match duration and heart rate zone

Player comparison with radar chart and head-to-head stats

The big picture

Track how your game evolves #

Shot power trends over weeks, intensity patterns across matches, error breakdowns for both sides. These aren't numbers you check once. They're the kind of thing that changes how you warm up, how you train, and which shots you trust in a tight game.

Global stats showing power trends, intensity, and error breakdown charts

One app, six sports

Padel Tennis Pickleball Badminton Squash Table Tennis

Each sport has its own scoring rules, serve logic, and game modes built in. Golden point, advantage, timed matches, Americano, best of 3 or 5, you set it up once and it just works. Connect watches with your playing partners over ANT+ and everyone stays in sync, no phone required. Every match is saved as a native Garmin activity.

Self Host (Docker) #

The web dashboard and API run as Docker containers on your own server or home machine. Pre-built images are published to the GitHub Container Registry, no build step needed.

Available images

ghcr.io/francudina/racketscore-api:latest ↗ link
ghcr.io/francudina/racketscore-web:latest ↗ link

Prerequisites

Docker and Docker Compose installed

1. Create docker-compose.yml

name: racketscore

services:
  db:
    container_name: racketscore-db
    image: postgres:alpine
    environment:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}
      PGDATA: /data/postgres
      POSTGRES_INITDB_ARGS: --encoding=UTF-8
    ports:
      - "${POSTGRES_PORT:-5432}:5432"
    volumes:
      - pgdata:/data/postgres
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 10s

  api:
    image: ghcr.io/francudina/racketscore-api:${APP_VERSION:-latest}
    container_name: racketscore-api
    restart: unless-stopped
    environment:
      DATABASE_URL: "postgresql+asyncpg://${POSTGRES_USER}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB}"
      POSTGRES_SCHEMA: ${POSTGRES_SCHEMA}
      JWT_SECRET_KEY: ${JWT_SECRET_KEY}
      RESET_SECRET_KEY: ${RESET_SECRET_KEY}
    ports:
      - "${API_PORT:-8741}:8741"
    depends_on:
      db:
        condition: service_healthy
    healthcheck:
      test: ["CMD-SHELL", "python -c 'import urllib.request; urllib.request.urlopen(\"http://localhost:8741/health\")'"]
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 15s

  web:
    image: ghcr.io/francudina/racketscore-web:${APP_VERSION:-latest}
    container_name: racketscore-web
    restart: unless-stopped
    ports:
      - "${WEB_PORT:-3847}:80"
    depends_on:
      api:
        condition: service_healthy

volumes:
  pgdata:

2. Create .env

Create a .env file in the same directory:

# Ports
API_PORT=8741
WEB_PORT=3847

# Database
POSTGRES_USER=racketscore
POSTGRES_PASSWORD=change-me-use-a-strong-password
POSTGRES_DB=racketscore
POSTGRES_PORT=5432
POSTGRES_SCHEMA=racketscore

# Security - generate your own secrets!
JWT_SECRET_KEY=change-me-in-production-use-a-real-secret
RESET_SECRET_KEY=change-me-in-production-use-a-real-secret

# App version (matches git tag, e.g. 1.0.0, or "latest")
APP_VERSION=latest

Change at minimum: POSTGRES_PASSWORD, JWT_SECRET_KEY, and RESET_SECRET_KEY. Generate secrets with openssl rand -hex 32.

3. Start

docker compose up -d

The web UI is available at http://localhost:3847 (or your configured WEB_PORT). The API runs on port 8741, which is the address you configure on the watch for syncing. Default password is admin; you'll be prompted to change it on first login.

Updating

docker compose pull
docker compose up -d

Watch → Server connectivity

The watch syncs over HTTP to your server's IP and port 8741. Make sure:

The watch and server are on the same Wi-Fi network, or
The server is reachable over the internet (port forwarded / VPN / public IP)

You can find the correct IP addresses in Settings → Watch Connection inside the web dashboard.

What's new #

v1.0.2 Apr 1, 2026

Display

New Font Size setting, choose between Small and Medium for all gameplay labels
Available from both the in-game menu (long-press UP) and main Settings

Colors

Black added as a color option for data fields

New Devices

Descent™ G2
Descent™ Mk3 43mm / Mk3i 43mm
Descent™ Mk3i 51mm
Approach® S50
Approach® S70 42mm
Approach® S70 47mm

v1.0.1 Mar 27, 2026

App Themes

11 preset color themes available in Settings > Colors > Themes
Long-press UP during gameplay for quick theme switching
Optimized for MIP displays

Bug Fixes

Fixed incorrect scoring for the Silver Point deuce rule in Padel and Tennis

v1.0.0 Mar 10, 2026

Scoring

Full scoring for Padel, Tennis, Pickleball, Badminton, Squash and Table Tennis
Each sport uses correct rules, point system and game structure
Golden Point mode for padel
Tiebreak support
Singles and doubles
Undo last point at any time

Multiplayer

Host a match and share the live score with every player on the court
Everyone sees the score update in real time on their own watch
Vibration alerts on every game and set won

Swing Analytics

Automatic swing detection on every shot
Measures G-Force and estimates Power output in Watts per swing
View average and peak values in the post-match summary
Track whether your hitting is improving over time

Live Scores

Follow any active match in real time from a browser
See live score, current game, set progress and physical stats as they update
No need to be on the court

Connection

Live score streaming and match sync require a Bluetooth connection between your watch and your phone via the Garmin Connect app
Multiplayer scoring between watches uses ANT+ directly and does not require a phone

Match History

Every match saved with full detail
Set scores, point by point history, serve and return win rates, heart rate, calories, play time, swing count and power data
Filter and browse past matches by sport, result, date and more

Player Profiles

Create player profiles and link them to Garmin devices
Track individual performance over time
Compare stats between players and sessions

Performance Stats

Win rate trends, serve and return win percentages, error analysis, fitness trends, power over time and intensity charts
Filterable by sport, date range, result and team mode

Goals

Set weekly or monthly targets for matches played, win rate, play time, calories, power and more
Track progress directly from the dashboard

Dashboard

Add the stat tiles and goals that matter to you
Reorder and arrange sections to suit how you review your data

Backups

Create full database snapshots directly from settings and restore them at any time
Device backups store match data uploaded from your Garmin watch and can be restored individually
Never lose your match history

RacketScore