Skip to main content
Help bring Smoov to your uni - volunteer and get lifetime Premium
Back to home

How to use Smoov

Everything you need to know about using Smoov to build your perfect timetable.

Getting Started

Smoov is a university timetable optimiser that runs entirely in your browser. No account is needed to get started - just open the app and follow the three-step wizard:

1Subjects - add the subjects you need to enrol in, either manually or by importing from your university system.
2Classes - for each subject, add the available class times (lectures, tutorials, labs, etc.).
3Preferences - tell Smoov what matters to you (fewer days on campus, no early mornings, free lunch breaks, etc.).

Hit Optimise and Smoov will generate several schedule options ranked by how well they match your preferences, with tradeoff explanations for each.

Adding Subjects

In the first step of the wizard, add each subject you plan to enrol in. Enter the subject code (e.g. “COMP1234”) and optionally a display name (e.g. “Intro to Programming”). Smoov will warn you if you try to add a duplicate subject code.

Free accounts can add up to 4 subjects. Premium users can add up to 6 subjects.

Importing from Allocate+

If you're at UTS, USYD and ANU, you can import your subjects and class times directly from Allocate+ instead of entering them manually. More universities coming soon. This is a desktop-only feature.

1Open Allocate+ in your browser and navigate to your timetable.
2In Smoov, click Import from Allocate+ and copy the provided script.
3Open your browser's developer console (F12 or Ctrl+Shift+J) on the Allocate+ page and paste the script.
4Copy the output and paste it back into Smoov's import dialog.

You'll see a preview of all detected subjects. You can exclude any subjects you don't want before confirming the import.

Adding Classes & Times

For each subject, add every available class option. Each class has:

Activity type - lecture, tutorial, lab, workshop, seminar, practical, studio, recording, and more.
Mode - in-person, live-online, or async. Async classes have no scheduled time and won't appear on the timetable.
Day and time - the day of the week, start time, and end time (30-minute precision).
Location - optional campus or building info.

Use the duplicate button to quickly copy a class and adjust just the time or day. Click any field to edit it inline.

Setting Preferences

Preferences are soft constraints - Smoov will try to satisfy them but will still generate schedules even if not all preferences can be met. Each schedule card explains which preferences were satisfied and which were traded off.

Minimise days on campus

Packs classes into fewer days so you have more days off.

Avoid early mornings

Avoids classes starting before 10 AM.

Minimise gaps

Reduces dead time between classes on the same day.

Protect a day

Keeps one or more chosen days completely free from classes.

Breathing room between classes

Ensures at least a 30-minute buffer between back-to-back classes.

Finish by 4pm

Avoids classes that run past 4 pm.

Protect lunch break

Keeps a gap around midday for a lunch break.

Prefer afternoons

Favours afternoon class times over morning ones.

Free accounts can enable up to 3 preferences with a fixed medium weight. Premium users get all 8 preferences with adjustable weight sliders (very low, low, medium, high, critical).

If two preferences conflict (e.g. “fewer days on campus” and “minimise gaps”), Smoov will warn you. The solver will still run - it just means some schedules will favour one preference over the other.

Time Blocking

If you have recurring commitments outside of uni - a part-time job, sport training, regular appointments - you can block those times so Smoov never schedules classes during them.

Time blocks are treated as hard constraints. Unlike preferences, they are never traded off. Any class option that overlaps with a time block is removed from consideration. If every option for a subject conflicts with a time block, the solver will tell you which block is causing the issue so you can adjust.

Optimising Your Schedule

When you click Optimise, Smoov runs a constraint-satisfaction solver in a background thread so the UI stays responsive. The solver uses backtracking with smart heuristics (minimum remaining values, forward checking) to efficiently explore the space of possible timetables.

Each valid timetable is scored against your preferences, and the top results are selected with enough diversity so you get meaningfully different options - not just minor variations of the same schedule.

Free accounts receive 2 schedule options. Premium users receive up to 4 options.

Understanding Your Results

Each schedule card shows:

Rank and title - a descriptive name (e.g. “The Balanced One”) based on the schedule's standout characteristics.
Mini calendar - a compact weekly view of your classes, colour-coded by subject.
Stats strip - quick metrics like campus days, total hours, and earliest/latest class.
Tradeoff badges - green “wins” show preferences that were fully satisfied, amber “costs” show preferences that were traded off, and blue “features” highlight other notable characteristics.

Comparing Schedules

On the comparison page, hover over any class slot on one card and the same class will be highlighted on all other cards, making it easy to see which times change between options.

Hold Ctrl and click two schedule cards to enter compare mode. Classes at the same time in both schedules are highlighted in green, while classes at different times are highlighted in amber.

Enrollment Mode

Smoov supports two enrollment systems. Set this in Step 3 (Preferences) or let it auto-detect when you import from Allocate+.

First-come first-served

Your uni opens enrollment at a set time and you pick one option per class. Smoov gives you the optimal schedule to select. If a class fills up, mark it as full and re-optimise.

Preference-based

You rank all options per class in order of preference and your uni assigns based on those rankings. Smoov generates optimised preference rankings for every class, showing which options appear in the most valid schedules.

Free accounts see the top 3 rankings per activity. Premium users see all rankings with frequency bars showing how robust each choice is.

Locking Classes (Anchors)

Premium

Found a perfect time for one class? Click any class slot on a schedule card to “anchor” it. Anchored classes are locked in place - when you re-run the optimiser, Smoov will keep those classes fixed and only rearrange everything else.

This lets you iteratively build your ideal timetable: optimise, lock the bits you like, tweak preferences, and optimise again.

Exporting Your Schedule

Once you've chosen your schedule, you can export it in several ways:

ICS download

Imports into Apple Calendar, Outlook, and most calendar apps. You'll be asked to set your semester start date so events land on the correct weeks.

Google Calendar

Opens Google Calendar with pre-filled event details. No OAuth or API access required - it uses Google's public URL scheme.

Image export

Saves your schedule as a PNG image you can share or print. On supported devices you can also use the native share sheet.

Share link

Generates a URL that anyone can open to see your schedule, even without a Smoov account. The schedule data is compressed and embedded in the URL.

ICS and Google Calendar export are Premium features.

SmoovSync - Group Scheduling

Premium

SmoovSync lets you coordinate timetables with friends. One person creates a room and shares the 6-character room code. Others join the room and upload their top schedule options.

1Share a 6-character room code with your friends.
2Everyone uploads their top schedules.
3Smoov finds the combo with the most shared free time.

The group matching algorithm scores combinations by:

Shared free blocks (time you can all hang out)

Overlapping lunch breaks

Common campus days

Shared days off

Shared classes (same subject at the same time)

The group calendar view shows everyone's schedules overlaid so you can see when you're all free.

Account & Premium

Smoov works without an account. All your data is stored locally in your browser. You only need to sign in if you want to upgrade to Premium.

Sign in uses a 6-digit code sent to your email - no password needed. Just enter your email and type in the code.

Premium unlocks:

Up to 6 subjects (free: 4)
Up to 4 schedule results (free: 2)
All 8 preferences with adjustable weights (free: 3, fixed medium)
Full preference rankings with frequency bars (free: top 3 per activity)
Class anchoring (locking)
ICS and Google Calendar export
SmoovSync group scheduling

You can manage or cancel your subscription at any time from the billing portal, accessible through the user menu in the header.

Tips & Troubleshooting