Quran.ws quran-text v0.1.0, commit 4c577e066bada4df50e570300c872f3b1b844f1b
https://github.com/quran-ws/quran-text

# Licence and attribution

`LICENSE` is the standard Quran.ws notice: **CC BY 4.0** across this repository,
with a standing waiver of attribution for use inside a product. The full legal
text is in `LICENSES/CC-BY-4.0.txt`. This file says what the licence covers,
what it cannot cover, and the attribution to carry when it is asked for.

## What is licensed

Everything in this repository that this project authored:

| | |
|---|---|
| the word index and its numbering | `data/word-index.*`, `data/ayah-map.*` |
| the seven muṣḥaf files and derived layers | `data/mushaf/`, `data/counting.json` |
| the counting analysis and its citations | `sources/counting/khilaf.json`, `declared.json`, `open-findings.json` |
| the alignment data | `sources/alignment/` |
| the pipeline and the service | `pipeline/`, `service/` |
| the schemas, the reports, the documentation | `schema/`, `data/reports/`, `docs/` |

Word-level data is **derived** here — no source package contains it — and that
derivation, together with the alignment, the numbering and the counting
analysis, is the work being licensed. See `docs/sources.md`.

## The client libraries are CC BY 4.0 too

`lib/` carries the same licence as everything else, and each package ships a
copy of it. One licence covers the whole repository: the dataset, the pipeline,
the docs and the six client libraries.

That is a deliberate choice against the usual advice. Creative Commons
discourage CC BY for software — it grants no patent rights and does not define
"source form" — and MIT is what a developer pulling `quran-text` from PyPI, npm,
Packagist, pub.dev or Maven Central would expect. But every one of those
packages **bundles the dataset**: `hafs.json` and its font travel inside them.
Licensing the wrapper under MIT while the data it carries is CC BY 4.0 would put
two licences in one package and, in practice, let the data reach people with the
attribution stripped — which is the one thing this licence exists to prevent.

So the link requirement holds wherever the data goes. If you need the library
code under different terms, ask.

## What is not licensed here

**The Qurʾānic text is not this project's to license.** Nor are the packages it
was read from:

| | |
|---|---|
| `sources/kfgqpc/*.zip` | KFGQPC distributions, redistributed unmodified |
| `data/fonts/*.ttf` | KFGQPC fonts, copied unmodified from those packages |

These are the work of the **King Fahd Glorious Qurʾān Printing Complex**, are
included as received, and remain under KFGQPC's own terms. Those terms are the
Complex's published usage rights, reproduced in full in Arabic and English in
`LICENSE`. Nothing in `LICENSE` grants any right in them beyond what the
Complex itself grants there.

`sources/counting/book-boundary-primitives.json` and `counting-systems.json` are
copied verbatim from
[quranpedia/qiraat-ayah-map](https://github.com/quranpedia/qiraat-ayah-map)
(MIT) at a pinned commit; see `sources/counting/UPSTREAM.md`.

## Attribution: waived in products, asked for on republication

**Building this data into an application, website, service, API, bot, tool,
research work or product needs no credit at all.** As rights holder we grant a
permanent, worldwide, royalty-free, irrevocable waiver of CC BY 4.0's
attribution requirement (§3(a)) for that use, free or commercial, including
when the dataset is bundled inside the application for offline operation. That
covers the client libraries too. Credit is always appreciated and never
required.

Attribution is asked for when the data **itself** is republished as a resource
in its own right — a mirror, a bulk dump, a downloadable export, an endpoint
that serves the corpus, or a repository that vendors these files. The test: if
a third party can obtain the data *as data* from what you distribute, that is
republication.

When it applies, this is the form:

> quran-text by quran-ws — https://github.com/quran-ws/quran-text — CC BY 4.0

**The link is the point** — it is how anyone who receives this data from you can
reach corrections and later releases. If you changed the data, say so:
§3(a)(1)(B) asks you to mark modifications, and it matters here more than in
most datasets.

Copyright © 2026 quran-ws.

Copyright 2026 Quran.ws

This work is dedicated as a waqf for the sake of Allah, seeking His pleasure
through the benefit it brings to people. We publish it to enable the widest
possible beneficial use, with as few restrictions as possible.

Quran.ws publishes code under the MIT License, and data and content under the
Creative Commons Attribution 4.0 International License,
with a standing waiver of attribution for use inside a product.

We license only what we have the right to license; third-party material keeps
the licence and terms of its own rights holders.

Full policy: https://github.com/quran-ws/guidelines


═══════════════════════════════════════════════════════════════════════════════
WHAT IS COVERED BY WHAT
═══════════════════════════════════════════════════════════════════════════════

  .github/     CC BY 4.0
  conformance/ CC BY 4.0
  data/        CC BY 4.0
  docs/        CC BY 4.0
  lib/         CC BY 4.0
  pipeline/    CC BY 4.0
  schema/      CC BY 4.0
  service/     CC BY 4.0
  skills/      CC BY 4.0
  sources/     CC BY 4.0

This repository is the one place where we do not split MIT for code and
CC BY 4.0 for data. One licence covers everything, the six client libraries in
lib/ included, because every one of those packages bundles the dataset: the
text and its font travel inside the package. An MIT wrapper around CC BY 4.0
data would put two licences in one artefact and, in practice, let the data
reach people with the attribution stripped. So the requirement follows the data
wherever the data goes. If you need the library code under different terms,
ask: legal@quran.ws.

The waiver below applies here in full, so using these libraries inside a
product needs no credit screen.

Where a directory or file carries its own LICENSE or NOTICE, that notice
governs for that material. Names, logos and trademarks are not licensed.


═══════════════════════════════════════════════════════════════════════════════
ATTRIBUTION WAIVED FOR USE IN PRODUCTS
═══════════════════════════════════════════════════════════════════════════════

As rights holders of our original data and content, we grant a permanent,
worldwide, royalty-free, irrevocable waiver of the attribution requirement of
CC BY 4.0 (Section 3(a)) when the material is used within an application,
website, service, API, bot, tool, research work, or product, whether free or
commercial. This permission expands what you may do and adds no restriction to
CC BY 4.0.

Attribution is still required on republication — when the data or content
itself is made available to others as a resource in its own right. The test:
if a third party can obtain the data AS DATA from what you distribute, that is
republication, and CC BY 4.0 attribution applies.

Suggested attribution:

  Data from [resource] by Quran.ws, licensed under CC BY 4.0.
  Source: [canonical URL]. Version: [version]. Modified: [yes/no].

Use for training, fine-tuning, evaluating, indexing or retrieval by machine
learning systems is permitted and treated as use, not republication.


═══════════════════════════════════════════════════════════════════════════════
THIRD-PARTY MATERIAL — KING FAHD GLORIOUS QUR'AN PRINTING COMPLEX
═══════════════════════════════════════════════════════════════════════════════

The Qur'anic text editions, mushaf typesettings and fonts in this repository
derive from material published by the King Fahd Glorious Qur'an Printing
Complex. That material is not ours to license. It is used under the Complex's
own published usage rights, reproduced in full below in Arabic and English.

Our processing, correction, organisation or transformation of that material
creates no ownership in it and does not override these terms.


───────────────────────────────────────────────────────────── حقوق الاستخدام ───

بناء على موافقة معالي وزير الشؤون الإسلامية والدعوة والإرشاد، المشرف العام على
مجمع الملك فهد لطباعة المصحف الشريف، يتشـرَّف المجمع بإتاحة نسخة رقمية كاملة من
مصحف المدينة النبوية المطبوع في المجمع، وذلك بالصيغ التالية:

رسم المتجهات Illustrator
وثيقة بي دي إف PDF
صور ذات جودة عالية Images
خط حاسوبي True Type Font

ويمكن استخدام النسخة المذكورة مجاناً في المجالات الشخصية والأعمال الفردية كافة،
وأعمال الجهات الحكومية والجهات والمؤسسات الخاصة والأهلية، وأعمال الطباعة
الورقية*، والنشـر المكتبي والإعلامي، ومواقع الإنترنت والبرامج الحاسوبية وغيرها،
وذلك داخل المملكة العربية السعودية وخارجها.

نسأل الله أن ينفع المسلمين بهذا العمل المبارك.

والحمد لله رب العالمين

* أعمال طباعة المصاحف داخل المملكة واستيرادها من الخارج لغرض البيع التجاري
تخضع للأمر السامي الكريم ذي الرقم 136/8 المؤرخ في 1/2/1406هـ وأكّد على ذلك
الأمر السامي الكريم رقم 9/ب/46356 بتاريخ 28/9/1424هـ. والذي وجه بمنع طباعة
المصاحف في الداخل في غير المجمع، وكذلك منع استيرادها من الخارج لغرض البيع
التجاري.


──────────────────────────────────────────────────────────────── Copyright ────

Based on the approval of His Excellency the Minister of Islamic Affairs,
Endowments, Da'wah and Guidance, General Supervisor of the King Fahd Qur'an
Printing Complex.

The Qur'an Printing Complex is honored to present to the Muslim public a
complete free digital copy of Mus'haf al-Madinah published by the Complex, in
the following formats:

  • Adobe Illustrator files
  • PDF files
  • High quality images
  • True Type Font

Mus'haf al-Madinah in these previous formats can be used for free in all
personal, individual businesses, in works of governmental departments &
agencies, in the publications of both private and national institutions, also
suitable for Qur'an printing,* digital publishing, & for media use, can be used
also in websites, software, and other similar intermediates.

We ask Allah that He renders this blessed project beneficial to all Muslims.

* Printing of Qur'anic copies in the Kingdom, and their import from outside for
sale are subject to the Royal Decree No 136/8 dated 1/2/1406 AH which has been
reiterated by the Royal Decree No 9/B/46356 dated 28/9/1424 AH which prohibit
printing of Qur'anic copies in the Kingdom except in the Complex, likewise
their import from outside for sale.


═══════════════════════════════════════════════════════════════════════════════
ACCURACY AND NO WARRANTY
═══════════════════════════════════════════════════════════════════════════════

This material is provided AS IS, without warranty of any kind, as stated in
the MIT License and in CC BY 4.0 (Sections 5 and 6).

Qur'anic text, transliteration, translation, recitation and mushaf rendering
may contain errors, and releases are corrected over time. Anyone publishing
Qur'anic text to end users is responsible for verifying it against an
authorised printed mushaf and for tracking our corrections.

Corrections:          corrections@quran.ws — treated as a priority.
Licensing questions:  legal@quran.ws


═══════════════════════════════════════════════════════════════════════════════
FULL LICENCE TEXTS
═══════════════════════════════════════════════════════════════════════════════

The full CC BY 4.0 legal text is in LICENSES/CC-BY-4.0.txt and at
https://creativecommons.org/licenses/by/4.0/legalcode

No directory in this repository is under the MIT License, so its text is not
reproduced here. The organisation-wide policy, and the MIT text, are at
https://github.com/quran-ws/guidelines

This notice is published in Arabic and English. Where the two differ, the
Arabic version governs.