~/study-schedule-generator pomodoro deep work gpa ☕ Support me apps ← about me
jasper@bernaers:~/study-schedule-generator$ ./plan --exams

> Study Schedule Generator█

Add your exams → get a spaced-repetition revision calendar — topics, busy days, progress tracking — no signup

Free exam revision planner with spaced repetition, topic-level sessions, busy-day exclusions, month calendar, progress tracking and .ics calendar export · 100% in your browser

When can't you study?

The planner only uses days you leave free. Tap the weekdays that are always taken (work, sport, commuting), and block single dates for trips, birthdays or a day off.

Highlighted days are skipped every week.
Usually today. Move it forward if you only start next week.
Used for the clock times in your calendar export.

How hard do you want to push?

Pick a pace. You can fine-tune every number below — the presets just set sensible values.

Fine-tune hours, sessions, reviews
The most you want to study on a free day.
Front-load does more early and leaves the last days light.
Light, final-review-only days right before the exam.
📅
No plan yet Add at least one exam, then press Generate my plan.

How this planner thinks

A plain-English tour of what the generator does with your exams — so you can trust the plan, or bend it to fit your life.

1

What you give it, and what you get back

You give the planner three things: what you are studying (an exam name, optionally split into topics), when the exam is, and how many hours you think it needs. You also tell it which days you can never study and how hard you want to push. In return you get a day-by-day calendar with clock times, a list of what to do today and this week, a progress bar per subject, and a file you can drop into your own calendar.

Hours: how to estimate

Start from the course size. As a rough guide, a university course exam often needs 20–40 hours of revision, a school test 8–15. Add more for subjects you find hard, fewer for ones you already know. If you are unsure, enter a number, generate, and adjust after the first week — the plan rebuilds in a blink.

Topics: when to use them

Splitting a subject into chapters (“Calculus 12h, Linear algebra 10h”) makes sessions concrete: instead of “Maths, 50 min” you see “Maths · Calculus, 50 min”. When you add topics, their hours replace the subject total.

Difficulty

Easy, medium and hard weight a subject’s share of your time (about 0.85×, 1× and 1.25×). A hard subject with the same exam date gets more of your best days.

2

Why it adds short reviews 1, 3 and 7 days later

Most of what you read once is gone within days. Psychologists have measured this since the 1880s: memory fades fast at first, then slowly — and each time you recall something just before you would have forgotten it, it fades more slowly. That is spaced repetition: several short revisits beat one long cram, even when the total time is the same.

0%25%50%75%100%013714 days since first study no review with reviews

Illustration, not a measurement: the red line is one study session with no revisit; the green line shows short reviews (blue markers) on day 1, 3 and 7. Real curves vary per person and subject.

With Spaced repetition reviews switched on, every study session gets half-hour reviews roughly 1, 3 and 7 days afterwards (on a free day close to that date), and the last days before each exam get a final review pass. About a fifth of your daily capacity is kept free so these reviews always have room.

3

How your hours are spread over the days

The planner first removes every busy weekday and blocked date, and keeps the buffer days before each exam free of new material. Then it deals out your hours across the remaining study days, never exceeding your hours per day, and cutting them into sessions of your chosen length with breaks in between.

Even spread

Same load every day. Calm and predictable; good if you have lots of time.

Front-load

More work early, less near the exam. The default: you get ahead, and the last days are for reviews and rest.

Cram (back-load)

Saves the work for the end. Only choose this if you know you will not start earlier — it is the least effective way to learn.

Mix subjects puts two or three subjects in one day rather than a whole day of one. Switching between topics feels harder while you do it, but it improves long-term recall and stops you hitting the same wall all day.

If there is not enough time before an exam, the planner does not pretend: it schedules what fits and shows a yellow warning with the number of hours you are short, so you can add free days, raise hours per day, or reduce the target.

4

A worked example

Say it is Monday. You have History (exam in 14 days, 18 h), Biology (28 days, 24 h) and Maths (21 days, hard, 30 h split into three topics). You work Tuesday and Thursday evenings, so those are blocked, and you pick Balanced. Here is what the first week could look like:

Notice how History — the nearest exam — appears first and most often, Maths gets its three topics on different days, and the dashed “review” sessions show up a few days after the first visit to each subject. The real calendar does the same thing for every day until the exams, with clock times.

5

Using your plan day to day

  • Coming up shows the next seven days. Tick a session when you finish it: your progress bars and percentage update straight away.
  • The calendar shows every day of the month. Click a day for its sessions with times, or to tick them off. Striped days are blocked, red outlines are exam days, dashed sessions are reviews.
  • Changing something (an exam date, a new busy day, a different pace) rebuilds the plan immediately, so edit freely.
  • Export to put it in your own calendar (.ics), a spreadsheet (CSV), a text list, or print it. Your phone then reminds you at the right time.
  • Your data stays here. Everything is saved in your browser only; nothing is uploaded and there is no account. Clearing site data removes your plan.
6

Tips for actually sticking to it

Plan for 80%

Life interrupts. If you can honestly do 4 hours, plan 3 and keep the rest as slack.

Start with the hard thing

Do your hardest subject in the first session of the day, when you are freshest.

Recall, don’t reread

In reviews, close the book and write down what you remember. Testing yourself beats rereading.

Missed a day? Don’t panic

Just generate again. The plan recomputes from today and spreads the rest over the days left.

Protect the buffer

The last day before an exam is for light review and sleep, not new material.

Pair it with a timer

Try the Pomodoro timer for focus, or log sessions in the deep work log.

Guide — a revision plan you can actually follow

Spaced repetition, interleaving, busy days and calendar export. Saved in your browser.
1Add your subjects

Name, exam date and the hours you need. Expand a subject to split it into topics with their own hours, and set its difficulty.

2Block busy time

Click the weekdays you can never study, and block single dates such as a holiday or a work shift.

3Tune the settings

Start date, hours per day, session and break length, buffer days before each exam, distribution, spaced reviews and interleaving.

4Generate

Press generate. Warnings tell you when the hours do not fit; click a day in the calendar to see and tick off its sessions.

5Take it with you

Export .ics for Google Calendar, Apple Calendar or Outlook, or CSV, plain text or a printout.

The defaults

TIMESessions
hours / day
4
session
50 min + 10 min break
buffer
1 day before each exam
PLANDistribution
front-load
more hours early (default)
even
the same every day
cram
more hours near the exam
MEMORYLearning techniques
reviews
about 1, 3 and 7 days after first study
interleave
2–3 subjects per day

Planning exam revision, explained

A study schedule turns a list of exams into a day-by-day plan: what to study, when, and for how long. This generator divides your hours over the days you really have, adds review sessions at growing intervals and keeps the last day before each exam free for light revision. Below: how the plan is built, the learning techniques behind it, the settings, and how to keep your plan safe.

How does this study schedule generator work?

Add each subject with its exam date and how many hours you think you need. The planner counts every available day between your start date and each exam, subtracts your busy days, then spreads the hours across those days — weighted by difficulty and how soon the exam is. You get a day-by-day calendar you can tick off as you go.

What is spaced repetition and why does it matter?

Spaced repetition means revisiting material at growing intervals instead of once. This planner automatically adds short review sessions roughly 1 day, 3 days and 7 days after you first study something, plus a final pass just before the exam. Decades of memory research show spaced review beats the same number of hours crammed together, because each retrieval strengthens recall.

What does interleaving do?

Interleaving mixes two or three subjects in a day instead of spending the whole day on one. It feels harder, and that is the point — switching forces your brain to retrieve rather than coast, which improves long-term retention and helps you tell similar topics apart. Turn it off in Settings if you prefer single-subject days.

Can I split a subject into topics or chapters?

Yes. Expand any subject and add topics with their own hour estimates. The planner then schedules individual topics rather than a vague block of study, so each session tells you exactly what to open. Topic hours replace the subject total when present.

How do I block out work shifts, classes or days off?

Use the Busy times panel. You can block specific dates (a holiday, a wedding) or recurring weekdays (every Tuesday, every Monday and Thursday). Blocked days get no study sessions, and their hours are redistributed across your remaining days automatically.

Can I export the plan to Google Calendar, Apple Calendar or Outlook?

Yes — click .ics to download a standard calendar file with each session as a timed event. Import it into Google Calendar, Apple Calendar, Outlook or any calendar app. CSV and plain-text exports are also available, plus a clean print view.

Does it track my progress?

Yes. Tick off sessions as you complete them and the planner shows hours done versus hours remaining per subject, an overall completion bar, and how many sessions are left before each exam. Progress is saved in your browser.

What happens if I do not have enough time before an exam?

The planner warns you when the hours you asked for do not fit the days available. It still produces the best plan it can, filling every available hour, and tells you how many hours short you are so you can either add study days, raise your daily limit, or trim your target hours.

How many hours a day should I study?

Most people do well with three to five hours of focused study per day, in blocks rather than one long stretch. More than that and quality usually drops. Set your realistic daily limit in Settings — a plan you actually follow beats an ambitious one you abandon on day three.

What is the buffer before an exam for?

The buffer reserves the last day or two before each exam for light review instead of new material. Cramming new content the night before tends to crowd out what you already know and costs you sleep, which is when memory consolidates. Set it to zero if you disagree.

How long should each study session be?

The default is 50 minutes of work with a short break, close to the classic pomodoro rhythm. Sessions of roughly 25 to 90 minutes suit most people. Adjust the session length in Settings and the planner will split each day into blocks with breaks between them.

Does the difficulty setting actually change anything?

Yes. It does not change the total — that is the number of hours you enter — but it changes when those hours fall: hard subjects are pulled earlier in the plan and easy ones lean towards their exam date, so the material you find toughest gets the most room for spaced review.

Front-load, even or cram — which should I choose?

Front-load puts more hours early, leaving room to react when something takes longer than planned; it suits most people. Even spreads hours uniformly. Cram back-loads toward the exam — it is offered because sometimes you genuinely start late, but it is the weakest option for retention.

Is my data private? Is anything uploaded?

Everything runs in your browser. Your subjects, settings and progress are saved to localStorage on your own device and never sent to a server. There is no account, no tracking of your plan, and no ads. Use the exports to keep a copy elsewhere.

Will I lose my plan if I close the tab?

No — it is saved automatically in your browser and reloads next visit on the same device and browser. Clearing your browser data or using private browsing will remove it, so export a copy if it matters.

Can I use it on my phone?

Yes, the layout adapts to small screens and the calendar scrolls. You can plan on a laptop and export to your phone's calendar with the .ics file, which is usually the most practical way to carry the schedule around.

How accurate are the hour estimates I should enter?

Estimate the total hours of active work each subject needs — reading, practice questions, past papers — not calendar time. If you are unsure, a common starting point is ten to fifteen hours per exam credit or one to two hours per lecture, then adjust after the first week once you see your real pace.

More free tools