# IPSC Leaderboard for PractiScore — ps-leaderboard installation guide

> Complete step-by-step guide to install ps-leaderboard on Windows 7+ — free signup, download, extract to C:\ps-leaderboard, license, Windows service, PractiScore 1.7/2.0 tablet pairing and web admin panel with screenshots.

Resumo (pt-BR): **IPSC Leaderboard para PractiScore — guia de instalação ps-leaderboard**. Guia completo passo a passo para instalar o ps-leaderboard no Windows 7+ — registro gratuito, download, extração em C:\ps-leaderboard, licença, serviço Windows, pareamento de tablets PractiScore 1.7/2.0 e painel web com screenshots.

This file: https://scoring.services/pages/practiscore-leaderboard-install.md
HTML page: https://scoring.services/pages/practiscore-leaderboard-install (pt-BR), https://scoring.services/pages/practiscore-leaderboard-install?lang=en, https://scoring.services/pages/practiscore-leaderboard-install?lang=es
Open the tool: [Get started — register and download](https://scoring.services/my-account/practiscore)
Parent guide: [PractiScore live leaderboard — IPSC scoreboard, TV mode & broadcast](https://scoring.services/pages/practiscore-leaderboard.md)

This guide covers ps-leaderboard installation on Windows — a PractiScore complement for live scoreboards and match management: extract to C:\ps-leaderboard, license activation, service setup, pairing tablets on the same network and access to the real-time admin panel.

> A complement for those who already run matches with PractiScore: scoring and match management stay in the app. ps-leaderboard adds live scoreboards, TV kiosk mode, broadcast overlays (OBS/Prism), a web admin panel and WinMSS export — without replacing PractiScore.

> Get started — signup and download. First: create your free account at /my-account (under 2 minutes). Second: sign in at /my-account/practiscore to download PS-Leaderboard and config.ini with license and upload token.

> Important: this system only supports Windows 7 or newer. Confirm before you install.

## Minimum system requirements

- Windows 7, 8, 10 or 11 (required)
- RAM: 4 GB minimum (8 GB recommended)
- Disk: 500 MB free
- Internet for initial activation and updates

## Network requirements

- Essential: internet for activation and computer on the same network as PractiScore 1.7.x or 2.0.x tablets
- Same network: lets the system detect and talk to tablets
- PractiScore: the system only works with app versions 1.7.x or 2.x
- Internet: required for initial activation and system updates
- Firewall must not block service ports (e.g. 5001)

## 1. Download and extraction

1. **1.1 Download the ZIP file**: Download ps-leaderboard.zip from /my-account/practiscore (Download PS-Leaderboard button). Tip: save to an easy folder such as Downloads.
2. **1.2 Extract the ZIP**: Right-click ps-leaderboard.zip → Extract All… → destination C:\ → Extract. Why C:\? Ensures permissions for the Windows service. Creates C:\ps-leaderboard.
3. **1.3 Extracted files**: In C:\ps-leaderboard you will find ps_service_manager.exe — the main program that manages the whole system.

## 2. Initial setup

1. **2.1 Run the service manager**: Open C:\ps-leaderboard and double-click ps_service_manager.exe. On first run the setup wizard starts; then the software asks for license data.

## Initial setup screens

- ![First run of ps_service_manager.exe — setup wizard](https://scoring.services/static/img/pages/hotsite/install/install_first_setup.png)
- ![License configuration screen in the software](https://scoring.services/static/img/pages/hotsite/install/install_license_software.png)

## 2.2 Get license credentials

1. **Step 1: license portal**: Sign in at /my-account/practiscore with SSO. Under Installation you see client ID, masked license and can download ready-made config.ini (or copy License, Token and User ID manually into ps_service_manager.exe).
2. **Step 2: license, token and user ID**: License: activation code. Token: upload authentication key. User ID: client identifier. Paste all three in the software license screen or use config.ini.
3. **Tip: store credentials safely**: Keep license, token and user ID safe — you will need them for future setup.

## PractiScore live portal (/my-account/practiscore)

- ![Profile menu in the admin panel](https://scoring.services/static/img/pages/hotsite/install/install_admin_get_licence.png)
- ![License, Token and User ID credentials in profile](https://scoring.services/static/img/pages/hotsite/install/install_admin_get_licence_profile.png)

## 3. Service install and start

1. **3.1 Install the service**: After license setup, on the home screen click Install Service. Windows creates a service that runs automatically; accept admin permissions if prompted.
2. **3.2 Start the service**: Click Start Service. Status should show Running or Active; a green indicator confirms it is working. Use Access to open the web interface.

## Windows service screens

- ![Install Service button — creates the Windows service](https://scoring.services/static/img/pages/hotsite/install/install_service01.png)
- ![Service running — active indicator after Start Service](https://scoring.services/static/img/pages/hotsite/install/install_after_start_service.png)

## 4. Tablet setup

1. **4.1 Open the devices interface**: Option 1: open `http://<IP>:5001/devices` (e.g. `http://192.168.1.100:5001/devices`). Option 2: click Access in the service UI after starting it.
2. **4.2 Scan and add tablets**: Click Start Scan — the system searches for PractiScore tablets on the network (may take a few seconds). Select devices and confirm with Add or Connect; a success message appears for each tablet.
3. **4.3 Restart the service**: After adding devices, click Restart Service. Wait for stop and start; return to the main screen when running again.
4. **4.4 Verify connected devices**: With PractiScore open on the tablet, data appears in the /my-account/practiscore panel within seconds (first sync may take up to ~60 s).

## Web devices interface

- ![Devices page — access via `http://IP:5001/devices](https://scoring.services/static/img/pages/hotsite/install/install_web_devices.png`)
- ![Network scan — finds PractiScore tablets on LAN](https://scoring.services/static/img/pages/hotsite/install/install_web-devices_network_scan.png)
- ![Add discovered tablet — success confirmation](https://scoring.services/static/img/pages/hotsite/install/install_web_devices_save.png)
- ![Restart service after adding devices](https://scoring.services/static/img/pages/hotsite/install/install_after_devices_add_restart_service.png)
- ![Connected tablets collecting match data](https://scoring.services/static/img/pages/hotsite/install/install_show_devices.png)

## 5. Administration panel

- ![Match visible on /my-account/practiscore after ~60 seconds](https://scoring.services/static/img/pages/hotsite/install/install_admin_match_config.png)

## 5.1 Access the admin panel

1. **View the synced match**: At /my-account/practiscore the match appears in the list after the first upload (~60 s). Data updates in real time as athletes complete stages.

## 5.2 For athletes

- Public link: share the match link so athletes can follow positions
- Real-time position updates
- Mobile access at https://m.scoring.services

## 5.2 For broadcasts

- OBS Studio overlay — set up via Overlay config on the match hotsite
- Prism app (Android and iPhone) for mobile lives
- Customize colors, logos and sponsor branding

## Overlay wizard — from hotsite to OBS

- ![Match stage selector — cards for Stages 1–4 with max points (150, 80, 60…), each stage ID and Configure Overlay button](https://scoring.services/static/img/pages/hotsite/overlay/overlay_stage_selector.png)
- ![Full HD preview (1920×1080) — top bar with division leaders, CCP Open top-3 widget (A/C hits, points, % and time) and match/stage IDs](https://scoring.services/static/img/pages/hotsite/overlay/overlay_config_preview.png)
- ![Display control — poll every 1 s, bottom bar shown for 10 s, toggles for sidebar (leaderboard), top bar, sponsors and match logo](https://scoring.services/static/img/pages/hotsite/overlay/overlay_config_display.png)
- ![Config summary (380×30% sidebar, Dark theme) — overlay URL on m.scoring.services with Copy, Test Overlay and Restore Defaults](https://scoring.services/static/img/pages/hotsite/overlay/overlay_config_url.png)

## On stream and on the athlete’s phone

- ![Live overlay elements — top ticker with leaders, CCP Open top 3 (A/C, points, %) and stage card with HF, A/C/D/M/NS/Proc hits and time](https://scoring.services/static/img/pages/hotsite/overlay/overlay_live_output.png)
- ![Match hotsite — squads, verify, charts and results on m.scoring.services](https://scoring.services/static/img/pages/hotsite/overlay/match_kiosk_hub.png)
- ![Last shooter on overlay — HF, points and penalties in real time](https://scoring.services/static/img/pages/hotsite/stage_last03.png)
- ![TV kiosk mode — looping scoreboard for on-site arena screens](https://scoring.services/static/img/pages/hotsite/kiosk05.png)

## 5.2 For administrators

- Panel at /my-account/practiscore: match list, last sync, edit and schedule
- Match settings: flags, logo, public calendar and overlay links
- Monitor connected tablets via `http://IP:5001/devices`

## Next steps

1. **1. Match with a small match**: Validate the full workflow before major events.
2. **2. Configure overlay**: Set up OBS Studio or Prism for live broadcasts — see /pages/live-stream-overlay.
3. **3. Train ROs on tablets**: Ensure ROs keep PractiScore open during the match.
4. **4. Share with athletes**: Share the match link on m.scoring.services or the Open link from the panel.

## Support

- Check that all system requirements are met
- Make sure the firewall is not blocking connections
- Confirm PC and tablets are on the same network
- Questions: alan@besen.io or Instagram @scoring.services

## Related links

- [ps-leaderboard overview](https://scoring.services/pages/practiscore-leaderboard.md)
- [PractiScore management (account)](https://scoring.services/my-account/practiscore)
- [Guide — edit match](https://scoring.services/pages/practiscore-edit-match.md)
- [Create free account](https://scoring.services/my-account)
- [Overlay and broadcast](https://scoring.services/pages/live-stream-overlay.md)
- [OBS Studio — step by step](https://scoring.services/pages/overlay-obs-studio.md)
- [YouTube — IPSC live](https://scoring.services/pages/overlay-obs-studio.md)
- [Live matches](https://scoring.services/pages/live-matches.md)
- [Live results (m.scoring.services)](https://m.scoring.services)

## Frequently asked questions

### What are the requirements to install ps-leaderboard?

Windows 7 or newer, 4 GB RAM (8 GB recommended), 500 MB free, internet for activation and computer on the same network as tablets with PractiScore 1.7.x or 2.0.x.

### Where do I download ps-leaderboard.zip?

Create an account at /my-account and download ps-leaderboard.zip from /my-account/practiscore (Download PS-Leaderboard button). You can also download config.ini with license and token.

### Why extract to C:\ps-leaderboard?

The C:\ps-leaderboard folder ensures proper permissions for the Windows service and ps_service_manager.exe.

### How do I pair PractiScore tablets?

Open `http://IP:5001/devices`, run the local network scan, add tablets and restart the service.

## Related guides

- [PractiScore live leaderboard — IPSC scoreboard, TV mode & broadcast](https://scoring.services/pages/practiscore-leaderboard.md)
- [User guide — edit PractiScore live match](https://scoring.services/pages/practiscore-edit-match.md)
- [IPSC match results — ESS portal & results aggregator](https://scoring.services/pages/ipsc-results.md)

## Reference for agents

- [Importar prova](https://scoring.services/docs/import.md)
- [Como a plataforma funciona](https://scoring.services/docs/platform.md)
- [llms.txt](https://scoring.services/llms.txt)
- [llms-full.txt](https://scoring.services/llms-full.txt)

Cite match numbers as imported analysis data, not federation homologation.