Skip to main content

CLI tool converting Language Transfer lessons into Anki flashcards, automating content extraction for efficient language learning.

Project description

project-banner

Language Transfer Flashcards (LTF) is a CLI tool designed to enhance your language learning experience by bridging the gap between Language Transfer's audio lessons and Anki's spaced repetition system. This project transforms the rich content of Language Transfer YouTube lessons into easily digestible flashcards, allowing learners to reinforce their knowledge effectively.

license last-commit repo-top-language PyPI - Version github-actions

About the ProjectInstallationUsageLimitationsAnki: CSV ImportRoadmapContact



About the Project

You can also read more about this project in my Medium blog post.

Key Features

  • 🤖 Automated Extraction: Extracts words, phrases, and sentences with translations from Language Transfer YouTube lessons.
  • 📚 Anki Integration: Generates CSV files ready for direct import into Anki, creating instant flashcard decks (OpenAI API key required).
  • 🔄 Alternative Workflow: Download a text file, containing the prompt and lesson transcript to use with your favorite LLM web interface (e.g., ChatGPT, Claude, etc.).

Why it's Valuable?

  • 🚀 Boost Learning Efficiency: Combine Language Transfer's proven method with Anki's powerful spaced repetition.
  • ⏱️ Save Time: Automate hours of manual flashcard creation.
  • 🛠️ Customizable: Adapt to your preferred workflow, with or without API access.

Build With

python-logo Python

langchain-logo LangChain

typer-logo Typer

Installation

Recommended: Create and activate a virtual environment before installing the tool.

Using pip

pip install language-transfer-flashcards

Using poetry

poetry add language-transfer-flashcards

To verify that everything works and to see all available commands

ltf --help

Configuration with .env file [optional, but recommended]

Create a .env file in your home directory under ~/.ltf/.env with the following variables:

OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>
OPENAI_MODEL_NAME=gpt-4.1-mini
TARGET_LANGUAGE=Swahili

Not sure where to create the .env file in your system?

ltf env-location

To see all available OpenAI model names, check the official docs.

To see all valid values for TARGET_LANGUAGE

ltf csv --help

Note: The OpenAI-related variables are optional if you're not using the API.

Usage

Create flashcards in CSV format - file will be saved in current working directory

ltf csv https://www.youtube.com/watch?v=VIDEO_ID  # assumes .env file exists

Without the .env file, specify your target-language, the OpenAI model name and API key

ltf csv https://www.youtube.com/watch?v=VIDEO_ID -l Swahili -m gpt-4.1-mini -k "YOUR_OPENAI_API_KEY"

Important: Find the YouTube URLs for all Language Transfer lessons here.

Usage without using the OpenAI API

Download the full prompt which is used to extract the content of the language lesson in a txt file.

ltf prompt https://www.youtube.com/watch?v=VIDEO_ID  # assumes .env file exists

If there is no .env file, add your target-language to the command, for example: -l Swahili

Manual Processing

  • Copy the downloaded content into your favorite LLM web interface - recommended: ChatGPT or Claude.
  • The output will be the content of the lesson in CSV format -> English, Translation.
  • Copy the output into a text editor and create a CSV file
  • Import the CSV file into Anki

Limitations

  • AI Imperfections: LLMs may occasionally produce inaccurate translations or misinterpret context.
  • Transcript Quality: YouTube's auto-generated transcripts can contain errors.
  • Content Discrepancies: Flashcards may sometimes differ from the exact lesson content due to transcript and AI limitations. Review your final flashcards before importing them into Anki.
  • Technical Requirements: Basic command-line knowledge is needed.
  • Estimated API Costs per Lesson:
    • gpt-4o: ~$0.01
    • gpt-4o-mini: < $0.0005

Anki: CSV Import

  1. Open Anki
  2. Create or select a deck for your target language
  3. Navigate to File > Import
  4. Select your generated CSV file for upload
  5. Select the correct seperator for your CSV file, configure Import options and click on Import

Roadmap

  • Publish on PyPI
  • Add support for other LLMs (including Ollama)
  • Create a web-based interface for non-technical users

Contact


If you find Language Transfer Flashcards helpful, please consider giving it a ⭐️ on GitHub!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

language_transfer_flashcards-0.1.3.tar.gz (11.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

language_transfer_flashcards-0.1.3-py3-none-any.whl (14.1 kB view details)

Uploaded Python 3

File details

Details for the file language_transfer_flashcards-0.1.3.tar.gz.

File metadata

File hashes

Hashes for language_transfer_flashcards-0.1.3.tar.gz
Algorithm Hash digest
SHA256 c715f5e31f93cacd6f7b8ffe1c18fbd1af1066a4381dff90954ba3c0d06449f2
MD5 ae38ed9f4f665eae0a7dfbee0afa393d
BLAKE2b-256 b1c4884699ba660d6c149215f4dd6c5bf30a4e177d62971c1ed2f50f10bba03b

See more details on using hashes here.

File details

Details for the file language_transfer_flashcards-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for language_transfer_flashcards-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 c79f0a2c5dafa0b0d7a2fa72d36caae53694740f493536d9ad645e4b0da0def9
MD5 0883e42f3462e41e9e543ba295c52c1f
BLAKE2b-256 c49724b1ee837f83a0ed40e7420803ba0a5eabdd9c79c0331e4d20240d0df8c3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page