ChessRoster Platform Integration
SwissSys integrates with the ChessRoster web platform to let you advertise tournaments online, share live results with players, and manage online registrations. The integration links your SwissSys tournament file to an event on ChessRoster and keeps the two in sync.
What the Integration Does
| Capability | Status |
|---|---|
| Publish tournament details and sections online | Available |
| Upload round pairings, results, and standings | Available |
| Live standings and pairings on ChessRoster website | Available |
| Auto-sync (background uploads on a timer) | Available |
| Download tournament data from ChessRoster into SwissSys | Available |
| Online player registration through ChessRoster website | Available |
| Receiving registration events (new players, withdrawals, updates) from ChessRoster | Available |
Prerequisites
Before connecting SwissSys to ChessRoster, you need:
- An active internet connection.
- A ChessRoster account with organizer privileges. Register for free at chessroster.com .
- A default web browser installed (used for the OAuth login flow).
You do not need to create the tournament on ChessRoster first — SwissSys can create a new ChessRoster event during the linking process.
How to Connect
There are three ways to open the ChessRoster dialog in SwissSys:
- Menu: Internet → Sync with ChessRoster
- Toolbar: Click the ChessRoster icon (v11.76+)
- Status bar: Click the ChessRoster status text at the bottom-right of the main window (v11.76+)
For step-by-step instructions, see the ChessRoster Integration Dialog reference page.
Authentication and Security
SwissSys uses an OAuth2-style browser-based login flow. You authenticate on the ChessRoster website — SwissSys never sees your password.
After login, a session token is stored encrypted on your computer using Windows Data Protection API (DPAPI). The token is tied to your Windows user account and cannot be read by other users on the same machine.
Tokens expire periodically. When a token expires, SwissSys will prompt you to log in again. Your tournament link is preserved across re-authentication.
Sync Overview
Each sync uploads the current state of your SwissSys tournament to ChessRoster:
- Tournament and section details
- Round pairings and results
- Standings
Sync is always initiated from SwissSys. There are two modes:
- Manual sync — Click Sync Now in the ChessRoster dialog.
- Auto-sync — Enable the auto-sync checkbox in the linked status panel and set an interval. SwissSys uploads in the background at that interval.
The status bar at the bottom of the main window shows the time of the last sync and whether auto-sync is on.
Organizers and Tournaments
When you first link a tournament, SwissSys asks you to select an organizer profile. This is the entity that will appear as the host on ChessRoster:
- Organization (recommended) — A club, school, or recurring organizing body. Use this for anything that runs more than one tournament.
- Personal organizer — Your individual account. This option is being phased out in favor of organizations.
After selecting an organizer, you either create a new ChessRoster event or link to an existing one:
- Create new — SwissSys creates a ChessRoster event and links your file to it. You provide the name, dates, and location.
- Link existing — If the event was created on the ChessRoster website first, select it from the dropdown and click Link.
- Download — If you open the dialog without a tournament loaded, you can download a previously uploaded tournament file from ChessRoster and open it in SwissSys.
Related Topics
- ChessRoster Integration Dialog — Step-by-step setup, sync, and troubleshooting reference.
- Hosted Website — Legacy manual upload method for tournament reports.