Flashcards App Guide

Overview

This is a simple app for learning languages using flashcards. It works offline after loading a file and lets you study words, hide them, edit them, test your knowledge, and switch display modes.

Navigation

Use the top menu to navigate:

• Home: Main page for loading files.
• Cards: View and study words with flashcards.
• List: See all words, manage hidden ones, and edit words.
• Test: Test your knowledge.
• Mode: Switch between day and night modes.
• Lang: Change language direction (e.g., English to Russian or vice versa).
• Info: This guide.

Using the Tabs

1. Home
   • Load a File: Click "Load" and select a JSON file from your device. You'll be taken to "Cards" after loading.
   • Recently Loaded Files: Lists recently loaded files. Click a file name to reload it or "Delete" to remove it.
   • Server Files: "Files Loaded from Server" shows preloaded files. Click the header to expand and select a file.
2. Cards
   • Shows one word at a time. Click the card to see its translation.
   • Controls:
     • ← / →: Switch between words.
     • Hide: Hide the current word (removes it from cards and tests).
     • Speak: Hear the word aloud (requires internet for voice loading).
     • Play: Auto-play words with translations (click again to pause).
     • Examples: Show usage examples (if included in the file).
3. List
   • Displays all words from the file.
   • Checkboxes: Check to hide a word.
   • Edit: Click the pencil icon (✎) next to a word to edit it. A window will open where you can change the word and its translation. Changes are saved in the app's memory, not in the original file.
   • Buttons: "Hide all" (hide all words), "Show all" (show all words), and "View JSON" (view active words in a modal).
   • Click a word to switch its language.
4. Test
   • Shows a word; type its exact translation in the input field (case-insensitive, punctuation ignored).
   • Click "Test" or press Enter to check. The card turns green (correct) or red (incorrect). If correct, it moves to the next word.
   • ← / →: Manually switch between words.
5. Mode
   • Toggles between day (light background) and night (dark background) modes.
6. Lang
   • Switches the display direction of words (e.g., English to Russian or vice versa). Works only after loading a file.

Creating Your Own JSON File

The app uses JSON files. Example structure:

{
  "filename": "en_ru_basic.json",
  "name": "Basic EN-RU Vocabulary",
  "words": [
    {
      "word_EN": "house",
      "word_RU": "дом",
      "examples": [
        {"ex_EN": "This is my house.", "ex_RU": "Это мой дом."}
      ]
    },
    {
      "word_EN": "cat",
      "word_RU": "кот",
      "examples": [
        {"ex_EN": "The cat is on the roof.", "ex_RU": "Кот на крыше."}
      ]
    }
  ]
}

filename: File name (any). name: Vocabulary name (shown in the app). words: List of words with word_[language code] keys (e.g., word_EN, word_RU) and optional examples.

Save this text as a .json file (e.g., my_words.json) and load it via "Load" on the "Home" tab.

Generating a JSON File with AI

Use any AI (e.g., ChatGPT, Grok) to create a JSON file with your desired words and examples. Example prompt:

Prompt: "Generate a JSON file for learning English and German. Include 5 words with translations in English (word_EN) and German (word_DE), plus one example per language (ex_EN and ex_DE). Format it for a flashcard app."

Sample AI Response:

{
  "filename": "en_de_vocab.json",
  "name": "English-German Vocabulary",
  "words": [
    {
      "word_EN": "book",
      "word_DE": "Buch",
      "examples": [
        {"ex_EN": "I read a book.", "ex_DE": "Ich lese ein Buch."}
      ]
    },
    {
      "word_EN": "dog",
      "word_DE": "Hund",
      "examples": [
        {"ex_EN": "The dog is barking.", "ex_DE": "Der Hund bellt."}
      ]
    },
    {
      "word_EN": "tree",
      "word_DE": "Baum",
      "examples": [
        {"ex_EN": "The tree is green.", "ex_DE": "Der Baum ist grün."}
      ]
    },
    {
      "word_EN": "house",
      "word_DE": "Haus",
      "examples": [
        {"ex_EN": "This is my house.", "ex_DE": "Dies ist mein Haus."}
      ]
    },
    {
      "word_EN": "car",
      "word_DE": "Auto",
      "examples": [
        {"ex_EN": "I drive a car.", "ex_DE": "Ich fahre ein Auto."}
      ]
    }
  ]
}

1. Copy this text into a text editor (e.g., Notepad).
2. Save it as a .json file (e.g., en_de_vocab.json).
3. Load it into the app via "Load" on the "Home" tab.

This way, you can customize your vocabulary by specifying languages, word count, and examples to the AI.