Your exam control room, fully explained

From blank page to published result

Teachers control the whole lifecycle. Create the pool, choose who can join, start the shared clock, watch the live roster, end the exam and export the result.

Every exam option

Late joining

Once an exam is live, a completely new student is never admitted automatically. Their request appears above the roster. Check the exact name and registration number, then use Approve, Reject, or Approve all. Duplicate names and registration numbers are rejected before approval.

During and after the exam

Question analysis, and fixing a wrong answer key

Once an exam has ended, its card carries a Question analysis button. It opens a page with one block per question showing exactly what the class answered: how many students chose each option, how many left it blank, and — for typed questions — every distinct answer that was given, most common first. The counts cover the papers that were submitted and not disqualified, which is the same set the marks are computed from.

This is how a mis-keyed question is usually caught: not by re-reading the paper, but by seeing most of the class choose the same “wrong” option. So the fix sits next to the evidence. Each block has Correct answer, which lets you set a different correct option, a different set of options, or a different accepted pattern for a typed answer.

Students see the corrected mark the next time they open their result; anyone still looking at their review sees it update on the spot. If results are being withheld, a correction changes the marks silently and students see nothing until you release them.

Strict by default, recoverable by the teacher

Question answers never need to be trusted to the browser: grading, strikes, identity, session ownership and result access are checked by the server.

If a phone fails and the student needs a laptop

1. The student closes the failed phone browser and tells the teacher.
2. The teacher finds that student in the roster and chooses Reset device. This revokes the old token, disconnects the old session, and clears any block together with its warnings — one action, nothing else to press.
3. The student signs in on the laptop with their registration number. For this one re-entry the name does not have to be punctuated exactly as before, so a student who first typed “Md. Karim” and now types “Md Karim” still gets back in. The laptop becomes the new bound browser.
4. Previously autosaved answers return. The shared deadline does not change, so the most recent unsaved keystrokes or time lost during the switch cannot be restored.

Changing a running exam

The full editor closes when an exam starts, because rewriting the question paper would break the papers already handed out. Three changes stay open, from ✎ Edit while live on the exam card.

• Add an IP range — for a student who turns up on a different network. Adding is always safe; narrowing the list while the exam runs can cut off someone mid-paper.
• Add a registration number — for a name missing from the allow-list. Both rules are checked when someone joins, so changing them never affects anyone already writing.
• Add questions — pasted in the same format as the bulk import. Choose every student to put them on every paper still open and on everyone who joins from here on, or the random pool only to leave current papers alone. Students already in the exam see the extra questions appear without reloading. A student who has already submitted keeps the paper they were marked on.

Removing a student from the list

Remove from list in a roster row’s ⋯ menu deletes the attempt entirely — the name, the registration number, the browser binding, the warnings and any answers so far. It is the one action that means they never joined, so their registration number is free again and they can start over. Use it for a student in the wrong exam, a duplicate row from a mistyped number, or your own test join.

1. The removed student’s page returns to the join form by itself and says you removed them.
2. They join again through the normal route. Before the exam starts, they go straight back onto the roster.
3. Once the exam is live, they arrive in the late entry queue and you approve them like any other latecomer — removing someone is never a way to re-admit them silently.

Warning and block rules

• Desktop focus/fullscreen/visibility violations accumulate; three warnings block the attempt.
• On mobile, leaving the browser or app for more than five seconds can block immediately.
• A network loss longer than the configured disconnect grace adds a warning unless the teacher configured flag-only mode.
• Connecting another monitor is checked where the browser supports multi-screen detection.
• System notifications are not required. All enforcement and recovery happens inside QuizCast.

Build one question at a time

Choose Add question when you want the clearest, most visual workflow. Every change appears in the Preview below the question, exactly as students will see it.

1. Select the answer type, then write the question and its answers.
2. Set marks, topic, sharing and an optional figure.
3. Check the live Preview, then add the next question.

Everything you can set

Create a pool from a .txt file

Bulk import is fastest when you already have many questions. Write ordinary text in any editor, paste it into Import questions from text, or upload a UTF-8 .txt file.

1. Write one question block after another using the syntax below.
2. Choose Preview and fix any reported line.
3. Use Add to pool to keep existing questions, or Replace pool to discard the current draft pool.

The smallest valid block

Start with Q:. Put each answer on its own line. An asterisk * means correct; a hyphen - means incorrect. Blank lines between blocks are optional but recommended.

Q: Which symbol starts an Excel formula?
* =
- #
- @

What every text marker means

The three question formats

# SINGLE CHOICE — exactly one *
Q: What is the default QuizCast port?
* 3000
- 8080
- 443

# MULTIPLE CHOICE — one or more *
[multi] Q: Which are private IPv4 ranges?
* 10.0.0.0/8
- 8.8.8.8/32
* 192.168.0.0/16

# TEXT ANSWER — regex after =
[text] Q: Which function adds A1:A10?
= ^=?sum\(a1:a10\)$
answer: =SUM(A1:A10)

Marks, topics and defaults

Put marks:, topic: and all: inside one question to affect only that question. Put @marks: or @topic: above a group to set a default for everything that follows. A per-question value overrides the group default. There is no @all:, which prevents accidentally making a whole file mandatory.

@topic: Geometry
@marks: 2

Q: What is the area of a circle of radius $r$?
* $\pi r^2$
- $2\pi r$

# This question overrides the 2-mark default
Q: What do a triangle's angles sum to?
marks: 1
all: yes
* $180^\circ$
- $360^\circ$

@topic: none
@marks: 1

Complete copyable template

# QuizCast bulk question template
# Outside a question, # or // starts a comment. Use // inside a question.

@topic: General knowledge
@marks: 1

Q: What colour is a clear daytime sky?
* Blue
- Green
- Red

Q: What is the capital of Australia?
marks: 2
* Canberra
- Sydney
- Melbourne

[multi] Q: Which of these are programming languages?
* JavaScript
* Python
- HTML
- CSS

@topic: Mathematics
@marks: 3

[text] Q: Solve for $x$: $2x + 5 = 15$.
= ^5$
answer: 5

Q:
## Use the reference table

| Item | Qty | Price |
|:-----|:---:|------:|
| Pen  |  2  | \$3.00 |
| Book |  1  | \$8.00 |

Which expression gives the total?
* `2 * 3 + 1 * 8`
- `2 + 3 + 1 + 8`

Common Preview errors

Final example: formatted bulk questions

This ready-to-import example uses bold, italic, inline code and maths while keeping every question and option on the lines understood by the bulk parser.

# Formatted questions still use the normal bulk markers.
@topic: Mixed practice
@marks: 2

Q: Solve the **linear equation** $2x + 5 = 15$.
* **$x = 5$**
- $x = 10$
- $x = 20$

[multi] Q: Which are *valid* JavaScript declarations?
* `const total = 10;`
* `let name = "Asha";`
- `number score = 5;`
- `make value = 2;`

[text] Q: Type the chemical formula for **water**, shown as $H_2O$.
= ^h2o$
answer: H2O

Q: Read the [reference note](https://example.com) and choose the value of $\sqrt{81}$.
* **9**
- 8
- 10

Make questions clear and expressive

Question text and choice options support Markdown. Maths is written with LaTeX-style commands and rendered by KaTeX. The examples below show the text you type beside the result students see.

Bold, italic and strikethrough

Wrap text with the matching symbols. You can combine bold and italic.

Use **bold** for key facts.
Use *italic* for emphasis.
Use ***both together***.
Use ~~strikethrough~~ for a correction.

Headings, paragraphs and separators

Use one to four # symbols for headings. Leave a blank line for a new paragraph. Three hyphens make a horizontal separator. A normal single line break is also preserved in QuizCast.

## Read the passage
This is the first paragraph.

This is a second paragraph.

---
### Now answer

Bulleted and numbered lists

Use - for bullets and 1. for numbered steps. Indent nested items with spaces.

Consider these conditions:

- The server is online
- The code is correct
  - Uppercase is accepted

Then:
1. Join the exam
2. Wait for the teacher

Quotes and links

Start a quote with >. Write a named link as [label](https://address). A bare web address becomes a link automatically.

> Knowledge is power.

Read the [course notes](https://example.com/notes).
Or visit https://example.com

Inline code and code snippets

Put one backtick around a short command or variable. Put triple backticks above and below a multi-line code block. A language name after the opening fence is allowed, although syntax colouring is not applied.

What does `total` contain?

```javascript
const price = 25;
const total = price * 4;
console.log(total);
```

Tables

Separate columns with vertical bars. The second row is required; colons set left, centre or right alignment.

| Item | Qty | Price |
|:-----|:---:|------:|
| Pen  |  2  | \$3.00 |
| Book |  1  | \$8.00 |

Inline and display maths

Put maths inside single dollar signs to keep it in a sentence. Use double dollar signs on separate lines for a centred display equation.

The roots of $ax^2+bx+c=0$ are:

$$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$

Useful maths commands

Matrices and multi-line equations

Use an environment inside a display-math block. Separate columns with & and rows with \\.

$$
A=\begin{bmatrix}
1 & 2 \\
3 & 4
\end{bmatrix}
$$

$$
\begin{aligned}
2x+5 &= 15 \\
2x &= 10 \\
x &= 5
\end{aligned}
$$

Show Markdown symbols literally

Put a backslash before a Markdown symbol when it should appear as ordinary text. Inline code is another easy way to show syntax literally.

\*This is not italic\*
\# This is not a heading
The symbol is \$5, not maths.
Type `**bold**` to make text bold.

Fast answers during a live exam