Skip to content

4. Run a Live Session

Time: ~1 minute to test, then you're ready for class

Open the presenter view

Open presenter.html in your browser. You'll see the setup screen.

  • To start a new session, type a name and click "Create New Session"
  • To resume an existing session, click it in the list below

Once loaded, you'll see:

  • The join code in large green text (top right) — project this for your students
  • The question list at the bottom — click any question to make it active
  • Controls — Previous, Next, Show Results, Reveal Answer

Have students join

Students open student.html on their phones (or any browser) and type the 6-character code.

Sharing the link

If you're hosting the files on a server (see Deployment), share the URL directly. Students can also join via student.html?code=A3K7N2 to skip the code entry screen.

Run through questions

  1. Click a question in the list — it appears on all students' screens
  2. Students tap their answer — the response count updates in real time
  3. Click Show Results to display the bar chart / word cloud
  4. Click Reveal Answer to highlight the correct option in green (multiple choice only)
  5. Click Next to move on

After class

Export results for grading or review:

# Quick summary in the terminal
python quiz_manager.py summary A3K7N2

# Full data as JSON
python quiz_manager.py export A3K7N2 results.json

You're done!

From here, the main thing you'll do is write new question files and load them before each class. See: