Add audio transcription workflow (faster-whisper) and gitignore for raw audio
This commit is contained in:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user