Building blocks/Data

Quran Text

Beta

Source-verified Quran text in seven printed riwayat, with a shared word identity that connects corresponding words across them.

Quick startDownload the textquran-text

Nothing to install: text.quran.ws serves this block’s data straight from the repository. Pick a riwayah, shape the file — scope, rows, marks, format — and copy the URL. Same URL, same bytes, forever. No key, no sign-up.

Package
@quran.ws/text
Version
0.1.0
Riwayat
7 printed
Words
77,434 numbered

What it provides

  • Verified text for each riwayah, per surah, ayah, page, and juz
  • One word number that means the same word in all seven riwayat
  • Source package, SHA-256 digest, and departure list with every file

Use it when you need

Use it when your application needs Quran text, supports multiple riwayat, or needs to match words and positions across different riwayat.

  • A text-based reader or search
  • Surah, ayah, page, or juz access
  • Stable word-level references for other blocks

Not for

See it work

Several things this block does, each running on data from the repository itself.

How the package is built

One file per printed muṣḥaf, one numbering shared across them, and a flat array with offsets instead of a tree.

Real data
Loading the riwayah files…

Supported riwayat

Each riwayah is a separate dataset with its own edition and ayah count. No single count is assumed to apply universally — read it from the loaded riwayah.

Ḥafṣ ʿan ʿĀṣimʿĀṣim al-Kūfī6,236 ayat · Kufi countVerified
Shuʿbah ʿan ʿĀṣimʿĀṣim al-Kūfī6,236 ayat · Kufi countVerified
Warsh ʿan NāfiʿNāfiʿ al-Madanī6,214 ayat · Last Madani countVerified
Qālūn ʿan NāfiʿNāfiʿ al-Madanī6,214 ayat · Last Madani countVerified
al-Dūrī ʿan Abī ʿAmrAbū ʿAmr al-Baṣrī6,217 ayat · First Madani countVerified
al-Sūsī ʿan Abī ʿAmrAbū ʿAmr al-Baṣrī6,218 ayat · First Madani countVerified
al-Bazzī ʿan Ibn KathīrIbn Kathīr al-Makkī6,220 ayat · Makki countBeta

Provenance

Every dataset identifies its source, edition, riwayah, version, and verification status. The digest lets you confirm the file you ship is the file that was verified.

View full provenance →
Quran TextBeta
Repositoryquran-ws/quran-text
Package@quran.ws/text
Version0.1.0
LicenceCC BY 4.0 (the work), attribution waived for use inside a product · KFGQPC terms (the text)
Publicat launch

Quick start

The shortest path to something running. The repository’s README covers the rest.

$ pip install ./lib/python
from quran_text import Mushaf
 
m = Mushaf.hafs()
m.ayah(2, 255).render(marks=True) // Ayat al-Kursi
m.word(2, 255, 3).to(warsh) // the same word, in Warsh
Read the full documentation →

Works with

Blocks meet through shared references, not through a framework. Each of these understands something this block produces.

Quran TajweedColour unchanged text with annotation spans.Qiraat Ayah MapMap references across counting systems.Quran SVG ElementsLink words to their printed shapes.Quran EngineSearch and highlight by word id.