Skip to content

nymanjens/quizmaster

Repository files navigation

Quizmaster

CI Status

A web-app for conducting a quiz, including a page for players to enter their answers. Lots of question types are suported, which are configured in a YAML file.

Screenshot

screenshot

Installation

From prebuilt release in zip file (recommended)

  • Install Java 11 (JDK 11) on your server
  • Download "Binaries (compiled files) with demo configuration" from the latest release
  • Unpack the archive and open a terminal in the unpacked folder
  • Run bin/server (UNIX) or bin/server.bat (Windows)
  • Browse to http://localhost:9000

Using a prebuilt docker image

  • Run the following commands:
git clone https://github.com/nymanjens/quizmaster.git
cd quizmaster
docker-compose --file=docker-compose-prebuilt.yml up

Building and running your own release with Docker

  • Run the following commands:
git clone https://github.com/nymanjens/quizmaster.git
cd quizmaster
docker-compose --file=docker-compose-build-locally.yml up

Configuration

  • conf/quiz/quiz-config.yml:
    Configure your quiz here (questions, choices, answers, images, ...). The existing one in the release is a demo config that contains most of the options.

Play

How to set up

Follow these steps to host a quiz:

  • Make your own quiz by editing conf/quiz/quiz-config.yml. You can test your quiz by starting a local server with it (see the installation section above)
  • Host the server somewhere accessible to all players
  • During a quiz, share the link to your server with all players. You can go to the same page and unlock the master controls via the padlock icon (if you configured a masterSecret in quiz-config.yml). The important pages during the quiz:
    • The player's answer submission page: This is what players use to input their answers.
    • The quiz page: This is the screen to show to all players. It shows the questions, player scores and plays audio and video.
    • The master page: This is a screen only for the quizmaster. It allows you to score player answers and generally control the quiz flow.

Shortcuts

  • Quiz navigation
    • left/right: Go to the previous/next step of the question
    • alt + left/right: Go to the previous/next question
    • alt + shift + left/right: Go to the previous/next round
  • Tools during question
    • spacebar: Pause and resume the timer
    • shift + r: Play the current audio/video file from the beginning
    • shift + -/o: Subtract 30 seconds from the current timer
    • shift + =/+/p: Add 30 seconds from the current timer
    • alt + enter: Toggle enlarged image (if there is a visible image)
    • a: toggle the answer to be visible in the master view (http://localhost:9000/app/master)