Skip to content

Commit 7d8ca62

Browse files
author
Ben
committed
Add Live Tennis app
1 parent b517550 commit 7d8ca62

3 files changed

Lines changed: 562 additions & 0 deletions

File tree

apps/livetennisscores/README.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# Live Tennis
2+
3+
Live **point-by-point** tennis scores on your Tidbyt, across the ATP, WTA,
4+
Challenger and ITF tours.
5+
6+
![Live Tennis](live_tennis_scores.gif)
7+
8+
Each live match gets its own page and the app rotates through them:
9+
10+
```
11+
+----------------------------------+
12+
| Toronto QF | <- tournament + round (bg colour = tour)
13+
| Alcaraz 1 2 40 | <- sets won / games this set / current point
14+
| * Sinner 1 1 AD | <- green dot = this player is serving
15+
| 6-3 4-6 LIVE | <- completed sets live/tiebreak
16+
+----------------------------------+
17+
```
18+
19+
* **Sets won** in white, **games in the current set** in blue, **current point**
20+
(`0 / 15 / 30 / 40 / AD`) in yellow.
21+
* During a tiebreak the point column turns orange and the status reads `TB`.
22+
* The header background identifies the tour: blue = ATP, magenta = WTA,
23+
brown = Challenger, grey = ITF.
24+
* A player slot that has not been filled yet (qualifier / lucky loser) shows
25+
`TBD`, and a match with no score yet shows `About to start`.
26+
27+
## Setup
28+
29+
1. Get a **free** Live Tennis API key (1,000 requests/day) at
30+
<https://livetennisapi.com/subscribe/free>.
31+
2. Paste it into the app's **API key** field in the Tidbyt mobile app.
32+
3. Optionally pick a single tour, set the rotation speed, and turn on rankings.
33+
34+
## Requests
35+
36+
The app fetches `GET /matches?status=live` with `ttl_seconds = 120`, so one
37+
key/tour combination makes at most `86400 / 120 = 720` upstream requests a day —
38+
inside the 1,000/day free tier.

0 commit comments

Comments
 (0)