Skip to content
All documentation

feature

Reading History

Track everything you read, with full control over your privacy.

History keeps a record of what you read and when — every verse, narration, search, round of dhikr, saved item and Divine Name — and shows you what that record means: how much of the Qur'an you have covered, when in the day you actually read, how your reading sits against your prayer times and the Islamic calendar, and whatever questions you want to ask of it.

The log and the dashboard are free for everyone. Premium adds the Insights deck and removes the limits in the Studio.


Getting there

  1. From the Home screen — tap See All beside Recent
  2. From Tools — tap Tools in the bottom navigation, then History

Both open the same section, which has three tabs: Dashboard, History and Studio.


What gets tracked

History records activity automatically. Nothing needs saving by hand.

Section What lands in the log
Qur'an Each ayah you open
Hadith Each narration you read
Random Hadith Each drawn hadith you actually see — once, however often the card comes back into view
Search What you searched for, once you stop typing
Tasbeeh Each finished dhikr sitting, with its count — back-to-back rounds of the same dhikr add up on one line
Collections Everything you bookmark
Divine Names Each name you open

Every entry carries its title, its section, the exact time, and how long you spent with it.

The same thing twice

Open something, leave it, and open it again straight after, and the log keeps one entry — the time you spend on the second look is added to the first. A return from a sheet, a turn of the phone, or going back to check a word are all the same visit.

Three things still make a new entry, on purpose:

  • Something else in between. Read one hadith, then another, then the first again, and all three are in the log — that is the order you read them in.
  • A new day. Reading on a new day is that day's reading, so it counts towards your streak, your active days and that day's bar on the chart — even if it is the same ayah you finished on last night.
  • A different kind of activity. Bookmarking a hadith and reading it are two different things, and both are kept.

A random hadith is recorded when you first see it. Coming back to the home screen, where the card is waiting on the same page, does not record it again. Two rounds of the same dhikr one after the other become one line of their combined count and time — SubhanAllah × 66, not two lines of 33.

What counts as read

Opening something is not the same as reading it. Swiping through a surah to find one ayah "opens" forty of them, and a history that records all forty is a record of your thumb rather than your reading.

Under Studio → What counts as read, choose which:

Mode What happens
As soon as I open it Every passage you open is recorded straight away.
Once I've stayed a while A thin line fills under the reference as you read. When it completes, the passage is recorded. Choose 3, 5, 10, 20, 30 or 60 seconds; turn the line off to record quietly. The default, at 5 seconds.
Only when I say so Nothing is recorded until you tap Save to history, which appears under the reference.

Leaving a passage before a timed line completes records nothing — that is the point of the mode. Reading time is measured from the moment the passage is recorded.

About reading time

Reading time is measured for each passage you read. Where a period includes reading without a recorded duration, the app states what proportion of the period it could time, so the figures you see are always your own.

A sitting shorter than two seconds is not counted — that is a swipe passing through, not a reading. A screen left open and forgotten counts for at most thirty minutes, so one evening with the phone left open does not outweigh a month of reading.


Choosing a period

Above the tabs is the period selector. Everything on the Dashboard responds to it.

Gregorian: All · Today · Yesterday · 3 Days · 7 Days · 30 Days · 3 Months · 1 Year · 2 Years · 3 Years, plus a calendar button for any custom range.

Hijri — scroll the row to the end for periods in gold:

  • The current Hijri month, named — "Safar 1448"
  • The current Hijri year — "1448 AH"
  • The last ten nights of the most recent Ramadan
  • The last three Ramadans, named by year — "Ramadan 1447", "Ramadan 1446" …

Ramadans are named by year rather than called "this Ramadan", because for most of the year "this Ramadan" would mean one that finished months ago.

Choosing a Hijri period re-runs every metric on the Dashboard over exactly that window.


History tab

The log itself: every entry, newest first, with its title, section and timestamp.

  • Tap an entry to reopen what you read
  • Delete icon — remove that entry

Filter chips above the search bar show each section with its count; tap to narrow, tap again to widen. Search filters by title as you type. Sort lives under the ⋮ menu.

Search entries are kept as a record of what you looked for, and count towards your totals; to search again, use Search.


Dashboard tab

Always free

  • Total reads and unique reads for the period
  • Current streak and best streak (all-time, so they do not change with the period)
  • Active days and average reads per day
  • Section reads — Qur'an, Hadith, and the daily average, each with its unique count
  • Activity over time — a pillar per day, week, month or year depending on the span
  • Reading by hour of day
  • Reads by section — a share of every section that has entries

Premium: the Insights deck

Below the free cards, the same period is read more deeply. A free account sees every headline figure — they are your own numbers, and they are never estimated or sampled — with the detail behind each one held back.

Time in the text — total time read, your typical sitting, your longest, and where that time went across sections.

Your Ramadan — the month night by night, the last ten nights marked, how much harder they were worked than the first twenty, and the change on the Ramadan before. This card always shows Ramadan regardless of the period selected.

Days that move you — how much more you read on Fridays, in Ramadan, on the White Days, on Mondays and Thursdays, in the sacred months, measured against your own ordinary days. A comparison is only shown when there is enough of both sides for it to mean anything.

When you read — every reading placed against your own prayer times: Fajr to sunrise, Duha, Dhuhr to Asr, Asr to Maghrib, Maghrib to Isha, Isha to midnight, after midnight, and the last third of the night. Requires a location set in Prayer Times.

Qur'an coverage — what share of all 6,236 ayat you have read, how many surahs you have started and finished, a bar for every surah, and the largest one you have never opened.

Hadith coverage — the same for every collection you have installed.

What you return to — reads per distinct passage, and the passages you come back to most.

Against the period before — this window against the one immediately before it, in reads, time and active days. Not shown for "All", which has nothing before it.


Studio tab

Everything on this tab is yours: your targets, your review queue, your questions.

Goals

A goal is a target on a measure, every day, week or month.

Choose what counts (reads, distinct passages, time read or active days, optionally narrowed to particular sections), how often it resets, and the number. Each goal shows a progress ring, what is left, whether you are ahead of, on, or behind pace for the period so far, your run of met periods, and a bar for each completed period with the met ones in gold.

The period in progress never counts against your streak — a weekly goal is not broken on Monday morning.

Free: one goal. Premium: as many as you like.

Revision Radar

Passages you chose to come back to.

You mark a passage while you are reading it, not while scrolling a log:

Mark Meaning First returns in
Needs review Bring it back soon 1 day
Understood Bring it back occasionally 7 days
Memorised Bring it back rarely 35 days

When something is due, the Radar says so and offers to walk you through the queue. For each passage there are two answers — Still with me, which lengthens the interval before it returns, and Bring it back, which returns it to the shortest interval. Intervals run 1, 3, 7, 16, 35, 75 and 150 days.

Free: three tracked passages. Premium: unlimited.

Lenses

A lens is a question you compose, on four axes:

Axis Choices
What to count Any combination of sections
When A period, particular weekdays, and an Islamic-calendar filter — Ramadan, the last ten nights, Fridays, Mondays and Thursdays, the White Days, the sacred months, the first ten of Dhul-Hijjah, Muharram
How to measure Reads · distinct passages · time read · active days
How to break it down Total · day · week · month · weekday · hour · section · hadith collection · surah · how you got there
How to show it A single figure, bars, or a table

The answer updates live as you build, so you can see immediately whether you asked what you meant. Name it and it joins your board, where it re-answers itself as your reading grows.

Eight starting points are offered — Night reading, Qur'an by month, Jumu'ah habit, Last ten nights, Where I find things, Weekend vs weekday, Time in the Sunnah, Dhikr sittings — each a complete lens you can save as it is or adjust.

By default a lens follows the period selected at the top of the screen; you can pin it to its own instead.

Free: one saved lens. Premium: as many as you like.


What Premium changes

Premium never changes your numbers, only how much of them you can see. Nothing in History is estimated, sampled or filled in with example data — a locked card shows your real figures with the detail behind them held back.

Going over a free limit never deletes anything. Extra lenses, goals and marked passages are kept and simply hidden until a subscription returns them.


Reading progress elsewhere

Progress derived from your history also appears outside this section:

  • Hadith books — the book list shows Your progress for each collection, as a segmented bar and a "read / total" count, and the same appears when you open a book

Qur'an progress is shown in the Qur'an coverage card on the Dashboard, with a bar for every surah.


Your data

All of it is stored on your device. Any entry can be removed from the History tab, and removing entries does not affect your collections, notes or anything else you have saved.


Common Questions

"How much of a period was timed"

The time cards state what proportion of the period's reading has a recorded duration. Reading time is recorded from version 4.6 onward, so a period that reaches back before then shows the share it could time.

"When you read and prayer times"

The card places your reading against your own prayer times, which come from the location set in Prayer Times. With a location set, your readings are placed against it.

"When Days that move you appears"

A comparison is shown when the period holds at least three of a kind of day — three Fridays, for instance — and some reading on ordinary days to compare against. A wider period gives it more to work with.

"Coverage shows <1%"

One ayah of 6,236 is less than a percent, so a first reading is shown as <1% rather than 0% — your reading is always counted.

"Which Ramadan the card shows"

Your Ramadan always shows the most recent Ramadan, from your own history, whatever period is selected.

"Seeing everything at once"

The Dashboard follows the period selector. Choose All to see your whole history.

"How streaks are counted"

A streak counts consecutive days with reading. Streaks are all-time, so they do not follow the period selector.

A day is your day — midnight to midnight where you are — so a reading at Fajr and a reading late in the evening each count towards the day they fall in, the same days the activity chart shows. Not having read yet today does not end a streak: it keeps running until today is over.


Related