Progress

Review

Suspended

Stats

Today

Current state

Over time

Pace and finish date

Settings

Help & tips

Recite

Voice commands: what to say

During a session, while the microphone listens, say:

• Leave about 1 second of silence before a command, then say it in one go, at your normal pace.
• A command is never counted as a mistake; said twice in a row, it acts once. The words it reveals count as hints, as with the buttons.
• While Yasser recites, the microphone waits for him; any button stops him.
• Settings can turn the commands off, or keep Yasser silent when a command reveals words.
• On Android the same phrases work in the car's Recite (Android Auto).

The buttons (right to left)

• next word shows what you forgot; a long press on it shows the rest of the ayah. With the microphone on they count as mistakes (hints, in brown; first reveals the first short red or taupe line of the page shown, a mistake on a word you have not said yet, if there is one); with the microphone off or no session they read in your mind and count as read, in every mode (see Text mode). The new word always comes on screen: its page opens and a hidden line scrolls into view. is pale green while a press counts as read, tan while it counts as a mistake; in Hidden it is white inside; in Shown it is not there (everything is on screen). After picking a surah in the top bar, starts at that surah's first word; another page starts at the page's first word.
• The microphone is the only button you need: press it and recite from anywhere. Meddeb first finds where you are (the page shown first: 3 words are often enough there; elsewhere a few words more), turns to that page and follows you. While it hesitates, it shows what it heard and the places it hesitates between: tap yours, or keep reciting until only one is left. Press it again: the microphone is off, your reading stays open ( then reads in your mind); on the same page a press goes on at once. There is no stop button: your reading is saved by itself after 10 minutes without recitation, or when you start somewhere else (a short note says "Saved · 2 mistakes"); a voice command said first («الكلمة التالية») starts on the page shown. The first press loads the speech model (on Android it listens at once meanwhile: recite, Meddeb catches up once the model is loaded; if it cannot load, nothing is saved). A phone downloads it by itself once (about 130 MB): a thin bar above the buttons shows the progress, the microphone has a dashed outline meanwhile, and a press then starts once it is there (press again to cancel); without internet it tries again by itself. Its drawing says its state: off (a press listens), listening to find your place, listening, with a pulsing ring (a press switches it off), the speech model loading.
• n: this session's mistakes (tap: this page's). Long press: the session summary, with ◀ / ▶ for the older / newer saved sessions (each one opens on the page with its colours and your recording) and ↺ Reset (outside a session: clears the verdicts, the counters and the revealed words; saved sessions stay). : what I hear does not match the page. The small bar: green, go ahead; orange, slow down; red, wait for the recognition to catch up; empty while paused, hidden outside a session.

A session follows you into the next surah and onto the next pages; it closes by itself after 10 minutes without recitation, or when you start somewhere else (and when Meddeb exits).

A message above the buttons hides by itself; its ✕ hides it at once.

Colours on the words

• Red: a mistake (another word heard); underlined: skipped; dotted underline: lost, you jumped ahead. In Hidden and Blind, during a session, a mistake on a word you have not said correctly yet is a short red line: the word stays hidden until you say it, reveals it, or the session stops.
• Taupe: being confirmed as a mistake (a taupe glow, or a short taupe line in Hidden and Blind); within seconds it turns red or clears.
• Brown: revealed with (the microphone on) or a voice command (a hint).
• A soft glow behind a word is its history (past readings and this session's final verdicts): red = 2 or more mistakes in your last 5 readings, orange = 1, green = recovered (none in the last 5, at least one in the last 10).

A tap on a word

Shows what was heard, the verdict and the word's history; plays your own recording of the word or of its ayah (words of this session or of a saved one); + Mistake, + Correct and Remove correct the verdict, now or any time later. A tap on a short red or taupe line shows the same without the word itself. Closing the window stops your recording.

Double tap a word: it becomes a mistake; a mistake Meddeb found in this session (or in your last one, still red), or one you just added, is marked correct instead, and a hint () is taken back; double tap again to undo: Meddeb's own verdict comes back as it was (skipped, wrong, lost or the hint). This works on a word you have not recited yet too. In Hidden and Blind a short red line you double tap shows its word, and the word stays on screen: red again after the undo, and so on.

A red between two words is a word you said where none is written (an insertion): tap it to hear it and see when it happened. To mark one on the phone, long press the word after the extra one (the mark goes before it, on its right: after half a second a buzz and a pale mark say let go), or double tap between two words (on the PC also drag from a word onto the next one), or + Inserted before in a word's window; again to undo; a double tap on it takes it away.

The page

• Text mode (top right): Shown, Hidden (grey blocks as long as the words), Blind (nothing until recited or revealed; an ayah's number appears with the next ayah's first word, not as soon as the ayah ends, and as an empty ﴿ ﴾: the number itself would be a clue). The modes only change what is drawn: in every mode, once you switch the microphone off (or with no session in Hidden or Blind: then starts one, the microphone off), reads in your mind: each word it shows counts as read, in Progress, Stats and Review (a silent revision); double tap a word you got wrong, the microphone button listens again. Hidden is practice: the words recited or read while the mode is Hidden do not count as correct (their mistakes and hints still do; the rest of the session counts; the car's recitations always count), and + Correct (or Remove mistake) on a word no session on screen read is not saved there.
• In Blind, before any word of the page shows (with or without a session): pull down on the page (on the PC: drag down with the mouse, or ↓) to see the last lines of the page before, greyed: as many as it takes to know exactly where this page starts, sometimes one or two more. A page that starts a surah says its name instead. A tap, a pull up, the first word you say or reveal, or a page turn puts them away.
• In Blind, when you start further down the page, a … before the first word shows that the words before it were not recited (on its line, or alone on the blank line above it).
• A tap on an ayah's number (﴿62﴾) underlines the fewest words before it that occur only once in the Qur'an: after them the next ayah is certain, so a reciter can go on from there (they may start on the page before: the message says so). In Hidden and Blind, outside a session, these words show until your next tap; during a session only what is on screen is underlined. A double tap there marks an insertion, as between two words.
• Display (top bar): fit page, fit width (bigger text, the page scrolls), own size (pinch with two fingers).
• Swipe to the right for the next page (a right-to-left book; a swipe back opens the page before at its end), or type the page number. In fit width and own size, at the end of the page pull up or tap Page n › (in Shown the next page's first line shows greyed under it).
• Keyboard (PC): S or F the microphone · P microphone off / on · N next word · A rest of the ayah · R reset · H text mode · V display · ← next page · → previous page · ↓ end of the page before (Blind) · Esc close.

Send feedback

☰ › Send feedback takes a screenshot of the page as you see it (on Android, saved in Download/Meddeb, the newest 10 kept; the PC takes none) and opens a new GitHub issue that already names the app version, the phone, the screenshot and the session. Describe there what happened and what you expected. Nothing is attached or uploaded: the screenshot stays on the device. A running session pauses (also while Yasser or your replay plays). On Android you can also shake the phone (three firm shakes) once Settings › Developer › Shake the phone to send feedback is ticked (off by default): the report starts at once, an open word window included.

Listen

• The speaker, left of the microphone (while the microphone is off), opens Listen: the page turns to Shown and a panel opens above the bar, on the page shown. Its rows: the quick chips, then Surah : Eyah (a surah, from an ayah to an ayah) or Page (from a page to a page), then the bar: ✕, how long it plays, the plays (×18 = the range 18 times) and . Surah : Eyah comes first; the tab you use is remembered.
• The quick chips fill in the range: Weak page (the most mistakes), Learn page (around your next ayah to learn), Oldest page (the pages you recited longest ago). Each shows once it has something to play (Weak page after your first mistake, Oldest page after your first recited page).
• Picking From shows its ayah on the page, picking To shows the end; the range is tinted. The length: one play, then all the plays with their pauses and Vary's extra ayat (on average), e.g. ≈ 5 min · total 20 min; its full line (what the range holds, an ayah left out) is the length's tooltip.
• ✕, Back or Esc close the panel without playing: the page, its place and the text mode come back.
• plays and folds the panel into one row: the chip ( 2:255 · 3/18: the ayah and the play; a tap opens the panel again for another range), / and , and the microphone on the right. The page follows the ayah, which glows yellow. The microphone stays a microphone: pressing it stops Listen and you recite. Hidden and Blind stop Listen too.
• A paused Listen leaves the bar to Recite when you open Meddeb or come back to Recite: resume it from the notification.
• Settings › Listen: Reciter: Yasser Al-Dossary 🕋 (the default), Abdul-Rahman Al-Sudais 🕋, Yasser Salamah (Hadr: fast, every surah), Mishary Alafasy or Fares Abbad, all Hafs. 🕋: an imam of Masjid al-Haram. Mix: a different reciter on every play, in that order. Meddeb selection ❤: a reciter chosen per surah: Al-Fatiha by Yasser Al-Dossary in maqam Kurd, Maryam by Islam Sobhi, Taha, Yasin and Ar-Rahman by Yasser Salamah in Hadr, An-Nahl and Juz' Amma by Mishary Alafasy, Al-Mulk by Fares Abbad, the rest by Yasser Al-Dossary. The choice plays Listen, its quick chips and Review's (on Android also the car's Listen and the shortcuts); the voice commands, the Recite cue and the car's travel dua stay Yasser Al-Dossary (Meddeb knows where his words start). For Sudais, Alafasy and Fares the length shown is an estimate. Resuming a listening keeps its reciter.
• Against the loop effect, in Settings › Listen too (both greyed with Repeat 0, ×1): Vary start and end (off by default): every play after the first, which is always the exact range, starts up to 4 ayat earlier and ends up to 4 ayat later, at random, never across a surah; a play that ends on an extra ayah fades out in its middle and leaves the rest to your memory. Pause between plays: a silence after every play but the last (6 s by default, 0-30); ⏭ skips it.
• It keeps playing with the screen off (notification). Starting a recitation stops it.
• The recitations come from EveryAyah.com (one file per ayah) and, for Yasser Al-Dossary, from QuranicAudio.com's whole surahs; the Meddeb selection's Islam Sobhi from mp3quran.net, Yasser Salamah's Hadr from archive.org (TvQuran.com; his murattal from EveryAyah where a surah has no Hadr times yet, named so): the internet is needed the first time (Android keeps the files). Every file is checked for background ticks before Meddeb plays it and a ticking one is never played: where Yasser Al-Dossary's usual files tick, his other recording from archive.org plays the whole surah; an ayah with no recording of his without ticks yet is left out (the length's tooltip counts them). The voice commands and the Recite cue play the same clean recording where Meddeb timed it; where it is not timed yet they say nothing.

Progress

• What to do now: three tasks (four with Review), old before new: Oldest page, Weakest page, Review (where it exists) and Next to learn, each with a box. A green box with means done for today, an empty box means still to do. Built from everything you recited and marked; a word counts as a mistake when its latest reading is one. Before your first recitation only Next to learn shows, with a short guide where the table will be; each other line appears once it has something to say.
• Oldest page (the manzil): the page recited longest ago, to revise. Done while its age is green (recited less than 6 days ago); to do once it turns orange (6 days) or red (30 days). Once more than 10 pages hold an ayah you learned, you recite Al-Fatiha in every prayer: page 1 stays green and is never the Oldest page.
• Weakest page: the page with the most mistakes. Done unless its count is red (3 mistakes or more).
• Next to learn: the first ayah with a word you never recited, moved back over the ayat with mistakes just before it. Done once it moved forward by at least one ayah today (since midnight on your device's clock); a new mistake can move it back. It stays to do while you never recite the ayah it names. A grey lock replaces its empty box when 3 or more pages are red (the page you are learning not counted) or more review cards are due than a day holds (Settings › Review › Cards a day, 15 by default): advice to fix the weak pages or catch up the Review before new ayat (the reason is written under it). The Review's backlog counts every card, the page you are learning and the cards waiting for the next days too, so that lock can stay after today's round: it lifts once the backlog is down to a day's cards, or once Next to learn moved forward today. It is only advice: its link still works, and once it moved forward today the box is checked. Listen's Learn page and the car's Next to learn show the lock too and still play.
• The table has one row per page holding an ayah you recited whole (every word read, mistakes or not). Surah: the surahs of the page; "… • Maryam" when the surah of the row above goes on and Maryam starts on the page. Err: its words counted as mistakes (green 0, orange 1-2, red 3+). Days: how long ago its recited part was last recited in full: today, 1 … 99 days, 99+ for longer (green under 6 days, orange from 6, red from 30; on a computer, hovering it shows the date). ◔: a small pie, how much of the page is learned (approximate: the share of its words in learned ayat with no mistake or hint now); the empty part is still to learn. Sorted by page, a thin row "⋯ 3 pages never recited" marks the pages missing between two rows. The column names stay at the top while you scroll.
• Tap a column name to sort (again: reverse). Tap a page or a line to open it; an ayah link shows its ayah (it glows a moment), and the microphone follows you from anywhere on that page.

Stats

• Computed from the same history each time the page opens; nothing new is stored or sent. A day runs from midnight on your device's clock. An ayah is learned once you recited it at least once entirely without any mistake or hint (in one session; a false alarm you removed counts as right).
• Today: the ayat you learned today; Mistakes corrected: words whose last reading before today was a mistake and that you recited right today, without a hint (a + Correct or a Remove alone, or a mistake made and fixed the same day, does not count); Pages recited: the words you recited today counted in pages (a whole page = 1, half a page = 0.5).
• Current state: Total learned: learned ayat out of 6236. Perfect learning: learned ayat with no word whose latest reading is a mistake or a hint; an ayah never recited without a mistake or hint is not learned. With a mistake now: the ayat (and words) whose latest reading is a mistake, learned or not (the Err of the Progress table, added up). Last learned: among the learned ayat with no mistake or hint left (Perfect learning), the one learned last (an ayah that still has a mistake is to learn again).
• New ayat learned: the ayat you learned this week (from Monday) and this year. An ayah counts once, on the day of its first recitation without a mistake or hint; reciting it again does not count it again. Once the whole Qur'an is learned, a count at 0 is hidden.
• Over time starts with Pace over: Since the beginning, the Last 4 weeks (the default) or the Last 7 days (the days since your first recitation while that is shorter, at least 7 days). Everything under it follows the choice, which is remembered.
• New ayat a week and Pages recited a day: averages over those days (a day without a recitation counts 0).
• The chart shows, day by day, Total learned, Perfect learning and Next to learn (its place in the mushaf in ayat: how many ayat come before it) over the days chosen in Pace over (from the day before them; its height starts near their lowest value), with each line's change a week over those days. Tap a name under it to hide or show its line; tap or point at the chart to read a day.
• Finish date: when the whole Qur'an would be learned at the pace chosen in Pace over (the ayat left divided by the new ayat a week over those days). Choose a shorter window when the ayat you already knew, recited at first, make the pace too fast; the averages and the chart follow it too.
• Mistake detection, over the same days: how well Meddeb finds your mistakes. Precision: of the mistakes Meddeb found, the share that were real (you did not remove them, by a double tap, Remove or + Correct). Recall: of your mistakes, the share Meddeb found (the ones it missed are those you added: + Mistake or a double tap). Words read in your mind (a card with the microphone off, Blind paused) and the words of a hint () it had not found do not count. A mistake you never checked counts as real: the figures are only as good as your checks.
• Hidden is practice: its correct words are not counted as recited (no pages, no ayat learned); its mistakes count.