TimeFinder Documentation 2009-v1


To run TimeFinder Java1.6 is necessary. If you not already have it then get it from here.

To download and install TimeFinder click on this link. The java web-start engine downloads now the necessary jar files (21MB). After this was successful (it should be ;-)) you have to confirm the execution.

Another option is to download the zip bundle from here. Then unzip the file and double click on the run.bat file if you are on Windows or click on the run.sh file if you are on linux or mac.

While starting TimeFinder the splash-screen should appear:


You have to accept the Apache License, Version 2.0


and click ‘Start TimeFinder’ which will show the main TimeFinder window (without any view).

Manual Timetabling

Person Table View

To see something useful go to the menu entry Window->Show Views->Person table and e.g. create a new person:


TimeFinder marks your input red if it failed to validate it. See the small red cross-icon on the bottom of the input field for the detailed reason.

How you can import a junk of data is described in the import sample data section.

Be sure that you defined at least one person now. So that we can assign persons to an event in one of the following chapters.

You can sort via clicking on one of the table headers or filter persons agains their names within the filter-textfield.

Event Table View

Here you can define events and its visitors. For example if you want that all persons of a class should attend Mathmatics then do the following:

  1. Create an event with the ‘new event’ button. Set the properties e.g. the name to ‘Mathmatics’:event-table-2009-v1
  2. You should have defined some persons one chapter before. Go to the persons-tab and you should see:event-table-persons-tab-2009-v1
    Add all necessary person (of the class) via the '>' button.
  3. You can add features if Mathmatics requires one room:event-table-features-tab-2009-v1
  4. Click Save. Then a new event should be listed in the table

Location Table View

Within the location table you can define your rooms or places with the specific capacity and features (e.g. only some rooms have a blackboard or a video installation).

Feature Table View

Here you can define features which are required from some events. And only some rooms offer them.

Import Sample Data

Download sample data from here. Unzip the file e.g. in your documents folder. Then click File->Import tim File from within timefinder. Now it will warn you that the settings will be changed. Click okay and select a .tim file from that zip archive.

Now the progressbar at the bottom right side indicates the status of the import action. After this several persons, events etc. should be listed in the tables.

You can also import from xml files if you have exported one before.

Save Changes

To save all changes (including the start times of the events gained from the optimization or from manual editing) go to the File menu and click Export Xml.

Automatic Timetabling

If you have some data (at least some persons, events and rooms) you can optimize the start time and room assignment of all events automagically.

Go to the menu Timetabling and click Start Optimization.

After finishing or stopping (see the progressbar at the bottom-right side) the optimization the start times and locations should have changed. To convince yourself that all persons have no clashing events you can go to the TimeFinder Planner in the Windows menu. All events should be scheduled in the first week:


One thought on “TimeFinder Documentation 2009-v1

  1. Pingback: TimeFinder released - An open source timetabler « Java and more …

Comments are closed.