Skip to content

xPerSki/N5-Quizzler

Repository files navigation

N5-Quizzler

N5-Quizzler

With the use of N5 Quizzler, you can learn the language in a fun and simple way
Learn with flashcards, quizzes, and practice with automated exercises!

V2

How to Run

  • Launch server by running app.py
  • Open server at 127.0.0.1:5000
  • To close the server, simply stop app.py

Environment Variables

FLASK_DEBUG: Flask server debug mode
LOCAL_DEPLOY: Allows saving quizzes automatically in current folder

Features

Features


Flashcards

Flashcards

  • Card will reveal the translation after you click it
  • If the word can be written with Kanji, it will be displayed below

Quizzes / Short Tests

Quizzes

  • Quiz will be generated based on your selected options
  • After clicking Create, it will save your quiz & the answer key

Practice

Practice

  • Translate the word and automatically get feedback if you were correct
  • (Recommended) Install a Japanese keyboard on your PC, as of current version there isn't any other option to type in Japanese

V1

Use Python/CLI to run the script: python N5_CLI.py
To display the options use python N5_CLI.py -h or python N5_CLI.py --help

Options

  • -n, --number                     Number of questions to generate (1-100)
  • -m, --mode                       Set generation mode (0-3)
    • 0 - Kana -> English  
    • 1 - English -> Kana  
    • 2 - Kanji -> Kana      
    • 3 - Kanji -> English  
  • -e, --export                       Export results in pdf file
  • -oh, --only-hiragana         Generate only hiragana words
  • -d, --dark                          Result is customized with black background and white text (dark-mode)

Example

python N5_CLI.py -n 5 -m 0 -oh
python N5_CLI.py --number 5 --mode 0 --only-hiragana

Export

python N5_CLI.py -n 10 -m 1 -e
python N5_CLI.py -n 10 --mode 1 --export

Save Location

  • [./N5-Quizzler]/export/

Results are saved in unique file: Quiz-[file_id].pdf
To see the answers, find document: Quiz-[file_id]-answers.pdf


Troubleshooting

CLI [?]/[X]/invisible characters

  • Open CLI
  • Go to Properties > Font
  • Select a font that supports Japanese characters

Now it should be fixed:

About

An educational app that will help you learn JLPT N5 vocabulary

Topics

Resources

License

Stars

Watchers

Forks

Contributors