info

๐Ÿ”— ReallyBasicVocab

๐Ÿ“ฃ Simple open-source app to manage your flashcards.

๐Ÿ”’ Your flashcards stay on your device: no account, no ads, no internet access.


๐Ÿ›๏ธ App structure: filing boxes -> decks -> flashcards


๐Ÿ—ƒ๏ธ Filing boxes can be exported as and imported from a backup (individually or all at once).

๐Ÿ—‚๏ธ The decks of a filing box contain the flashcards.

๐ŸŒˆ You may use four color variants for filing boxes and decks.


๐Ÿ“‡ Flashcards offer a front as well as a back side, optional notes and the learning progress.

๐ŸŒ You may set the language of the front and back for each filing box and / or deck.

๐Ÿ–Œ๏ธ You may activate flashcard formatting and / or Markdown notes in the app settings.

๐Ÿ“Ž You may link images and other files to flashcards.

๐Ÿท๏ธ You may add tags to flashcards.

๐Ÿ–จ๏ธ You may print flashcards.


โ–ถ๏ธ From each flashcard list you may enter a query mode.

๐Ÿ” Flashcard lists for the entire collection as well as single filing boxes or decks are available. Using the โ€œadvanced queryโ€ option you may generate lists of all or some decks by tags, progress and / or last repetition.


๐Ÿ“ฅ You may import a simple CSV file in the specified format (e.g. exported from a spreadsheet).


โ— Please back up your content on a regular basis.

๐Ÿ”— Why backups are important

As this app does not store data anywhere but on your device you need to export your data as backup from time to time to prevent data loss if your phone breaks or gets lost. Additionally, you should back up the app media folder if you add media to flashcards.

If you export all filing boxes an output file is created and additionally you can share the backup (e.g. by sending an email to yourself) after the export finished. If you export a single filing box the share dialog is the only option.

Imports and exports run in the background, so you can leave the app in the meantime. A notification shows the progress (on Android 13 and newer only if you allow notifications; the import or export works without it as well). The result is shown in the app as soon as it is done, or when you return to the app.

Do not stop the app completely during an import (e.g. with โ€œForce stopโ€): an interrupted import is not continued, the entries imported until then are kept. An interrupted export is started again automatically.

๐Ÿ”— Why filing boxes exist

Many flashcard apps have two levels, decks and flashcards, but ReallyBasicVocab also offers a third level, the filing boxes. The idea behind this is a better separation of different learning fields.

๐Ÿ”— Formatting

Flashcards support bold-italic (***text***), bold (**text**), italic (*text*) and underlined (_text_) text if enabled in the app settings. Notes can be written in Markdown if enabled in the app settings.

๐Ÿ”— Languages of flashcards

You can choose the language of the flashcard fronts and backs for each filing box and deck. A deck without a chosen language uses the one of its filing box.

If no language is chosen, the app detects it per deck from its flashcards (on Android 10 and newer, on your device, only if the result is clear). Otherwise, the device language is used.

The language is used:

- by screen readers (e.g. TalkBack), which read the flashcards with the matching pronunciation;
- for the matching font, e.g. for Chinese or Japanese characters;
- for the keyboard language when editing flashcards (if the language is enabled in your keyboard);
- for the alphabetical order of flashcard lists;
- when printing, e.g. for hyphenation.

Backups contain the chosen languages, not the detected ones.

๐Ÿ”— Swipe gestures in query mode

Swipe anywhere on the flashcardโ€ฆ

โ€ฆto the right: previous flashcard.
โ€ฆto the left: next flashcard.

Swipe from the edge to centerโ€ฆ

โ€ฆfrom the top: mark as not known (available after displaying solution).
โ€ฆfrom the bottom: mark as known (available after displaying solution).

With a device language written from right to left (e.g. Arabic), left and right are swapped.

๐Ÿ”— Learning progress

Each flashcard has a progress value, starting at 0.

In query mode, marking a flashcard as known increases its progress by 1. Marking it as not known decreases the progress by 1 (but not below 0), or resets it to 0 if this is activated in the settings.

In the flashcard details, you can also change the progress with the โ€œ+โ€ and โ€œโˆ’โ€ buttons.

Every change of the progress counts as a repetition: the time of the last repetition and the number of repetitions are updated. Sorting and the advanced query use these values.

๐Ÿ”— Sort flashcard lists

Sort by progress: Sort by progress ascending, then by creation time descending.

Sort randomly: Shuffle flashcards.

Sort alphabetical by flashcard front: Sort alphabetical by flashcard front ascending, then alphabetical by flashcard back ascending. The order follows the rules of the language of the flashcard side if all flashcards in the list share it (e.g. รค: in German like a, in Swedish after z), otherwise those of the app language.

Sort by last repetition: Sort by time of last repetition descending, then by creation time descending.

Sort by mixed learning criteria: Sort by three criteria: low progress, progress / repetition counter ratio and randomly.

๐Ÿ”— Media files

Files you link to flashcards are copied into a folder you select. The app asks for this folder when you add the first file.

Backups only contain the links to the files (option โ€œInclude media linksโ€ when exporting), not the files themselves. To keep your media, also back up the media folder. After restoring a backup on another device, copy the folder there and select it in the app; the app asks for it if links exist but no folder is selected.

In the settings, you can choose whether the media files are shown in other apps (e.g. gallery).

๐Ÿ”— Limitations with flashcards

If a list of flashcards contains more than 15000 flashcards the following limitations are applied to increase performance:

- If the setting to format flashcard front and back is activated: List display and search results are in some cases inaccurate. All possible characters for formatting (* and _) are removed from the flashcard front and back even if they are not part of the formatting.

Example: โ€œ*1* * 1โ€ would normally display as โ€œ1 * 1โ€ in the list, but now is shown as โ€œ1 1โ€.

- Non-Latin scripts: Search may be inaccurate as the text is converted to lower case instead of being compared case-insensitive.

- Alphabetical order: Flashcards are compared character by character, ignoring case, instead of following the rules of a language (e.g. รค after z, also in German).

๐Ÿ”— Other limitations

You can print up to 12 images attached to a flashcard.

Printing is available for up to 100 selected flashcards, โ€œselect allโ€ for lists of up to 1000 flashcards.

๐Ÿ”— Technical info: Backup file format

The backup is a UTF-8 encoded CSV file in the following format:

"collection_schema","uid","name","desc","date","colors","emoji","front_language","back_language"
"collection","1","ReallyBasicFilingBox","This is a filing box","954540062","1","๐Ÿ“ฃ","en","en"
"packs_schema","uid","name","desc","date","colors","collection","emoji","front_language","back_language"
"packs","1","ReallyBasicDeck","This is a deck.","954540062","2","1","๐Ÿ“ฃ",,
"cards_schema","uid","front","back","pack","known","date","notes","last_repetition","count_repetitions"
"cards","1","ReallyBasicFront","ReallyBasicBack","1","7","954540062","ReallyBasicNote","1012615383","0"
"media_schema","uid","file","mime"
"media","1","my.pdf","application/pdf"
"media_link_card_schema","uid","fileId","cardId"
"media_link_card","1","1","1"
"tags_schema","uid","tag_name","emoji","color"
"tags","1","ReallyBasicTag","๐Ÿ“ฃ","#1b2c66"
"tags_link_card_schema","uid","tagId","cardId"
"tags_link_card","1","1","1"
"app_setting","default_sort","int","0|1|2|3|4"
"app_setting","flashcard_list_side","int","0|1|2"
"app_setting","format_cards","bool","true|false"
"app_setting","format_card_notes","bool","true|false"
"app_setting","query_mode_reset_progress","bool","true|false"
"app_setting","ui_bg_images","bool","true|false"
"app_setting","ui_font_size","bool","true|false"
"app_setting","ui_mode","int","0|1|2"
"app_setting","media_in_gallery","bool","true|false"

๐Ÿ”— Technical info: Simple CSV file import format

You may create flashcards with a simple CSV file and import the core flashcards values to ReallyBasicVocab using the option in the app's menu.

The flashcards are stored in an automatically created filing box and deck and may be integrated into your existing filing boxes from there.

The file must be UTF-8 encoded (in Excel: โ€œCSV UTF-8โ€); other files are rejected. Besides commas, the values may be separated by semicolons, tabs or vertical bars (|); the app chooses the separator that fits the first rows.

The simple format has two variants you may use and combine as you please (rows with other numbers of columns are not imported):

"front","back","notes"
"front","back"