Add audio transcription workflow (faster-whisper) and gitignore for raw audio

This commit is contained in:
2026-08-28 21:29:46 +03:30
parent 1aa2aa1b1a
commit e65626cbc9
4 changed files with 102 additions and 0 deletions
+19
View File
@@ -32,6 +32,25 @@ A1.2/ ← added once I move on to the next book
4. Update `INDEX.md` with a one-line entry for the lesson.
5. Commit.
## Audio (listening exercises)
Course book audio has no printed transcript (the workbook's back section is
the *Lösungsschlüssel* — answer key — not a transcript, so that doesn't help
here). Raw audio files are **not** stored in this repo (see `.gitignore`);
only their transcripts are, since that's what gives Claude context.
Workflow:
1. Get the audio files locally (publisher CD/app/download), any folder outside git.
2. Run `scripts/transcribe.py` (uses `faster-whisper` on GPU) to transcribe them:
```bash
pip install faster-whisper
python scripts/transcribe.py "<path-to-lesson-audio>" "A1.1/course-book/transcripts/lektion-XX"
```
3. Skim the `.txt` output for ASR mistakes (names, numbers, fast speech) and fix them.
4. Reference/paste the transcript into the lesson's `.md` file under "Audio / Listening",
or just point at the `transcripts/lektion-XX/*.txt` path — either works, transcripts
are small text files so committing them is fine.
## Adding a new book (e.g. A1.2)
Copy the `A1.1/` folder structure (minus content) into a new `A1.2/` folder