Noor is a plugin for Obsidian.md. It aims to help Muslims stay enlightened with Islam, Quran, Hadith, and Sunnah

• Insert a Quran Quote at the current location containing a random verse with recitation in Arabic, chosen translation language, and a hyperlink for more info.
• Insert a Hadith Quote at the current location containing a random hadith in the chosen language and a hyperlink for more info.
• Create a Dhikr file at the configured location containing a Quran Quote and a Hadith Quote (can be used again to update file with new quotes)

After enabling the plugin in the settings menu, you should see the added commands and the noorJS object.

• commands:
  • Noor: Random Quran quote: inserts a quote block at the current editor location containing a Quran Quote
  • Noor: Random Hadith quote: inserts a quote block at the current editor location containing a Hadith Quote
  • Noor: Open Dhikr file: creates a Dhikr file at the configured location containing a Quran Quote and a Hadith Quote then opens in current view
  • Noor: Open Dhikr file popup: creates a Dhikr file at the configured location containing a Quran Quote and a Hadith Quote then opens in popup window view
• scripting:
  • noorJS.randomQuranQuote(): this function returns a Quran Quote
  • noorJS.randomHadithQuote(): this function returns a Hadith Quote

obsidian plugins complement each other, here are some ideas

• with templater: use <% noorJS.randomQuranQuote() %> to insert the Quran quote into your notes (like the daily note to get a daily verse)
• with commander: use it to create a button for the Noor: Random Quran quote command

• Dhikr file path: configure where to create the Dhikr file

• Reciter: choose your favorite reciter from the drop-down menu
• Show translation: choose Arabic only or dual language mode
• Translation Language: choose the second language to show next to Arabic
• Translation Options: choose your favorite translation from the ones available in selected Translation Language

• Hadith language: choose your preferred language to show the hadith in.

• Copy over main.js, manifest.json to your vault .obsidian/plugins/noor/.
• Reload Obsidian to load the new version of your plugin.
• Enable the plugin in the settings window.

The Quran verses are retrieved from

• alquran.cloud: An opensource Quran API made by the Islamic Network (github) and respective contributors.

The Hadith quotes are retrieved from

• hadeethenc.com: Encyclopedia of Translated Prophetic Hadiths.

Please feel free to open a pull request with suggested improvements and new feature requests