<div>
<p style="text-align: center;"><span style="text-decoration: underline;"><strong>Added new Islamic features:</strong><br /></span><em>- Added a lot of new Reciters -</em><br /><em>- Ayah by ayah recitation -</em><br /><em>- Display verses to read -</em><br /><em>- Random Verse generator</em><br /><em>- Mushaf Opener -</em><br /><em>- Hadith -</em><br /><em>- Tafsir -</em><br /><em>- AND MORE! -</em></p>
</div>
<h1 id="documentation"><a href="https://github.com/nullbyto/MuslimBot/blob/master/Documentation.md">Documentation</a></h1>
<h2 id="general-commands">General Commands</h2>
<h3 id="-prefix">+prefix</h3>
<p>You can use this command to change the server&#39;s prefix for the bot. (Server&#39;s owner only)</p>
<p><strong>To get server&#39;s current prefix:</strong></p>
<pre><code><span class="hljs-addition">+prefix</span>
</code></pre><p><strong>To change server&#39;s current prefix:</strong></p>
<pre><code>+<span class="hljs-built_in">prefix</span> [<span class="hljs-built_in">prefix</span>]
</code></pre><p><strong>For example:</strong> <code>+prefix ++</code></p>
<h3 id="-userinfo">+userinfo</h3>
<p>Sends your user information in the channel.
<strong>You can check other user&#39;s info by mentioning them:</strong></p>
<pre><code>+userinfo <span class="hljs-string">[@user]</span>
</code></pre><p><strong>For example:</strong> <code>+userinfo @MuslimBot</code></p>
<h2 id="islamic-features">Islamic Features</h2>
<h3 id="quran">Quran</h3>
<h4 id="-quran">+quran</h4>
<p>allows you to quote verses from the Qur&#39;an. You can optionally specify a translation (see <strong>Valid Translations</strong> below). If you do not, the bot will send the verses in English.</p>
<p><strong>To get a single verse:</strong></p>
<pre><code>+quran <span class="hljs-string">[surah]</span>:<span class="hljs-string">[verse]</span> <span class="hljs-string">[translation]</span>
</code></pre><p>For example:</p>
<pre><code>+<span class="hljs-selector-tag">quran</span> 1<span class="hljs-selector-pseudo">:1</span> <span class="hljs-selector-tag">french</span>
</code></pre><p><strong>To get multiple verses:</strong></p>
<pre><code>+quran <span class="hljs-string">[surah]</span>:<span class="hljs-string">[firstVerse]</span>-<span class="hljs-string">[lastVerse]</span> <span class="hljs-string">[translation]</span>
</code></pre><p>For example:</p>
<pre><code>+<span class="hljs-selector-tag">quran</span> 1<span class="hljs-selector-pseudo">:1-7</span> <span class="hljs-selector-tag">khattab</span>
</code></pre><p>The above command would quote Surah 1, Verses 1-7 (Surah al-Fatihah) using the translation of Dr Mustafa Khattab.</p>
<h5 id="valid-translations">Valid translations</h5>
<pre><code><span class="hljs-addition">+translationlist</span>
</code></pre><h4 id="-aquran">+aquran</h4>
<p>functions exactly like  <strong>+quran</strong>, but sends the verses in Arabic.</p>
<p>For example, to quote the first verse of the Qur&#39;an:</p>
<pre><code>+<span class="hljs-selector-tag">aquran</span> 1<span class="hljs-selector-pseudo">:1</span>
</code></pre><h4 id="-morphology">+morphology</h4>
<p>allows you to analyse the Arabic morphology of any word in the Qur&#39;an.</p>
<pre><code>+morphology <span class="hljs-string">[surah]</span>:<span class="hljs-string">[verse]</span>:<span class="hljs-string">[word number]</span>
</code></pre><p>For example:</p>
<pre><code>+<span class="hljs-selector-tag">morphology</span> 1<span class="hljs-selector-pseudo">:2</span><span class="hljs-selector-pseudo">:4</span>
</code></pre><p>The above would analyse the morphology of the 4th word of the 2nd verse of the 1st chapter of the Qur&#39;an. The bot will also show the syntax of the verse the word is in, if the data is available.</p>
<h4 id="-mushaf">+mushaf</h4>
<p>sends the page containing a Qur&#39;anic verse on a standard mushaf.</p>
<pre><code>+mushaf <span class="hljs-string">[surah]</span>:<span class="hljs-string">[verse]</span>
</code></pre><p>For example:</p>
<pre><code>+<span class="hljs-selector-tag">mushaf</span> 1<span class="hljs-selector-pseudo">:2</span>
</code></pre><p>The above would send an image of the page containing Qur&#39;an 1:2 on a <em>Medina Mushaf</em>. </p>
<p>If you want a page with color-coded <em>tajweed</em> rules, add &#39;tajweed&#39; to the end of the command.</p>
<p>For example:</p>
<pre><code>+<span class="hljs-selector-tag">mushaf</span> 112<span class="hljs-selector-pseudo">:1</span> <span class="hljs-selector-tag">tajweed</span>
</code></pre><h3 id="tafsir-commentaries-on-the-qur-an-">Tafsir (Commentaries on the Qur&#39;an)</h3>
<h4 id="-atafsir">+atafsir</h4>
<p>allows you to quote from over 37 Arabic <em>tafaseer</em> (commentaries on the Qurʾān). A list of valid <em>tafaseer</em> is available <a href="https://github.com/galacticwarrior9/islambot/blob/master/Tafsir.md">here</a>.</p>
<pre><code>+atafsir <span class="hljs-string">[surah]</span>:<span class="hljs-string">[verse]</span> <span class="hljs-string">[tafsir]</span>
</code></pre><p>For example:</p>
<pre><code>+<span class="hljs-selector-tag">atafsir</span> 2<span class="hljs-selector-pseudo">:255</span> <span class="hljs-selector-tag">tabari</span>
</code></pre><p>The above command would quote the tafsir of Ayatul Kursi from Tafsir al-Tabari.</p>
<h4 id="-tafsir">+tafsir</h4>
<p>allows you to quote the English tasfir (commentary) of verses from Tafsīr al-Jalālayn (<code>jalalayn</code>), Tafsīr Ibn Kathīr (<code>ibnkathir</code>), Tafsīr al-Tustarī (<code>tustari</code>), Rashīd al-Dīn Maybudī&#39;s Kashf al-Asrār (<code>kashf</code>), al-Qurayshi&#39;s Laṭāʾif al-Ishārāt (<code>qurayshi</code>), Tafsīr ʿAbd al-Razzāq al-Kāshānī (<code>kashani</code>) and al-Wahidi&#39;s Asbāb al-Nuzūl (<code>wahidi</code>). It works in the same manner as <strong>+atafsir</strong>.</p>
<pre><code>+tafsir <span class="hljs-string">[surah]</span>:<span class="hljs-string">[verse]</span> <span class="hljs-string">[jalalayn/ibnkathir/kashf/tustari/qurayshi/kashani/wahidi]</span>
</code></pre><p>For example:</p>
<pre><code>+<span class="hljs-selector-tag">tafsir</span> 1<span class="hljs-selector-pseudo">:1</span> <span class="hljs-selector-tag">ibnkathir</span>
</code></pre><p>The above command would quote the tafsir of Surah al-Fatihah, verse 1 from Tafsir Ibn Kathir. </p>
<h3 id="dua">Dua</h3>
<h4 id="-dualist">+dualist</h4>
<p>Sends the list of available dua topics for <code>+dua</code>. </p>
<h4 id="-dua">+dua</h4>
<p>allows you to get duas from <em>Fortress of the Muslim</em> (Hisn al-Muslim). </p>
<pre><code>+dua <span class="hljs-string">[dua topic]</span>
</code></pre><p>For example, to get duas for breaking fasts:</p>
<pre><code>+dua <span class="hljs-keyword">breaking </span>fast
</code></pre><h3 id="hadith">Hadith</h3>
<h4 id="-hadith">+hadith</h4>
<p>allows you to quote hadith from sunnah.com in English.</p>
<pre><code>+hadith <span class="hljs-string">[hadith collection name]</span> <span class="hljs-string">[book number]</span>:<span class="hljs-string">[hadith number]</span>
</code></pre><p>For example, to get the second hadith in Book 1 of Sahih Bukhari:</p>
<pre><code>+hadith <span class="hljs-keyword">bukhari </span><span class="hljs-number">1</span>:<span class="hljs-number">2</span>
</code></pre><p>The above would fetch the hadith from <a href="https://sunnah.com/bukhari/1/2">https://sunnah.com/bukhari/1/2</a></p>
<p>Alternatively, you can simply type the sunnah.com link in chat. The bot will then send it if it is able to. </p>
<h5 id="hadith-collection-names">Hadith collection names</h5>
<table>
<thead>
<tr>
<th><strong>Hadith Collection</strong></th>
<th><strong>Name for Bot</strong></th>
<th><strong>Supported Languages</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>Musnad Ahmad ibn Hanbal</td>
<td><code>ahmad</code></td>
<td>English, Arabic</td>
</tr>
<tr>
<td>Sahih al-Bukhari</td>
<td><code>bukhari</code></td>
<td>Urdu, English, Arabic</td>
</tr>
<tr>
<td>Sahih Muslim</td>
<td><code>muslim</code></td>
<td>English, Arabic</td>
</tr>
<tr>
<td>Jami&#39; at-Tirmidhi</td>
<td><code>tirmidhi</code></td>
<td>English, Arabic</td>
</tr>
<tr>
<td>Sunan Abi Dawud</td>
<td><code>abudawud</code></td>
<td>Urdu, English, Arabic</td>
</tr>
<tr>
<td>Sunan an-Nasa&#39;i</td>
<td><code>nasai</code></td>
<td>English, Arabic</td>
</tr>
<tr>
<td>Muwatta Malik</td>
<td><code>malik</code></td>
<td>English, Arabic</td>
</tr>
<tr>
<td>Riyadh as-Saliheen</td>
<td><code>riyadussaliheen</code></td>
<td>English, Arabic</td>
</tr>
<tr>
<td>Al-Adab al-Mufrad</td>
<td><code>adab</code></td>
<td>English, Arabic</td>
</tr>
<tr>
<td>Bulugh al-Maram</td>
<td><code>bulugh</code></td>
<td>English, Arabic</td>
</tr>
<tr>
<td>40 Hadith Qudsi</td>
<td><code>qudsi</code></td>
<td>English, Arabic</td>
</tr>
<tr>
<td>40 Hadith Nawawi</td>
<td><code>nawawi</code></td>
<td>English, Arabic</td>
</tr>
</tbody>
</table>
<p>40 Hadith Qudsi and Nawawi are only forty hadith long and therefore only need a hadith number. For example: <code>+hadith qudsi 32</code></p>
<h4 id="-ahadith">+ahadith</h4>
<p>is the same as <strong>+hadith</strong>, but sends the hadith in Arabic.</p>
<h4 id="-uhadith">+uhadith</h4>
<p>is the same as <strong>+hadith</strong>, but sends the hadith in Urdu. Only Sahih al-Bukhari and Sunan Abu Dawud are available in Urdu.</p>
<h3 id="prayer-salaah-times">Prayer (Salaah) Times</h3>
<p>The bot can also fetch the prayer times for any location. More precise locations will yield more accurate prayer times. </p>
<pre><code>+prayertimes <span class="hljs-string">[location]</span>
</code></pre><p>For example:</p>
<pre><code>+prayertimes <span class="hljs-keyword">Burj </span>Khalifa, Dubai
</code></pre><p>..would fetch prayer times in the general area of the Burj Khalifa in Dubai. </p>
<h3 id="hijri-calendar">Hijri Calendar</h3>
<h4 id="-hijridate">+hijridate</h4>
<p>This shows the current Hijri date (in the US).</p>
<h4 id="-converttohijri">+converttohijri</h4>
<p>Converts a Gregorian date to its corresponding Hijri date.</p>
<pre><code><span class="hljs-addition">+converttohijri DD-MM-YY</span>
</code></pre><p>For example:</p>
<pre><code>+converttohijri <span class="hljs-number">31</span><span class="hljs-number">-08</span><span class="hljs-number">-2017</span>
</code></pre><h4 id="-convertfromhijri">+convertfromhijri</h4>
<p>Converts a Hijri date to its corresponding Gregorian date.</p>
<p>For example, to convert 17 Muharram 1407:</p>
<pre><code>+convertfromhijri <span class="hljs-number">17</span><span class="hljs-number">-01</span><span class="hljs-number">-1407</span>
</code></pre><h3 id="random-generator">Random Generator</h3>
<h4 id="verse">verse</h4>
<pre><code>+<span class="hljs-built_in">random</span> verse
</code></pre><p>Gets a random verse from quran</p>
<h2 id="quran-audio">Quran Audio</h2>
<h3 id="-play">+play</h3>
<p>instructs the bot to play a recitation of a surah, ayah or page from the Qur&#39;an. </p>
<h4 id="playing-a-surah">Playing a surah</h4>
<pre><code>+play <span class="hljs-string">[surah number]</span> <span class="hljs-string">[optional reciter]</span>
</code></pre><p><strong>OR</strong></p>
<pre><code>+play <span class="hljs-string">[surah name]</span> <span class="hljs-string">[optional reciter]</span>
</code></pre><p>If no reciter is specified, Mishary al-Afasy&#39;s recitation will be used. 
<a href="https://github.com/nullbyto/MuslimBot/blob/master/Reciters.md">Click here for the list of <strong>surah</strong> reciters</a>.</p>
<p><strong>Example 1</strong>: <code>+play surah al-fatiha Shaik Abu Bakr Al Shatri</code></p>
<p>This would play Abu Bakr al-Shatri&#39;s recitation of Surah al-Fatiha.</p>
<p><strong>Example 2</strong>: <code>+play surah 112 Abdulrahman Alsudaes</code></p>
<p>This would play Abdul Rahman al-Sudais&#39; recitation of Surah al-Ikhlas. </p>
<h4 id="playing-a-single-ayah">Playing a single ayah</h4>
<pre><code>+play ayah <span class="hljs-string">[surah]</span>:<span class="hljs-string">[ayah]</span> <span class="hljs-string">[optional reciter]</span>
</code></pre><p>If no reciter is specified, Mishary al-Afasy&#39;s recitation will be used.</p>
<p><strong>Example</strong>: <code>+play ayah 2:255 hatem farid</code></p>
<p>This would play Hatem Farid&#39;s recitation of Surah al-Baqarah, ayah 255.</p>
<h4 id="playing-a-single-page-from-the-mushaf">Playing a single page from the mushaf</h4>
<pre><code>+play page <span class="hljs-string">[page number]</span> <span class="hljs-string">[optional reciter]</span>
</code></pre><p><code>[page]</code> must be between 1 and 604.
If no reciter is specified, Mishary al-Afasy&#39;s recitation will be used.</p>
<p><strong>Example</strong>: <code>+play page 10 hani al-rifai</code></p>
<p>This would play Hani al-Rifai&#39;s recitation of the 10th page of a standard <em>mushaf</em>.</p>
<h3 id="-reciters">+reciters</h3>
<p>Gets the lists of reciters for <code>+play</code>.</p>
<p>There are two lists. One is for surah recitations, and the other is for ayah/page recitations. <a href="https://github.com/nullbyto/MuslimBot/blob/master/Reciters.md">Click here for the list of <strong>surah</strong> reciters.</a></p>
<h4 id="-search">+search</h4>
<p>Use <code>+search</code> to search the list of reciters for <code>+play</code>. For example, <code>+search dossary</code> would return Ibrahim al-Dossary and Yasser al-Dossary.</p>
<h3 id="-live">+live</h3>
<p>Plays a live audio stream.</p>
<ul>
<li>Type <code>+live makkah</code> for a stream from al-Masjid al-Ḥarām in Makkah.</li>
<li>Type <code>+live quran</code> for Qur&#39;an radio.</li>
</ul>
<h3 id="-pause">+pause</h3>
<p>Pauses the audio.</p>
<h3 id="-resume">+resume</h3>
<p>Resumes the audio.</p>
<h3 id="-stop">+stop</h3>
<p>Stops the audio.</p>
<h3 id="-leave">+leave</h3>
<p>Disconnects the bot from voice chat.</p>


MuslimBot

This Bot is our Muslim Companion which plays/streams Quran audio in your voice channel and more islam related functions. 

Voting for MuslimBot

Do you want to support us?