Skip to content

About

German Study Kit

Resources

Stars

8 stars

Watchers

0 watching

Forks

Repository files navigation

German Study Kit

A reproducible Anki deck pipeline for learning German from A1 to B2. Markdown source files compile into .apkg decks with TTS audio for every sentence — no manual card creation.

Built for self-study, but anyone can use it. If you just want to study, jump to Quickstart. If you want to edit content or fork the kit, see Building from source.

What's inside

Ten Anki deck files, ~6 200 cards total, all with neural TTS audio (de-DE-KatjaNeural via Microsoft Edge).

Deck Topics Cards Description
A1.apkg 16 grammar ~960 Personalpronomen, modals, Akkusativ, trennbare Verben, Perfekt, …
A2.apkg 18 grammar ~1 080 Dativ, Wechselpräpositionen, Adjektivdeklination, Nebensätze, Konjunktiv II höflich
B1.apkg 18 grammar ~1 080 Konjunktiv II, Passiv, Genitiv, Relativsätze, Plusquamperfekt, Konnektoren
B2.apkg 18 grammar ~1 080 Konjunktiv I, Partizipien, Doppelinfinitiv, Funktionsverbgefüge, Nebensätze (vertieft)
verbs.apkg 80 verbs 80 Top irregular verbs with all three principal parts + helper
themen.apkg 12 packs ~430 Survival German + 11 daily-life situations (restaurant, hotel, doctor, …)
A1-review.apkg 16 grammar 256 Cumulative A1 refresher — one gap-fill card per sentence, each with its own grammar tip
A2-review.apkg 18 grammar 252 Cumulative A2 refresher — same format, all A2 grammar in one interleaved deck
German5-100Verben.apkg 99 verbs 327 Course deck for German 5 (A2.2–B1.1) — the Verbentest list with Präsens/Präteritum/Perfekt
German5-Wortschatz.apkg 15 lists 644 Every printed word list in the German 5 Materialsammlung, one subdeck per lesson

Plus markdown reference docs (no Anki): connectors cheat sheet, Goethe exam prep at every level, curated learning resources.

Quickstart

If you just want to study:

  1. Install Anki (free desktop app, also iOS/Android).
  2. Download the .apkg files from anki/out/ in this repo.
  3. In Anki: File → Import → pick the .apkg. Done.

Each .apkg imports as a hierarchy: German::<level>::<NN topic>. So A1 expands into 16 subdecks (German::A1::01 Personalpronomen + sein, German::A1::02 haben, …). You can study one topic at a time — read its .md file in grammar/ for the rule, then study just that subdeck in Anki.

How the cards look

Every grammar sentence produces three card types for thorough learning:

Card type Front Back
Cloze drill German with one word blanked + audio full German sentence + English + grammar note
EN → DE production English sentence German + audio + grammar note
Audio-only listening just plays the audio German text + English + grammar note

The verbs deck has one card per verb: infinitive on front, three principal parts (with helper) on back.

The themen deck has two cards per sentence: EN→DE and DE→EN, no cloze.

The review decks (A1-review, A2-review) are built for revision rather than first contact, so they work differently:

Review card
Front topic label + German sentence with one grammar-critical word blanked + English translation
Back full sentence + audio + a grammar tip written for that specific sentence

One card per sentence — no 3× multiplication — and all 508 sentences are unique, including against the main A1/A2 decks. Everything lands in a single deck per level (German::A1 Review), so topics interleave instead of being drilled in blocks. Source lives in review/; each line is German | English | grammar tip.

German 5 course deck

German5-100Verben.apkg covers the Verbentest list from the course Materialsammlung (S. 12–14). The handout leaves most cells blank; german5/01-100-verben.md has them all filled in, in Swiss orthography (ss, not ß) like the course itself. Four card types per verb:

Card Front Back
DE → EN infinitive + audio English + full Stammformen
EN → DE English infinitive + audio + Stammformen
Stammformen infinitive Präsens / Präteritum / Perfekt + audio + a Perfekt example sentence
Präsens-Drill infinitive the er/sie/es form — generated only for the 30 stem-changing verbs

That's 327 cards from 99 verbs. Tags let you filter: unregelmaessig, regelmaessig, gemischt, modal, trennbar, stammwechsel, sein-perfekt.

German5-Wortschatz.apkg covers every printed word list in the Materialsammlung — the 12 lists the handout links to a Quizlet set, plus Alltagsphrasen and Wohnen, which are printed but have no set. Source is one file per list in german5/ws/, each naming its pages and Quizlet link. It imports as one subdeck per list, numbered by lesson:

German5
├── 100 Verben                            327
├── L02 Arbeit und Uni                    100
├── L02 Reflexive Verben                   28
├── L03 Gefühle und Charakter              90
├── L04 Adjektivdeklination Nom/Akk/Dat    50
├── L04 Gesprächsstrategien                24
├── L07 Alltagsphrasen                    115
├── L07 Konnektoren                        68
├── L07 Konnektoren Beispielsätze          34
├── L08 Präpositionen mit festem Kasus     12
├── L08 Redemittel Diskussion              13
├── L09 Wohnen                             42
├── L09 Lokale Präpositionen               31
└── L10 Verben mit Präpositionen           37

Three card shapes, chosen per list: vocab gives DE→EN and EN→DE; phrase gives EN→DE only, since producing a phrase is the hard part; cloze blanks the one thing being drilled — the adjective ending, the connector, the preposition and its case. Every card carries audio and cites its handout page.

What makes this different from other German Anki decks

  • Sentence-based, not vocabulary-based — you learn grammar through 20 example sentences per topic, not by drilling rules in isolation.
  • Audio for every sentence — neural TTS, not robotic. Listening cards train comprehension explicitly.
  • Markdown source-of-truth — edit a .md file, run make, get an updated .apkg. Stable card GUIDs preserve your Anki review schedule across rebuilds.
  • Goethe-aligned curriculum — topics map to Grammatik aktiv A1-B1 (Cornelsen) and standard B2 syllabus. Exam prep schedules included.
  • Free — no subscription, no API keys. edge-tts is free.

Building from source

If you want to edit content or rebuild from scratch:

git clone https://github.com/salmanmohebi/german-study-kit.git
cd german-study-kit
make install        # one-time: .venv + dependencies
make a1             # build one level
make review        # build the A1 + A2 review decks
make german5        # build the German 5 verb deck
make german5-ws     # build the German 5 vocabulary decks
make all            # build everything (A1 + A2 + B1 + B2 + verbs + themen + review + german5 + german5-ws)

Audio is cached in anki/audio/ (gitignored). Only changed sentences hit the TTS API on rebuild — the rest is instant.

Requirements: Python 3.11+, make, internet (for first audio fetch).

Repository structure

german-study-kit/
├── grammar/                  # markdown source for grammar decks
│   ├── A1/                   # 16 topic files
│   ├── A2/                   # 18 topic files
│   ├── B1/                   # 18 topic files
│   └── B2/                   # 18 topic files
├── themen/                   # 12 thematic packs (survival, restaurant, hotel, …)
├── reference/
│   ├── irregular-verbs.md    # source for verbs deck + lookup table
│   └── konnektoren.md        # connector cheat sheet (A2-B2)
├── exam/
│   ├── A2.md                 # Goethe-Zertifikat A2 format & prep schedule
│   ├── B1.md                 # B1 format & prep
│   └── B2.md                 # B2 format & prep
├── anki/
│   ├── build.py              # grammar deck builder
│   ├── build_verbs.py        # verbs deck builder
│   ├── build_themen.py       # thematic deck builder
│   ├── tts.py                # edge-tts wrapper with on-disk caching
│   ├── audio/                # cached mp3s (gitignored)
│   └── out/                  # built .apkg files (committed)
├── resources.md              # curated apps, podcasts, YouTube, tutoring platforms
├── roadmap.md                # study plan, daily routines, scope
├── listening.md              # podcast curriculum by level
├── Makefile
└── requirements.txt

Customizing the kit

Add or edit a grammar topic

Each topic is a single markdown file:

---
title: Personalpronomen + sein (Präsens)
level: A1
topic_id: a1-01-sein
tags: [a1, sein, personalpronomen]
---

## Erklärung

(Short grammar explanation. Rendered as HTML on the back of every card.)

## Sätze

- Ich {{c1::bin}} müde. | I am tired.
- Du {{c1::bist}} sehr nett. | You are very nice.

Format rules:

  • ## Erklärung → grammar note shown on the back of every card from this file.
  • ## Sätze → list of - <German> | <English> pairs.
  • Cloze markup {{c1::word}} produces a fill-in-the-blank card.
  • Multi-cloze ({{c1::}} + {{c2::}} in the same sentence) generates separate cards per blank.

Run make a1 (or a2/b1/b2) to rebuild.

Add a thematic pack

Drop a new file in themen/ with the same markdown format. Cloze markup is optional. Each sentence becomes 2 cards (EN→DE + DE→EN).

Change the TTS voice

Edit DEFAULT_VOICE in anki/tts.py. Other German voices:

  • de-DE-KatjaNeural (default, female)
  • de-DE-ConradNeural (male)
  • de-DE-AmalaNeural (female, younger)
  • de-DE-BerndNeural (male, older)

Delete anki/audio/ to force regeneration with the new voice.

Study guides included

File What's there
roadmap.md Overall plan, daily routine, deck status
resources.md Curated apps, podcasts, YouTube, tutors, dictionaries (per level)
exam/A2.md, exam/B1.md, exam/B2.md Goethe-Zertifikat format + week-by-week prep schedules
reference/konnektoren.md Every connector across A2-B2 with word-order rules
reference/irregular-verbs.md 80 verbs principal parts

Stack

  • edge-tts — free neural TTS via Microsoft Edge's voice service (no API key)
  • genanki — programmatic .apkg generation
  • PyYAML + markdown — frontmatter parsing + grammar note rendering
  • Python 3.11+

Acknowledgments

  • Grammar curriculum based on Grammatik aktiv A1-B1 (Cornelsen) plus standard Goethe-Zertifikat B2 syllabus.
  • TTS by Microsoft Edge neural voices (Katja).
  • Inspired by Refold-style sentence mining + spaced repetition.

Contributing

Found a German error, awkward sentence, or grammar inaccuracy? PRs welcome — edit the relevant markdown file in grammar/, themen/, or reference/, run make to verify the build, and submit.

About

German Study Kit

Resources

Stars

8 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages