{{ summaryTitle }}
{{ summaryValue }}

{{ summaryLine }}

Target{{ resultsReady ? formatHours(computation.values.target_minutes) : '—' }} Gap{{ resultsReady ? formatHours(computation.values.gap_minutes) : '—' }} Busiest day{{ resultsReady ? formatHours(computation.values.busiest_day_minutes) : '—' }}

{{ summaryAnnouncement }}

Start {{ block_minutes }} min sessions Review buffer Exam
Revision subjects, exam dates, and weekly availability
Every exam must be 1–365 days after this date.
Format: Subject | YYYY-MM-DD | priority 1–5 | difficulty 1–5 | target hours. Use 1–12 rows.
{{ block_minutes }} min
Choose 30–180 minutes; 45–60 minutes usually keeps sessions manageable.
min
Enter 0–12 hours per day. The Advanced daily cap can limit larger entries.
Balanced combines remaining workload, urgency, priority, and difficulty.
Neutral spacing default: 1 day. Use 0–4 days.
days
Mixed alternates first passes and spaced reviews; the other modes specialize timetable activity labels.
Use 0–7 days; the default keeps the day before each exam free of ordinary sessions.
days
Use 1–12 hours; entries above the cap appear in Plan checks.
h/day
The same start time applies to every generated study day.
Use 0–45 minutes; breaks change clock times, not planned revision minutes.
min
Separate dates with commas, spaces, or new lines.
DateTimeSubjectMinutesFocusExamCopy
{{ row.dateLabel }}{{ row.time }}{{ row.subject }}{{ row.minutes }}{{ row.focus }}{{ row.exam }}

{{ tableExportStatus }}

SubjectExamTargetPlannedGapStatusCopy
{{ row.subject }}{{ row.exam }}{{ formatHours(row.target) }}{{ formatHours(row.planned) }}{{ formatHours(row.gap) }}{{ row.status }}

{{ tableExportStatus }}

The chart renderer is unavailable. Planned and target hours remain available in the coverage ledger.

{{ chartExportStatus }}

CheckDetailCopy
{{ row.title }}{{ row.detail }}

{{ tableExportStatus }}

Exam revision becomes a scheduling problem as soon as several subjects compete for the same limited hours. A useful plan has to respect fixed exam dates, divide large targets into sessions, and show early when the available time cannot cover the intended workload.

Spacing matters because a subject revisited across separate days gives memory another retrieval opportunity. Practice testing and distributed practice have broad support as learning techniques, but a timetable cannot guarantee learning. The quality of each session still depends on what is practised, how feedback is used, and whether weak areas are revisited.

Three quantities are easy to confuse:

Target hours
The total study time assigned to a subject before its cutoff.
Available hours
The realistic time that can be used on each weekday after other commitments.
Scheduled hours
The time that actually fits into complete sessions, plus any shorter final session needed to finish a subject target.

A plan can therefore leave unused availability and still show a coverage gap. For example, a 45-minute opening cannot hold a 60-minute session, and time close to an exam may be excluded by the review buffer. Those constraints are more useful than a timetable that fills every hour but hides impossible targets.

Priority and difficulty are planning weights, not measurements of how much a student will learn. An urgent examination may need attention even when another subject is harder, while a difficult subject may deserve more early repetitions when deadlines are similar. The best schedule is one that can be followed and revised as practice results change.

Use generated dates as a draft commitment. Check school deadlines, travel, rest, sleep, and other fixed obligations before relying on it, then update target hours when a mock paper or recall session shows that the original estimate was wrong.

How to Use This Tool:

Start with the constraints that cannot move, then choose how the remaining sessions should compete for time.

  1. Enter the Plan start date and one Subjects and exams row per subject in the shown five-part format. Each exam must be 1 to 365 days after the start date.
  2. Set a realistic Session length from 30 to 180 minutes and enter usable hours for each weekday. At least one weekday must have time available.
  3. Choose Balanced coverage, Front-load earlier exams, or Weak-subject priority. Use the advanced settings only when repeat spacing, a review cutoff, a daily cap, rest dates, start time, or breaks changes the plan you can actually follow.
  4. Read the summary before the timetable. If it says Revision capacity is short, open Coverage ledger and Plan checks to find the subject gap or blocked capacity.
  5. Review the dated sessions and the planned-versus-target chart. Change availability, target hours, session length, or the scheduling strategy when the sequence does not match real commitments.

Interpreting Results:

Gap is the main feasibility signal. Zero means every entered target fitted before its scheduling cutoff; it does not mean the sessions are sufficient for mastery. A positive gap is unscheduled target time, so adding more subjects without changing capacity will not solve it.

  • Covered means no target minutes remain.
  • Near target means at least 80% of the target was scheduled but some time remains.
  • Short means less than 80% of the target was scheduled.
  • Busiest day reports scheduled study minutes, not breaks or other obligations.

Check the actual dates as well as the totals. A mathematically covered plan may still be impractical if several demanding sessions land on the same day or the common start time conflicts with school, work, or travel.

Technical Details:

The planner uses a deterministic allocation heuristic. It turns weekly availability into fixed-length slots, removes rest dates and dates outside each subject's cutoff, then assigns each open slot to the highest-scoring eligible subject. The same valid inputs always produce the same timetable.

Formula Core

Daily capacity is the smaller of entered availability and the daily cap. Only complete session slots are created, although the final session for a subject may be shorter than the selected session length.

Cd=60×min(Ad,L) Nd=CdB Gap=max(0,target minutesplanned minutes)

Ad is entered availability in hours for that weekday, L is the daily cap in hours, Cd is capacity in minutes, B is session length in minutes, and Nd is the number of slots. Break minutes change displayed clock times but do not add study capacity.

Rule Core

For each open slot, the remaining-work ratio, priority, difficulty, exam urgency, and a recent-repeat penalty form the subject score. The selected strategy changes the weights but not the eligibility rules.

Sbalanced=4R+0.8P+0.6D+18days+1penalty Sfront=3R+0.7P+0.4D+30days+1penalty Sweak=3.5R+0.6P+1.45D+14days+1penalty

R is the fraction of target minutes still unplanned, while P and D are the entered priority and difficulty from 1 to 5. The repeat penalty is 2.4 for another session on the same day. Within the selected repeat gap it is 1.2 plus 0.55 for each remaining gap day; outside that interval it is zero. A penalty discourages immediate repetition but does not make an urgent subject ineligible.

A session date is eligible when it is on or before exam date minus review-buffer days. Rest dates and weekdays with zero availability are skipped. Ties go to the earlier exam, then alphabetical subject name. The planner stops when all targets are covered or no more eligible capacity exists.

Input and output boundaries for the revision allocation model
RuleExact behavior
Subjects1 to 12 rows; priority and difficulty 1 to 5; target 0 to 200 hours.
DatesValid calendar dates; exams 1 to 365 days after the plan start.
Availability0 to 12 hours per weekday, with at least one non-zero day.
Coverage statusCovered at zero gap; Near target at 80% or more with a remaining gap; otherwise Short.
PrecisionTarget hours are rounded to whole minutes. Capacity uses whole minutes, and slot count is rounded down.

Accuracy Notes:

This is a planning heuristic, not an evidence-based prediction of exam performance. Priority, difficulty, and target hours are subjective inputs, and the model does not know about syllabus size, current mastery, teacher guidance, travel, fatigue, or the quality of practice.

  • Use target hours as revisable estimates rather than promises.
  • Check that the common daily start time works on every scheduled date.
  • Rebuild the plan after a missed session or a meaningful change in exam date, availability, or mastery.

Worked Examples:

Two-hour mathematics target

With a plan starting on 1 September 2026, a mathematics exam on 3 September, two hours available on the first day, 60-minute sessions, a one-day review buffer, and 10-minute breaks, the target becomes two sessions at 16:00–17:00 and 17:10–18:10. Planned time is 120 minutes, the gap is zero, and the second session is labelled as a spaced review. This illustrates that breaks move clock times without increasing planned study minutes.

References: