A comprehensive guide to creating and sharing quizzes
QuizBuzz is a web-based quiz application that allows users to create and share quizzes via Pastebin or other text-sharing services. This documentation explains how to properly structure your quiz data and share it with participants.
The quiz data must be in JSON format with the following structure: if using llm to generate the quiz data, make sure to follow the rules below.
1. Ensure valid JSON format with correct syntax and no trailing commas.
2. Escape backslashes as \\ and quotes as \".
3. Use inline LaTeX for math ($...$) and avoid nested $.
4. Each option must have a unique "no" (1, 2, 3, etc.).
5. Questions and options must not be empty.
6. Ensure correctoption references valid option numbers.
7. No excessive LaTeX; use short expressions within $...$.
8. Ensure UTF-8 encoding (Greek letters, etc.) is supported.
{
"questions": [
{
"category": "Category Name",
"subcategory": "Subcategory Name",
"question": "Your question text?",
"options": [
{"no": 1, "option": "First option"},
{"no": 2, "option": "Second option"},
{"no": 3, "option": "Third option"}
],
"correctoption": [1, 2] // Array of correct option numbers
}
// More questions can follow in the same format
]
}
To create a quiz, follow these steps:
{
"category": "Science",
"subcategory": "Physics",
"question": "What is the speed of light?",
"options": [
{"no": 1, "option": "300,000 km/s"},
{"no": 2, "option": "150,000 km/s"},
{"no": 3, "option": "450,000 km/s"}
],
"correctoption": [1]
}For questions with multiple correct answers, include all correct option numbers in the "correctoption" array:
{
"category": "History",
"subcategory": "World War II",
"question": "Which countries were Allied powers in WWII?",
"options": [
{"no": 1, "option": "United States"},
{"no": 2, "option": "Germany"},
{"no": 3, "option": "United Kingdom"},
{"no": 4, "option": "Japan"}
],
"correctoption": [1, 3]
}Users will have to select all correct options to receive credit for the question. Partial credit is not awarded.
Follow these steps to host your quiz on Pastebin:
For URL https://pastebin.com/abc123xyz, the Room ID is abc123xyz
In addition to Pastebin, you can host your quiz JSON on any accessible URL:
The application will attempt to use various proxies if direct access fails due to CORS restrictions.
The Room ID system makes it easy to share your quiz with participants. Simply share the Pastebin ID with them, and they can enter it in the Room ID field.
You can also pre-fill the Room ID by adding it to the URL:
https://yourquizurl.com?roomid=PASTEBIN_IDMake sure your Pastebin is set to "Public" or "Unlisted" to ensure participants can access it.
You can organize your questions using categories and subcategories. This allows participants to filter questions by these groupings.
{
"category": "Geography",
"subcategory": "Europe",
"question": "What is the capital of France?",
...
}Use consistent category and subcategory names across questions to create logical groupings. Participants can select which categories and subcategories to include in their quiz.
The quiz creator can specify what percentage of questions to include from the available pool. The app will randomly select that percentage of questions, helping create varied quiz experiences from the same question set.
If you have 100 questions in your question pool and set the percentage to 50%, the app will randomly select 50 questions for the quiz.
QuizBuzz supports LaTeX for displaying mathematical formulas in questions and options.
{
"question": "What is the formula for the area of a circle? $A = \\pi r^2$",
"options": [
{"no": 1, "option": "Area = $\\pi r^2$"},
{"no": 2, "option": "Area = $2\\pi r$"},
{"no": 3, "option": "Area = $\\pi d^2$"}
],
"correctoption": [1]
}$formula$$$formula$$\\alpha for \alphaInvalid LaTeX syntax will be highlighted in red in the quiz. Test your formulas before including them.
QuizBuzz includes background music and sound effects to enhance the quiz experience:
Sound may require user interaction before playing due to browser autoplay policies.
QuizBuzz offers two shuffling options to create varied quiz experiences:
Both options can be toggled on/off in the quiz settings screen before starting the quiz.
Using both shuffling options helps prevent memorization and creates a fresh experience each time.
Quiz scores are calculated based on entirely correct answers:
At the end of the quiz, you'll see:
After completing the quiz, you can review all questions you answered incorrectly:
Use the wrong answers review to focus your studies on areas that need improvement.
QuizBuzz includes several additional tools to help you create and manage quiz content more effectively.
The Data Builder tool allows you to combine multiple quiz JSON files into one comprehensive quiz dataset. This is particularly useful when you have multiple quiz files that you want to merge together.
The Data Builder will show error messages for any invalid JSON inputs, helping you identify and fix formatting issues before combining.
The Slide Builder tool converts your quiz JSON data into PowerPoint presentations, making it easy to create educational slides for classroom use or presentations.
Generated PowerPoint files are compatible with Microsoft PowerPoint, LibreOffice Impress, and Google Slides. The presentations use standard fonts and formatting for maximum compatibility.
For very large quiz datasets (500+ questions), generation may take some time. The progress bar will show the current status.