A free school timetable generator for small schools
You know the lessons: 7A has five maths periods with Ms Okafor, four science periods in a lab, PE with 7B in the gym. What takes days is fitting them into the week so that nobody is in two places at once, the labs are not double-booked, double periods do not run across break, and Mr Lindqvist, who does not work Fridays, has nothing on a Friday. That fitting is a search problem, and a computer is good at it.
Who this is for
- Deputy heads and office managers at small primary, secondary and independent schools who build the timetable in a spreadsheet.
- Heads of department timetabling their own staff and rooms.
- Tutoring and language centres, music schools and homeschool co-ops running weekly classes.
Worked example: the sample school
The sample on the builder page is a small secondary school: four classes (7A, 7B, 8A, 8B), five days of six periods with breaks after periods 2 and 4, and 13 teachers. Every class is fully booked, 30 lessons in 30 periods, so there is no spare slot to hide a clash in. Science is taught as two double periods in one of two labs, art as a double in the art room, computing in the ICT suite, and PE as a double for 7A and 7B together in the gym (and again for 8A and 8B). Three teachers have rules: Okafor is off on Monday periods 1 and 2 with at most five periods a day, Lindqvist is off on Fridays, Patel teaches at most five a day.
It is typed like this:
days: Mon, Tue, Wed, Thu, Fri periods: 6 breaks after: 2, 4 rooms: Lab 1 (lab), Lab 2 (lab), Gym (gym), Art room (art), ICT suite (ict) teacher Okafor: off Mon 1-2; max 5 per day teacher Lindqvist: off Fri 7A: Maths / Okafor / 5 7A: English / Lindqvist / 5 7A: Science / Patel / 4 / 2 doubles / lab 7A+7B: PE / Garcia / 2 / double / gym ...
Before searching, the page counts and reports one note: 7A English has five lessons but Lindqvist is in on only four days, so English must fall twice on one day. That is arithmetic, not a solver failure, and it is worth knowing before you blame the tool.
Then it builds the week in about half a second. The result, which the repository's test suite checks on every change: every lesson placed, no class, teacher or room double-booked, no double across a break, no class gaps, no teacher gaps, and exactly one subject repeated on a day: the English that the count said was unavoidable. You then view it by class, teacher or room, print every class or every teacher on its own page, download a CSV for your school system or spreadsheet, or copy a link that opens the same school for a colleague.
When it says it cannot fit
If a teacher has 26 lessons and 24 free periods, no software can fix that. The builder says so with the numbers, before it starts, for teachers, classes, room types and named rooms. If the counting passes but the search still leaves a clash, it lists each one ("Moreau has 7A History and 8A History at once on Tue period 3"), and "Keep improving" continues the search from where it stopped.
When to use something else
- You need cover and substitution planning, a parent app or links to your school information system: a commercial suite such as aSc TimeTables or Untis does that; this page does not.
- You need hundreds of constraint types and are happy to install a desktop program: FET is free, open source and far more configurable.
- You run option blocks (several sets taught in parallel across a year group) or a split site with travel time: not supported yet.
It is for getting a correct first timetable for a small school quickly, with nothing installed and nothing uploaded.
Questions
Does it cost anything or need an account?
No. It is free, MIT licensed and runs in your browser with no sign-up. Nothing you type is uploaded.
What does it do when a timetable cannot fit?
It counts before it searches and reports any teacher, class or room type with more lessons than periods, with the numbers. If the search still leaves a clash, it lists each one and Keep improving continues from there.
Can it plan cover for absent teachers?
No. It builds the weekly timetable only. For cover and substitution planning use a school suite such as aSc TimeTables or Untis.