This is an Electron-based desktop application that automates the creation of high-quality Anki flashcards. Whether you have a list of words in a text file or a database in Notion, Word2Card uses the power of AI to generate rich content, syncs it to Anki, and even updates your Notion database status.

Home / File Import	Notion Sync Setup	Settings (API Keys)

• Flexible Input: Import words via a simple .txt file or sync directly from a Notion Database.

• AI-Powered Content:

  • OpenAI: Automatically generates definitions, translations, examples, and IPA transcriptions.
  • Azure Speech: Generates high-quality, natural-sounding audio pronunciations.
  • Pexels: Fetches relevant, high-quality images to visualize the vocabulary.

• Seamless Anki Integration: Pushes cards directly to Anki via AnkiConnect.

• Notion Sync-Back: Automatically updates your Notion rows (e.g., marks them as "Done") after the card is successfully created.

Before using the app, make sure you have the following ready:

1. Anki Desktop: Must be installed and RUNNING while using Word2Card.

2. AnkiConnect Extension: This is required for the app to communicate with Anki.

   • Download here: AnkiConnect (Code: 2055492159)
   • Note: Restart Anki after installation.

3. API Keys: You need to provide your own keys in the Settings menu:

   • OpenAI API Key (for content generation).
   • Azure Speech API Key & Region (for audio).
   • Pexels API Key (for images).

(Go to Settings, enter your keys, and hit "Save Keys")

1. Download the installer from your project release channel, or build one locally using the commands in For Developers.
2. Install and launch the application.
3. Open Settings (gear icon) and configure your API keys.
4. Start Creating Cards:
   • File Import: Upload a .txt file (one word per line), choose a Deck name, and click Submit.
   • Notion Sync: Enter your Notion details to fetch words directly (see guide below).

To use the Notion Sync feature effectively, please follow these steps:

1. Duplicate the Template:

   • I've prepared a Notion template compatible with this app. Duplicate it to your workspace: Vocabulary Book

2. Create an Integration:

   • Go to Notion My Integrations.
   • Create a new integration (e.g., named "Word2Card").
   • Copy the Internal Integration Token (starts with secret_...).

3. Connect Database:

   • Open your duplicated database page.
   • Click ... (top right) -> Connections -> Add your new Integration.

4. Get Database ID:

   • Open the database as a full page.
   • The ID is the string of characters in the URL between notion.so/ and ?.

5. Sync:

   • Paste the Token and Database ID into the app's Notion Sync tab.

Review(Front)	Review(Back)	Typing(Front)	Typing(Back)

• This app uses 3rd party APIs (OpenAI, Azure). Please be aware of your usage quotas and billing on those platforms.

• Pexels API has a rate limit (usually 20,000 requests per month), so take it easy!

• Auto-update publishing is not configured in this repository yet. Distribute installers manually until a real update endpoint is set up.

If you want to contribute or build the app from source, here is how to get started. The stack is Electron + TypeScript.

npm install

npm run dev

# For windows
$ npm run build:win

# For macOS
$ npm run build:mac

# For Linux
$ npm run build:linux