Free class timetable generator

The tool places one class’s lessons into a weekly grid with a simple rule: no period holds two lessons, and a subject rarely repeats on the same day unless you allow double lessons. It starts from a randomized pass ordered by your preferences, then repairs the layout until every lesson fits or the grid is full.

Because it works from a seed, the same inputs always produce the same timetable. Regenerate changes the seed, so you get a different valid arrangement each time without editing anything.

Take a class with Maths and English at five lessons each, Science at four, History at three, and PE and Art at two. That is twenty-one lessons across a five-day week of six periods, so thirty slots.

Mark Maths, English, and Science as earlier subjects, and Maths to avoid the last period. The generator places the academic subjects in the morning, spreads each subject across different days, and leaves free periods where the week is not full. Regenerate and the same rules produce a fresh layout.

This generator schedules one class in isolation. It does not share teachers or rooms across classes, resolve conflicts between year groups, or weigh competing priorities.

Real schools schedule every class at once, against shared teachers, rooms, and equipment. That is a much harder problem, and it is what Smootables is built to solve.