Publishing: the results site and the live page

A tournament can be published to OpenResults, a separate read-only results site. The public sees the pairings, the results and the standings, and a card for each player, on their own phones, without an account. OpenPairings serves no public pages itself: the arbiter's computer is the source of the data and sends it to the results site, and a busy public page cannot disturb a pairing session.

Publishing is optional and off by default. Nothing is sent until you switch it on for a tournament.

Connecting a results site#

Connections (top bar on the Tournaments page), section Public results site (OpenResults). Enter the Address of the results site (and, where a token is needed, the Token; it is never shown again once saved), then press Test connection. Register again and Try again appear when a connection has failed. The page says whether the results site answered. A desktop copy can register itself with the results site; if that failed, Register again tries again. Until an address is set, the switch for a tournament does nothing.

Publishing a tournament#

Settings, OpenResults.

On the results site: three choices.

What the public sees, round by round#

On the Pairings page, a control Released: sets how much of each round is public, in four cumulative levels:

The level is the round's; the results site is the tournament's. The same level also decides what the hall screen and the phone app show, so it works with the tournament Off too: then it applies there only, and the control says so under the round. Switch On the results site to Link only or Listed and every round goes out at the level it already has.

A newly published round starts at Pairings: live results are a deliberate choice. Going down asks first and names what disappears.

Automatic publishing#

Settings, OpenResults, Automatically, one setting for how far up the ladder the program moves each round by itself:

• By hand: nothing moves by itself.
• Pairings once paired: the round's pairings go public when it is paired; an optional delay Pairings go public after N minutes (0: at once).
• + results live: the results go public as they are entered.
• + standings when the round is finished: the standings go public once the round and every round before it are finished.

Finished means every board has a result or is a postponed game. In a round robin, a board nobody has entered stops holding the standings back once a later round is finished: it then counts as a postponed game and the standings say so (see Postponed games).

The automation only ever moves a round up; you can always take a round down by hand, and it stays where you put it.

Before round 1, spectators see the starting ranking (off by default). Without it the public sees only the list of players once a round is public. Once a round is public the setting no longer applies and the page says so; what spectators see from then on is each round's level on the Pairings page. If it was switched on after a round went public, it can still be switched off.

Live boards (off by default, and offered only while the tournament is published). Switch it on when a relay in the hall is sending the moves of the games to the results site: the published pages then carry a Live boards link beside the rounds. The switch only puts the link there. It does not start a relay and does not check that one is running, so with nothing sending moves the link leads to boards that stay in the starting position. Switching it on or off sends the tournament to the results site again. See Turning live boards on. To set up the boards in the hall, see Setting up electronic boards.

What the public page shows#

Switches (advanced) choose which details a published page may show (ratings, titles, federations, clubs, categories, player cards, the standings page, the pairings pages, the columns of the standings, and which tie-breaks), and, separately, whether the working of the tie-breaks is published. A detail you hide is not sent to the results site at all. Hiding a tie-break column does not change the order it decides, and the page says when the order used a tie-break that is hidden. The tie-break working answers a spectator's why am I fourth (the opponent of each round and its value). The Rounds-present column is public only if you tick it. So is Sex: each player's M or F on the standings and the starting list is personal data, so it starts off on every tournament, new or old, and nothing is sent to the results site until you tick it. Ticked, a player with no sex recorded simply shows a dash. Performance is the same kind of tick: each player's performance rating, as on your Players page, goes on the public standings, as of each round, and it is off until you tick it. A player with no finished game has none. Projector and hall display links controls the two cards under the standings, pairings and crosstable that open the projector view and the hall display; it is on unless you untick it. Unticking hides the cards only, the screens still open from their own address. Federation flags draws a small flag beside each player's name and federation code; it is on unless you untick it. It is part of Federations: the tick sits attached to that one and is only offered while Federations is ticked. Untick Federations and no flags are published either; tick it again and the flags tick is back the way you left it. A player listed under FIDE itself, or with a code that names no country, gets no picture.

The hall display#

A full-screen page for a television or projector in the playing hall, at an address shown on the settings page once the tournament is published. The Hall display card (advanced) chooses what it cycles through (pairings, the Find your board list by name, results, standings), seconds per page, how many places of the standings to show, whether to hold on the pairings until the first result of a new round is in, and an Announcement (plain text, up to 500 characters) shown on the screen. Saving sends it at once.

The address#

Share link is the public address (a QR code to it is in the Phone QR dialog on the Pairings page). Move to a new address takes the old copy down, makes a new address and publishes again (use it if a link has leaked). Remove from the results site takes the tournament off the site. When a tournament file or a backup carries a publishing key, you are asked whether to Take over publishing it or Start fresh. On a hosted server, taking over first asks the results site whether that address really belongs to that key; if it does not, nothing is taken over and Start fresh is the way on.

If the operator of the results site deletes the tournament there, the program stops trying: publishing is switched off for it and the page says the results site removed it. Switching it on again only helps once that operator allows it. If the results site answers that it has moved, nothing is sent to the new address on its own: check it, then enter it under Connections.

Teams#

Team tournaments are published too, with team standings and matches.

Entries through the results site#

Entry form on the OpenResults settings page (advanced until it is open) lets players register on the results site: switch on Accepting entries, set when it opens and closes, a maximum number of players, and whether the list of entrants is shown on the form. Entry fee states what taking part costs: an amount and a currency, a free-text note ("free for juniors"), or both. It is only a line on the form; nothing is paid through it. Nobody who enters receives an e-mail from the program or the results site: tell them yourself, using the address you see in the review queue.

With the list of entrants on, Also list entries waiting for your decision (on by default) adds entries you have not decided on, by name only, each marked unconfirmed. Names are typed by strangers, so the list is yours to police: Discard an entry and its name leaves the public list as soon as the results site gets the next copy of the tournament, a few seconds later. Switch the option off to show only accepted players.

Review entries opens the page of entries, where you fetch new ones, accept them as players or discard them (Players and rating lists).

The Live page (projector view)#

Pairings page, More, Local view (the page /t/:id/live of this program): the current round full-screen for a projector, cycling through pairings, results and standings, with a pause button, a leave button and a high-contrast option. It carries no QR codes; those are in More, Phone QR (Results). The page updates itself whenever a result changes. It is served by this program, so the screen must be on the same computer or a computer that can reach it; the public page (above) is for everybody else.

If there is no network#

A change is sent a few seconds after you make it; the label in the top bar says Sending meanwhile. When nothing has changed for spectators (a dialog confirmed with nothing to do, a result typed and taken back at once), nothing is sent, and the label stays as it was. Try again, switching publishing off and on, and a restart of the program always send.

A send that does not arrive is kept and tried again with longer pauses; the status of the connection is shown as a small label in the top bar, and the page says what is wrong. The public page catches up to the hall when the connection is back.

When the program has no words for a failure, the label says so in a plain sentence and keeps the raw error behind Technical detail, for whoever has to report it.