||7 months ago|
|flashcards||7 months ago|
|tests||2 years ago|
|.gitignore||2 years ago|
|LICENSE||7 years ago|
|README.md||7 months ago|
|demo.gif||2 years ago|
|requirements.txt||7 months ago|
|setup.py||7 months ago|
Application for creating and studying flashcards on the command line. Forked from zergov/flashcards.
$ pipx install git+https://codeberg.org/kdwarn/flashcards.git
Creating a Deck and Adding Cards
The app stores flashcards in decks. To create a deck, run
flashcards create. You will then be prompted to provide a name and a description of the deck.
To then add a card to the deck, run
flashcards add and you will be prompted to provide a question and answer for the card and indicate if it's reversible or not.
You can also write the question and answer inside an editor by passing the
-e parameter to the
flashcards add command:
flashcards add -e. This will open vim by default or the editor set to your
EDITOR environment variable.
Add as many cards as you like.
The Selected Deck and Deck Status
By default, after creating a deck, the application automatically selects it. New cards you create will be added to this deck (until you select a different one). Also, the
flashcards status command will show information on the currently selected deck:
$ flashcards status Currently selected deck: Math Number of cards: 1 Description: Some math questions
To select a different deck:
$ flashcards select French Selected deck: French New cards will be added to this deck.
Studying Decks, Editing and Deleting Cards
You can study the currently selected deck with
flashcards study or you can specify a different deck, e.g.
flashcards study German. If you have more than one deck, you can also study them all at once with
flashcards study all.
The app will iterate through the cards, pausing between the question and answer. (And if a card has been marked as being reversible, the question or answer will randomly appear first.) After both the question and answer have been displayed, you can edit the card by pressing "e", delete the card by pressing "d", and quit the session by pressing "q".
By default, the cards will be shuffled before you start studying. To display them in the order they were created in, pass the
flashcards study German --ordered.
Forget if you've already added something to a deck? Search for it with
flashcards search "word_here". The quotes are optional when searching for a single word, but they are necessary if you search for a phrase:
flashcards search "how to quit vim".
Upgrading from 1.x to 2.x
The storage format was changed in version 2.0 from individual json files for each deck to one sqlite database. If you are upgrading from v1.x to v2.x, you must first upgrade to v2.0 (
pipx install https://codeberg.org/kdwarn/flashcards/archive/v2.0.tar.gz). That version will allow you to convert from the old format to the new. After installing version 2.0, simply run
flashcards import. A new
sqlite.db file will be created in the
~/.flashcards directory, along with your old files. If you'd like to delete the old files, please first verify that the cards have been imported properly. (And if not, create an issue here.) Then you can continue on to the latest version (see installation instructions above).