🤔 What is QuizGPT?

QuizGPT is PsyCat Games' amazing tool to automate quiz creation. It is powered by ChatGPT and can generate dozens of quizzes at once.

If you want to create your own quizzes, you need an API key from OpenAI. Open the Options and enter the key.

🤓 Where to start?

Familiarize yourself with the interface. It looks more confusing than it is.

Before you can start creating any quizzes, open the Options and enter the API key you've got from OpenAI.

Start with the basics:

1. Enter a list of quiz titles that share the same values for the prompt creation.
2. If the topic of all quizzes is younger than 2021 or it's quite niche, enter something in the context.
3. Enter the necessary values in the prompt creation.
4. Hit the Generate GPT Quizzes button and wait until every quiz is done.
5. Don't close the tab until everything is done and you've downloaded all the generated files.

🤯 Interface

Quiz Titles

Enter a list of quizzes that you want QuizGPT to generate. Ideally, these quizzes share the commonalities found in the Prompt Creation.

Context

Giving context is optional. But if your topic is younger than 2021 or quite niche, you'll get a better result that way.

Keep in mind to write in singular, not plural! (quiz, not quizzes!) Because ChatGPT doesn't know it generates a bunch, it only knows of the current quiz it generates.

You can also give it ideas on how the results shall look like or whatnot. (Suffice it to say that you probably should only generate one quiz at a time that way 😉) Just tell it what you want. It may still do its own thing since ChatGPT loves to be "creative".

Example young topic:

Pokémon is a Japanese video game, anime, manga, and multimedia franchise ... Pikachu is the most popular Pokémon ever ...

Example of desired results:

The results of this quiz shall be X. Here are some example results the quiz shall feature: ...

Prompt Creation

Self-explanatory: Here is where you can influence how the quizzes should look like and who they are for. Choose between the use of JPGs or GIFs; JPGs use our own database, GIFs uses a random image with the generated keyword from GIPHY.com

Attention: For the results and questions, always write numbers only! Don't be vague. (It's allowed in the answers, though.)

Quiz Style

• PsyCat Games: Questions are a bit more extravagant and have an image. Answers are longer and don't have an image.
• Buzzfeed: Questions are a bit more simple and have no image. Answers are short and have an image.
• Mix: 50% of the questions have the PsyCat Games style, 50% have the Buzzfeed style.

Console

The console gives you feedback on what is currently happening and what was generated last. If an error occurs, it will tell you.

🤖 Options

The options feature four fields that can be manipulated, which then will be used for every quiz generation.

API Key:

Before anything can be generated, enter a working API key from OpenAI in the options.

Reset Fields:

Resets everything to the standard values.

Good Questions:

QuizGPT will use these as templates for what is considered "good practice". Follow the formula of the already entered examples: Question|Answer1|Answer2|etc.

Bad Questions:

Same as Good Questions; just the opposite.

Example Article:

Enter the index.md content of a quiz that has an amazing article. QuizGPT will use exactly this article as a template, so don't mess with this one if you don't need to.

Image Database:

QuizGPT uses these images from our database, if possible. Should you need to update these, they are located in /images/quiz-images/. Don't forget to update this field as well.

👷‍♂️ Generation

After you've entered everything, you're safe to hit the Generate GPT Quizzes button.

Depending on how many quiz titles you've entered, QuizGPT may take a while until everything is done. Lean back and enjoy the show.

Do something else in the meantime, or check whatever the console has to say.

🎨 Final touches

After a quiz is complete, you can download the zip file containing everything but the feature-image.jpg. This image has to be added manually. Below the button to download the zip file QuizGPT tells you which images are new and must be added.

Open the index.md file and see if everything looks like it should be, and change whatever you dislike.

Upload the quiz.js to our Quiz Maker and check the following things:

• Are the results and their descriptions good?
• Are the questions and their answers good?
• Are the questions (and answers) full sentences and not fragments like "On a party you..."? (This would suck for translations!)
• Are all chosen images part of the image database (if they are, they are visible)?
• Do the images make sense?

Change whatever is needed and download the quiz again. You'll get another zip file, in which you'll only need the quiz.js. Only replace the quiz.js in your original folder!

After all that, your quiz is good to go! 😎

👀 Things To Look Out For

There isn't a lot to look out for, actually, but here's a short list:

• The quizzes you enter in the Quiz Titles should share the same prompts and context, or you'll end up with quite weird quizzes.
• Check every quiz after it is generated. Sometimes, there might be a small bug that won't let it work properly. If that's the case, look into it. If you can't find the issue, contact Steve.
• Check if every image the generated quiz uses exists in the database in /images/quiz-images/. If not, replace it in the code or create the image in the database.
• If the quiz failed more than twice, contact Steve.

😱 There was an error; now what?

No worries, that happens sometimes. Just look at the error message. Most of the time, it's just a "fetch error", which means ChatGPT couldn't be reached or something like that. If it is, just hit the Retry button that shows up as soon as all other quizzes are done.

Note: While a quiz is being retried, no other quizzes can be retried or generated. This is normal.

If a quiz that already had an error has another one, repeat the process. If it happens again, contact Steve and send him the error.txt. Don't close your browser tab in the meantime! (Or at least copy everything from the Console and send it to him as well.)

🦄 FAQ

Any questions? Read this FAQ before contacting anyone.

Who do I ask if I have questions or a problem with QuizGPT?

Steve created it and probably knows best. Contact him only if your question can't be answered here.

My quiz takes very long to generate. Why?

The generation process takes time. But every now and then, it takes even longer. Maybe you entered too many questions, results, or answers, or ChatGPT can't be reached, etc. Just wait and do something else in the meantime. If an error occurs, you'll be notified and can try again later after all other quizzes are complete.

QuizGPT says it uses an image that is not in the database. What do I do?

Add the image to the database folder (/images/quiz-images/) or replace it in the quiz.js with something else.

Can I close the tab after I start the generation?

Don't! Currently, QuizGPT only works with your local browser and not via a server. This means that it is not saved! Download everything before you close it. This means you can also force close the generation if you accidentally started the generation.

Can I close the tab after I have downloaded all the quizzes?

Yes. That's the only time you're allowed to close the tab 😜 (except you accidentally start the generation)

I accidentally started the generation. How do I interrupt it?

Just close the tab. Everything will be lost that way.

I accidentally closed the tab while something was generated or before I could download everything. What shall I do?

You fucked up and need to start over again. There is currently no way to retrieve anything that was deleted.