A simple yet decent flashcard app for desktop - runs on popular operating systems such as Windows, MacOS and Linux. Executable files (.exe, .app, etc) will be available soon.

• This is a basic flashcard app made of Python and Qt. Add some decks and cards, then start reviewing with flashcards mode (real-life flashcards simulation - to review any time) and game mode (play some games with the cards and )
• Python version used here: Python 3.8 or higher.
• Qt version used here: PyQt5 (Qt bindings for Python), with Qt 5.15

• Add decks and cards to study
• Use flashcards mode to review (w/ spaced repetition and process record)
• Edit and delete decks and cards
• Play simple games (multiple choices and box filling) with simple uniform spaced repetition algorithms

Run flashcards.py as the main script (executable files are out soon). Run

   pip install -r requirements.txt

to install all necessary packages from pip.

This is the first thing that shows up when starting the program.

• If there is no deck, click the icon or the Add deck button to add a new deck.
  Note: If nothing shows up after adding a deck, please right-click> Refresh to fix (I will fix this bug soon)
  A deck is displayed as white group boxes with the deck's name, number of cards in the deck and number of cards to review
• The white button on the top: currently, the options from that button is 'Settings' (now is in development)
• To delete a deck, click ... > Delete this deck
• To rename a deck, click ... > Rename this deck

• To access here, click the `View cards list' button
• To add cards, click the Add cards button, and type the information for the front and the back of the card. Adding an image is optional.
  If no card shows up after adding cards, please try Right click > Refresh.
• To delete a card, click ... > Delete this card.
• To edit a card, click ... > Edit this card, and a popup will show to edit it
• To reset the review date, click ... > Reset review date

• From the home page (browse deck mode), click Flashcards Mode.
• Click flip or click on the card to see both faces of the card (like paper flashcards).
• Click > (Next) to move to the next card, < (Previous) to move to the previous card
• Click the Shuffle button to shuffle the deck
• Click the Practice button to practice with game mode

There are two games in game mode: 'multiple choices' and 'filling in the box':

• 'Multiple choice': The back of a card will be asked, and there are four choices with just one correct answer, which is the text in the front of the card
• 'Filling in the box': The back of a card will be asked, and the user needs to type their answers in the grey box below and click Submit to check their answer
• Notes:
  • In the 'Filling in the box' game, don't worry if you type some trailing space or tabs (so-called "whitespace characters") because the program will omit them.
  • The score given will be 10 for each correct answer and 0 for the wrong one.

Notes: CSV is recommended

• To import a deck, go to the home page, click Add deck
  Tick the choice `Import files (JSON, XML and CSV are supported)', choose files
• To export the deck, click ... > Export cards in the expected deck on the home page
• Note: the format of exported file:
  • CSV: id, front, back, "" (any delimiter is accepted, and the whitespace character in the fourth place can be omitted)
  • XML: E.g

        <? xml version="1.0" ?>
        <deck name=demo>
           <card>
              <id>1</id>
              <front>foo</front>
              <back>bar</back>
           </card>
           <card>
              <id>2</id>
              <front>front</front>
              <back>back</back>
           </card>
        </deck>

  • JSON: {id: {"front": front_text, "back": back_text}}.
    E.g:

    {"1": {"front":"Facebook", "back":"The most popular social network where people share and communicate together"},
       "2": {"front":"Github", "back": "A website using git, where people store, share and collaborate on their code"}