CoolFace
Datasetpublic

QUD-Technologies/quranic-universal-ayahs

Qur'anic Universal Ayahs Qur'anic Universal Audio (QUA) is a project that unifies recitations on the internet and generates timing data using forced alignment — community-verified results and constantly expanding dataset. This dataset pairs ayah by ayah audio with word-level timestamps, DigitalKhatt letter-animation timestamps, and waqf-aware segment data. Repeated words are preserved in text_uthmani and word_timestamps, so the row reflects what the reciter… See the full description on the dataset page: https://huggingface.co/datasets/QUD-Technologies/quranic-universal-ayahs.

sourceHugging Facecc-by-4.0updated 2d agoView on Hugging Face
6likes2.8kdownloads
Dataset Card

<p align="center"> <a href="https://aligner.qud.dev/"><img src="https://img.shields.io/badge/%F0%9F%A4%97%20Tool-Qur'anic%20Universal%20Aligner-E8C32E" alt="Tool - Qur'anic Universal Aligner"></a> <a href="https://audio.qud.dev/"><img src="https://img.shields.io/badge/%F0%9F%A4%97%20Website-Qur'anic%20Universal%20Audio-E8C32E" alt="Website - Qur'anic Universal Audio"></a> <br> <a href="https://github.com/Wider-Community/quranic-universal-audio"><img src="https://img.shields.io/badge/Recitations-56-d4842a" alt="Timestamped recitations"></a> <a href="https://github.com/Wider-Community/quranic-universal-audio"><img src="https://img.shields.io/badge/Riwayat-4-f0ad4e" alt="Timestamped riwayat"></a> <a href="https://github.com/Wider-Community/quranic-universal-audio"><img src="https://img.shields.io/badge/Hours-1%2C650h%2B-d4842a" alt="Timestamped audio hours"></a> <br> <a href="https://github.com/Wider-Community/quranic-universal-audio/releases/latest"><img src="https://img.shields.io/github/v/release/Wider-Community/quranic-universal-audio?label=Release&color=4a5568" alt="Latest Release"></a> <a href="https://github.com/Wider-Community/quranic-universal-audio"><img src="https://img.shields.io/github/stars/Wider-Community/quranic-universal-audio?style=social" alt="GitHub stars"></a> <a href="https://github.com/Wider-Community/quranic-universal-audio/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-CC%20BY%204.0-4a5568" alt="License"></a> </p>

<h1 align="center">Qur'anic Universal Ayahs</h1>

Qur'anic Universal Audio (QUA) is a project that unifies recitations on the internet and generates timing data using forced alignment — community-verified results and constantly expanding dataset.

This dataset pairs ayah by ayah audio with word-level timestamps, DigitalKhatt letter-animation timestamps, and waqf-aware segment data. Repeated words are preserved in text_uthmani and word_timestamps, so the row reflects what the reciter actually recited rather than a plain copy of canonical ayah text.

Tip: Click the three dots (···) at the top right and toggle Notifications to get updates whenever recitations are added or refreshed.

Dataset

Mushaf configs contain one row per ayah. Each row includes embedded ayah audio, recited Uthmani text, word timestamps, letter timestamps, waqf-aware segments, and source-audio mappings.

The mushafs subset is the dataset catalog index. It has one row per published mushaf, joined with reciter names, riwayah/style/channel labels, audio metadata, and coverage.

Each remaining subset is one published mushaf — a config named after the mushaf slug, with a single train split. Riwayah, style, and channel for each mushaf live in the mushafs catalog.

Mushaf Schema

ColumnTypeNotes
audioAudioAyah MP3 clip.
surahint32Surah number, 1-114.
ayahint32Ayah number within the surah.
duration_msint32Clip duration.
text_uthmanistringExact recited DigitalKhatt V2 text.
segments[[int,int,int,int]]Waqf/pause-aware regions: [word_from, word_to, start_ms, end_ms].
word_timestamps[[int,int,int]][word_idx, start_ms, end_ms]; word indices are 1-based.
source_urlstringOriginal chapter or ayah audio URL.
source_offset_msint32Clip start inside source_url.

All row timestamps are relative to the ayah clip. Use source_offset_ms + timestamp_ms when mapping a row back to its source audio.

Catalog Schema

One row per published mushaf.

ColumnTypeNotes
slugstringStable mushaf identifier (also the subset/config name).
reciter_idstringStable reciter identifier (shared across that reciter's mushafs).
name_en, name_arstringReciter display name (English / Arabic).
countrystringReciter country, ISO 3166-1 alpha-2 (e.g. SA).
riwayahstringRiwayah name (e.g. Hafs).
stylestringRecitation style (e.g. Murattal, Mujawwad).
recording_contextstringRecitation context (e.g. Studio, Taraweeh).
recording_yearint32Year recorded, when known.
channelstringDistribution channel name.
audio_categorystringHow source audio is segmented: by_surah \by_ayah.
chapter_countint32Number of chapters in the mushaf.
codecstringAudio codec.
containerstringFile container.
sample_rate_hzint32Sample rate.
channelsint321 = mono, 2 = stereo.
bitrate_modestringcbr \vbr \mixed \unknown. mixed = chapters differ.
bitrate_kbps_nominalint32Nominal bitrate; null when bitrate_mode is mixed.
total_duration_hoursfloat32Total mushaf audio duration, in hours (1 dp).
published_atstringWhen the mushaf first entered the dataset, ISO-8601.
updated_atstringWhen the mushaf was last published/refreshed, ISO-8601.

Usage

python
from datasets import load_dataset

ds = load_dataset(
    "hetchyy/quranic-universal-ayahs",
    "khalifa_al_tunaiji_tarteel",
    split="train",
)

row = ds[0]
print(row["surah"], row["ayah"])
print(row["word_timestamps"])
print(row["segments"])
python
catalog = load_dataset(
    "hetchyy/quranic-universal-ayahs",
    "mushafs",
    split="all",
)

print(catalog[0]["name_en"], catalog[0]["riwayah"])

Notes

  • —Best for quick access to verse audio and timestamps together, ayah-by-ayah playback, and ML research.
  • —Also see GitHub Releases, a parallel format using JSON files with versioning and checksums, suitable for offline usage.
  • —Recitation audio is not relicensed, and remains the property of upstream sources/reciters.

License

CC BY 4.0.