QuizMasterMini Tutorial

Introduction

Welcome to the QuizMasterMini tutorial! QuizMasterMini is a scaled-down version of QuizMaster, designed for users with limited device resources or low bandwidth. Despite its compact size, QuizMasterMini retains many of the core functionalities of QuizMaster, ensuring a seamless quizzing experience.

Table of Contents

• Installation
• Home Screen
• Playing a Quiz
• Creating a Quiz
• Troubleshooting
• Conclusion

Installation

To install QuizMasterMini, follow these simple steps:

1. Clone the repository:

   Clone this repository via terminal: git clone --recurse-submodules https://github.com/QuizMaster-world/QuizMasterMini

2. Navigate to the QuizMasterMini directory:

   cd QuizMasterMini

3. Run the following commands:

   Linux:

   python3 -m venv venv

   Windows:

   python -m venv venv

4. Activate the environment:

   Linux:

   source venv/bin/activate

   Windows:

   call venv\Scripts\activate

5. Install tkinter:

   Linux:

   sudo apt-get install python3-tk

6. Install dependencies:

   Linux:

   pip3 install -r requirements.txt

   Windows:

   pip install -r requirements.txt

Home Screen

When you launch QuizMasterMini, you’ll see a simplified home screen with two options:

• Play a Quiz: Start playing a quiz from the available options.
• Make a Quiz: Create a new quiz using the built-in quiz editor.

Click on the desired option to proceed.

Playing a Quiz

Follow these steps to play a quiz in QuizMasterMini:

1. From the home screen, click on Play a Quiz.
2. Select a quiz from the list of available quizzes.
3. Answer each question by selecting the correct option from the listbox.
4. After completing the quiz, your score will be displayed.

Creating a Quiz

To create a new quiz, follow these steps:

1. Click on Make a Quiz from the home screen.
2. Enter a title for your quiz.
3. Add questions by filling out the following fields:
   • Question: Enter the quiz question text.
   • Correct Answer: Provide the correct answer.
   • Incorrect Answers: List the incorrect answer options, separated by commas.
4. Save the quiz when you’re done.

Your saved quiz will be available for playing under the Play a Quiz section.

Troubleshooting

Common Issues and Solutions

• Python Module Conflicts: Use a virtual environment to prevent dependency conflicts.
• Windows Setup Errors: Ensure you’re using the correct version of Python and have all necessary dependencies installed.
• Missing Quizzes: Check that the quizzes are saved in the correct directory.

Getting Help

If you encounter further issues, visit our GitHub repository for support or submit an issue.

Conclusion

QuizMasterMini is a lightweight and efficient solution for users who want a basic yet functional quizzing platform. Whether you're playing or creating quizzes, QuizMasterMini ensures a smooth experience while consuming minimal resources. Happy quizzing!