https://github.com/davep/quizzical

A terminal-based trivia quiz
https://github.com/davep/quizzical

game python python3 quiz terminal terminal-game textual trivia trivia-game trivia-quiz trivia-quiz-game

Last synced: 5 days ago
JSON representation

A terminal-based trivia quiz

• Host: GitHub
• URL: https://github.com/davep/quizzical
• Owner: davep
• License: gpl-3.0
• Created: 2024-01-18T21:55:28.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2024-11-27T10:41:58.000Z (25 days ago)
• Last Synced: 2024-12-17T11:48:34.690Z (5 days ago)
• Topics: game, python, python3, quiz, terminal, terminal-game, textual, trivia, trivia-game, trivia-quiz, trivia-quiz-game
• Language: Python
• Homepage: https://pypi.org/project/quizzical/
• Size: 640 KB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: ChangeLog.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Quizzical

## Introduction

Quizzical is a terminal-based quiz game, using [The Open Trivia

Database](https://opentdb.com/) as the back end.

![Quizzical](https://raw.githubusercontent.com/davep/quizzical/main/images/quizzical.png)

## Installing

### pipx

The package can be installed using [`pipx`](https://pypa.github.io/pipx/):

```sh

$ pipx install quizzical

```

### Homebrew

The package is available via Homebrew. Use the following commands to install:

```sh

$ brew tap davep/homebrew

$ brew install quizzical

```

## Running

Once installed run the `quizzical` command.

## Playing the game

Hopefully the interface is pretty straightforward: run up the application,

use the `New` button to create a new quiz with your choice of parameters,

use the `Run` button to play a game. When you run a new game you'll be shown

the parameters:

![Starting a new quiz](https://raw.githubusercontent.com/davep/quizzical/main/images/start-quiz.png)

and once you start you'll be shown a series of questions; press keys

1, 2, 3 or 4 to answer each one.

![An example question](https://raw.githubusercontent.com/davep/quizzical/main/images/question.png)

Once the quiz is over you can view your results and see which answers were

right and which were wrong:

![Viewing some results](https://raw.githubusercontent.com/davep/quizzical/main/images/results.png)

## Getting help

If you need help, or have any ideas, please feel free to [raise an

issue](https://github.com/davep/quizzical/issues) or [start a

discussion](https://github.com/davep/quizzical/discussions).

## TODO

Things I'm considering adding or addressing:

- [ ] Add session token support (less frequent question repeats).

- [ ] More quiz information in the main quiz list.

- [ ] Record scores for each game played, provide a history view.

- [ ] Allow answering a question with the mouse.

[//]: # (README.md ends here)