cb22804a1f
- 5 micro-lessons (200-400 words each) - Standardized YAML frontmatter with audio metadata - Quiz with 5 questions + explanations - TTS pipeline script (Azure/Piper/ElevenLabs) - Lesson template for future modules - Calibrated read times and audio durations
2.2 KiB
2.2 KiB
FalahMobile Content Repository
Micro-learning courses for the FalahMobile Islamic lifestyle app.
Repository Structure
falahmobile-content/
├── courses/ # All courses
│ ├── daily-fiqh-beginner/
│ ├── 40-hadith-nawawi/
│ └── tafsir-bites/
├── assets/ # Shared images, fonts, icons
├── scripts/ # Build and generation scripts
│ ├── generate-audio.py # TTS pipeline
│ └── validate-content.mjs # Content quality checks
├── templates/ # Lesson and course templates
└── README.md
Content Format
Every lesson is a Markdown file with YAML frontmatter:
---
id: "course-module-lesson"
title: "Lesson Title"
course: "Course Name"
module: "Module Name"
order: 1
read_time: "3 min"
difficulty: "beginner"
tags: ["fiqh", "prayer"]
source_refs: ["Quran 5:6", "Sahih Muslim 271"]
audio_ready: true
---
Audio Pipeline
Free TTS Options (Female, Calm, Human-like)
| Service | Voice | Quality | Free Tier | Setup |
|---|---|---|---|---|
| Azure Speech | en-US-AriaNeural |
Excellent | 500K chars/mo | Azure account |
| Piper TTS | amy (local) |
Good | Unlimited | Download + run locally |
| Google Cloud | en-US-Neural2-F |
Good | 1M chars/mo | GCP account |
| ElevenLabs | Rachel |
Excellent | 10K chars/mo | API key |
Generate Audio
# Using Azure (recommended free tier)
python scripts/generate-audio.py --course daily-fiqh-beginner --engine azure
# Using Piper (completely free, local)
python scripts/generate-audio.py --course daily-fiqh-beginner --engine piper
Gitea Integration
Push content to your Gitea instance:
git remote add gitea https://your-gitea.com/user/falahmobile-content.git
git push gitea main
The FalahMobile app fetches content via the Gitea API or raw file URLs.
Adding a New Course
- Create
courses/<course-id>/manifest.json - Create module directories with lesson
.mdfiles - Run
python scripts/validate-content.mjs - Generate audio with
python scripts/generate-audio.py - Commit and push to Gitea