GameTime — Help

Managing an association associationmaster

When you sign in you land on an association's edit page with five tabs across the top:

Basics · Data source · Courts · Display · Fallback images

The blue Copy button next to the title copies the TV URL to your clipboard — paste this on the venue's TV to start the display.

Basics tab

Sets the association's display name.

• Name — what shows on the TV header and on screen titles.
• Slug — fixed, set by a master admin when the association is created (e.g. illawarra, wollondilly). Can't be changed because it's part of the TV URL.

Click Save basics.

Data source tab — where the matches come from

GameTime can read matches from BC in three ways:

• API only — fastest. Works for most associations.
• Scrape only — uses headless Chromium to read BC public pages. Slower but works when the API doesn't return your competitions (e.g. Wollondilly).
• API with scrape fallback — try API first, fall back to scraping.

If you're using the API

1. Primary BC organisation (optional) — only set this for associations where per-competition lookups don't return data. Leave blank for most cases.
2. Click Refresh from BC to load the organisation list.
3. Under Browse competitions from, pick the organisation whose competitions you want to display.
4. Tick the competitions you want.
5. Repeat for other organisations if you also host their games (e.g. a Waratah Junior League competition played at your venue).
6. Your full selection appears under Selected competitions — tick the boxes there to remove anything you don't want.
7. Click Save data source.

If you're using scraping

1. Paste BC page URLs into the textarea, one per line. Example:

   https://registration.basketballconnect.com/liveScoreSeasonFixture?organisationKey=…

2. The scraper runs automatically every 5 minutes.
3. To kick it off straight away, click ↻ Run scrape now. It takes 30–60 seconds.
4. Click Save data source.

Both at once

The hybrid mode shows both blocks. Configure competitions and URLs — GameTime uses the API first and falls back to the scraper if the API is empty.

Courts tab — which courts to show

The TV displays one block per court. You choose which courts the TV shows.

1. Click Discover courts from BC. GameTime asks BC which courts have games for your selected competitions and shows them.
2. Tick the courts you want to show.
3. For each ticked court, set:
   • Display name — what shows on the TV.
   • Sponsor logo — pick from your uploaded logos, or leave blank.
4. Use the ▲ / ▼ buttons to reorder courts.
5. Click Save courts.

Uploading a sponsor logo for a court

In the logo picker on a court row, click Upload, choose an image (PNG, JPG, WebP, or SVG), confirm. The logo becomes available for every court on this association. To delete a logo, open the picker and click the red Delete next to it.

Display tab — how the TV looks

Layout

• Preset:
  • Illawarra — landscape, multi-court grid.
  • Wollondilly — portrait, split white/black columns.
  • Custom — your own layout (see WYSIWYG below).
• Orientation — Landscape or Portrait.

Theme

• Background / Text / Accent / Team-2 colours — hex or colour picker.
• Font family and Font scale (0.5×–2.0×).
• Game stays on screen (minutes) — how long after scheduled start time the game remains visible. Default 10.

Custom text

• Header text — top of the TV.
• Footer text — bottom of the TV.

Live preview

Below the form is an iframe showing the TV exactly as it will render. Click ↻ Refresh preview after saving.

The WYSIWYG editor (Custom preset)

If you picked the Custom preset, click Open WYSIWYG editor → to drag-and-drop your own layout.

Top toolbar — add blocks:

• + Text — a text label.
• + Image — an uploaded image.
• + Court block — full court info card.
• + Shape — coloured rectangle.
• Clear all — wipes the layout. Use carefully.

• Canvas size — width × height in pixels. Default 1920 × 1080.
• Landscape / Portrait — flips the orientation.
• Drag a block to move; drag a corner to resize.
• Click a block to select it — the inspector appears on the right.

The inspector lets you:

• Change position (X, Y) and size (width, height).
• Text blocks: content, colour, font size, weight, alignment.
• Image blocks: pick the uploaded image.
• Court blocks: pick which court index (1, 2, …).
• Shape blocks: fill colour, border, corner radius.
• Z-order: Bring to front, Forward, Backward, Send to back.
• Remove — delete the selected block.

Save keeps you in the editor; Save & Exit returns to the Display tab.

Fallback images tab — what shows after the games end

When no games remain for today, you can either keep the layout on screen (with empty court cards) or cycle through your own full-screen images.

1. Tick Show fallback images when there are no more games today.
2. Duration per image (seconds) — default 8.
3. Click Save settings.
4. Upload images: Choose file → PNG / JPG / WebP / SVG → Upload.
5. Red Delete removes an image. Images cycle in upload order.

Master admin master

Master admins land on /admin.html. There are three tabs:

Associations · Users · Settings

Associations tab — managing tenants

Create an association

1. Click + New association.
2. Fill in:
   • Name — e.g. "Illawarra Hawks".
   • Slug — short id used in URLs (lowercase letters, digits, dashes). Can't be changed later.
3. Click Create.

Per-row actions

• Save — saves the polling interval typed inline. How often GameTime re-ingests match data. Default 5 minutes.
• TV URL — copies the public TV URL to clipboard.
• Edit — opens the same association editor (§ Managing an association).
• Delete — removes the association and its data. There is no undo.

Users tab — managing accounts

Create a user

1. Click + New user.
2. Fill in:
   • Username — no spaces, lowercase.
   • Display name — what GameTime calls them.
   • Password — strong. They'll be forced to change it on first login.
   • Role — Master (full admin) or Association (restricted).
   • Associations — if association role, tick which slug(s).
3. Click Create.
4. Share the credentials securely (password manager share, not email).

Per-user actions

• Reset password — set a new password. User forced to change on next login.
• Delete — removes the user. You can't delete yourself, and you can't delete the only master.

You also can't demote yourself from master, and you can't demote the last master. These guardrails prevent locking the platform out of admin access.

Settings tab

• BC API key — one key shared across all associations.
• BC API base URL — usually https://api-basketball-au.worldsportaction.com/v0.

Save settings applies the change. Test connection verifies the key works against BC.

Helping a user who's locked out

• After 5 failures in 10 minutes their account is locked for 5 minutes — tell them to wait.
• If they've forgotten: Users → Reset password → pass them a temporary password securely. They'll be forced to change it on next sign-in.