data

Data collection engine for EmptyDeen - An Islamic learning app with a modern interface
This repo scrapes and processes Quranic data:

• Quran text (Arabic + translations)
• Tafsir (commentary)
• Audio recitations
• Phonetic pronunciations with Tajwid

Table of Contents

• data
  • Table of Contents
  • Quick Start
  • Output
  • Sources
  • Contributing

Quick Start

# 1. Extract the database
unzip data/quran.sqlite.zip -d data/

# 2. Install dependencies
npm install

# 3. Run the script
node index.js

Note: The quran.sqlite database is converted from quran-database to SQLite format.

Output

output/
├── surahs.json          # All Quran data
└── audios/
    ├── 1/               # Surah 1 audios
    │   ├── 1.mp3
    │   ├── 2.mp3
    │   └── ...
    └── ...

surahs.json structure:

{
  "1": {
    "name": "Al-Fatihah",
    "number": 1,
    "surah": {
      "en": ["In the name of Allah..."],
      "fr": ["Au nom d'Allah..."],
      "ar": ["بِسْمِ اللَّهِ..."]
    },
    "tafsir": {
      "en": [["Commentary..."]],
      "fr": [["Commentaire..."]]
    },
    "pronunciation": ["Bismi <HmA>A</HmA>ll<MS2>ā</MS2>hi..."]
  }
}

Data Sources

• Translations & Quran: tanzil.net/trans
• Tafsir: quranenc.com
• Pronunciations: transliteration.org

Contributing

Feel free to open an issue or submit a pull request.