The quiz folder

One folder with everything in it, and one button that loads the whole evening: the round files and the score file. The app works out from the file names what belongs to which round.

The layout

Quiz SLOS 2026\
  Scorebord_eindstand.xlsx              <- score file, in the root
  settings.yaml                         <- the folder names
  1_Questions\
    template.yaml                       <- the layout of the regular rounds
    Q01_R1.yaml                         <- the questions of round 1
    Q02_R2_Music.yaml                   <- the title may be in the name, but need not
  2_Questions_table\
    template.yaml                       <- the layout of the table rounds, separately
    T1_Table_round_1.yaml
  3_Answers\
    A01_R1.yaml                         <- points to the questions of round 1
    A03_T1.yaml
  4_Audio\          audio you use in the rounds
  5_Video\          video you use in the rounds
  6_Images\         pictures you use in the rounds, including the background and the logos
  9_Extra\          everything that is not quiz but is shown: sponsors, a break image

The folder names are fixed: the app recognises them by name. In 4_Audio, 5_Video and 6_Images you put the material the round files refer to - by bare file name (photo.jpg); that it lives in 6_Images is what settings.yaml in the root says. That way the references stay valid when you copy the quiz folder to another computer. 9_Extra is where the photo list of the photo and background screens comes from.

Naming

Kind	Pattern	Example
Questions	`Q<nr>_<code>.yaml`	`Q03_R3.yaml`
Answers	`A<nr>_<code>.yaml`	`A03_R3.yaml`
Table round	`<code>_<title>.yaml`	`T1_Table round 1.yaml`
With the title in the name	`Q<nr>_<code>_<title>.yaml`	`Q03_R3_Music.yaml`

The title part may be left out, because the title is in the file itself: then you never have to rename when a round changes its name. Only template.yaml does not count as a round.

The number decides the order in the list.
The code (R1, T3) links the file to the column header in the score file. If it does not match, the round is listed but without a title.
In the title, underscores stand for spaces.
A trailing vragen (questions) or antwoorden (answers) is left out of the list, because the heading above already says it.

The answers are numbered consecutively across ordinary rounds and table rounds, in the same order as the columns in the score file.

Table round questions never reach the audience screen. Those go on paper. They are only in the folder so the app knows which title belongs to which code; their answers do get shown.

The score file

One Excel file in the root. The rounds are rows, the teams are columns. The app reads the first worksheet, whatever it is called.

Column	Contents
A	The full round name, as you call it yourself.
B	The short code for on screen: `R1`, `T3`.
C onwards	One column per team, with the team name as header.

Half points are allowed. Columns called total, totaal, %, punten or score are recognised as the closing columns and do not count as teams.

An empty cell means: not played yet - explicitly not zero. A lot hangs on that: it is how the app knows which rounds the standings should show, and whether the heading should read Final or Interim standings. So only fill in a round once it has really been played.

Updating during the quiz

The file may stay open in Excel all evening, on another computer too. The app checks every few seconds whether it changed and updates the audience screen within a second. The standings slide along to the newly filled-in round.

The app writes nothing of the quiz itself into the quiz folder - not even the ticks for what you have already shown. Those live in your own settings under %APPDATA%\Quizmaster. The only exception is a few small helper files (.schema.json) it places next to the round files; it never touches the contents of a round.

The quiz name

The name the control screen shows at the top comes from the file name of the score file: everything up to and including the first underscore is dropped. Of Scorebord_eindstand.xlsx, eindstand remains.

Above the standings something else appears, namely the name of the folder, with underscores as spaces. So Quiz_SLOS_2026 becomes Quiz SLOS 2026 on the audience screen.

Checking that everything is right

Before the evening starts you can have the folder checked. That reports for every round file which code and title the app extracts, and warns about round codes without a column in the score file:

cargo run --bin quizinfo -- "C:\Temp\Quiz SLOS 2026"