Morning and Evening Adhkar Database is an open-source project that provides structured data for morning and evening adhkar (supplications) in both Arabic and English. This project includes various formats like JSON, CSV, SQL, and SQLite, generated from the primary JSON files.
✨ Allah, the Almighty, has commanded His believing servants to engage in constant remembrance and to be consistent in it at all times. He said: {O believers! Always remember Allah often and glorify Him morning and evening} (Al-Ahzab: 41-42). He also said: {So glorify Allah in the evening and in the morning all praise is for Him in the heavens and the earth—as well as in the afternoon, and at noon} (Ar-Rum: 17-18).
The files in both Arabic and English contain the following columns:
| Description | Column Name |
|---|---|
| Order of the Dhikr | order |
| Arabic text of the Dhikr | content |
| Translation of the Arabic text of the Dhikr | translation (English only) |
| Transliteration of the Arabic text | transliteration (English only) |
| Recommended number of repetitions | count |
| Virtue or benefit of reciting the Dhikr | fadl |
| Source of the Hadith or Quranic verse | source |
| Type of Dhikr (0 for both morning and evening, 1 for morning only, 2 for evening only) | type |
| Link to an audio file of the Dhikr | audio |
| Text of the Hadith related to the Dhikr | hadith_text |
| Explanation of specific vocabulary in the Hadith | explanation_of_hadith_vocabulary |
Morning_And_Evening_Adhkar_DB/
├── result/
│ ├── ar.csv
│ ├── ar.json
│ ├── ar.sql
│ ├── ar.sqlite
│ ├── en.csv
│ ├── en.json
│ ├── en.sql
│ ├── en.sqlite
├── scripts/
│ ├── convert_all.sh
│ ├── convert_to_csv.py
│ ├── convert_to_sql.py
│ ├── convert_to_sqlite.py
├── .github/
│ ├── workflows/
│ │ ├── convert_and_commit.yml
├── .gitignore
├── ar.json
├── en.json
├── README.md
We welcome contributions to this project! Here are some guidelines to get you started:
- Main Files: The primary files for contributions are
ar.json(Arabic) anden.json(English). Any edits or fixes should be made to these files only. - Generated Files: Other files in the
resultdirectory (e.g.,ar.csv,en.sqlite) are generated from the main JSON files. Do not edit these files directly. - Scripts: After making changes to the JSON files, the conversion scripts in the
scriptsdirectory can be run to generate the other formats. This process is also automated via a GitHub Action workflow in.github/workflows/convert_and_commit.yml.
- Fork the repository.
- Create a new branch for your changes.
- Edit the
ar.jsonoren.jsonfiles as needed. - Commit your changes and push them to your fork.
- Create a Pull Request from your fork to the main repository.
Warning
Please ensure that any changes are made to the ar.json and en.json files only. The conversion to other formats is handled automatically and should not be edited manually.
For more details on the conversion process, you can refer to the scripts provided in the scripts directory and the GitHub Action workflow in .github/workflows/convert_and_commit.yml.
- English translation and transliteration from Hisn Muslim and Sunnah
- Book: "Hisn Al-Muslim (Fortress of the Muslim)" by Sheikh Dr. Sa'id bin Ali bin Wahf Al-Qahtani
- Book: "Sharh Hisn Al-Muslim (Explanation of Fortress of the Muslim)" by Sheikh Dr. Sa'id bin Ali bin Wahf Al-Qahtani
- Book: "Rawa' Al-Atshaa' Bi Sharh Adhkar Al-Sabah wal-Masaa" by Sheikh Muhammad Ismail Al-Muqaddim
- Book: "Adhkar wa Adab Al-Sabah wal-Masaa" by Sheikh Muhammad Ismail Al-Muqaddim
This project is licensed under the MIT License. See the LICENSE file for more information.
