eZCommute Release Notes
-------------------------------------

This is the release of a personal app that I had done to help lazy bones like myself who have a antipathy to catching trains (or buses) on time.

What is eZCommute ?
-----------------------------
It is an application to show train or bus schedules on your Zaurus with the nearest train timings to the current time.
It is Python/PyQT application for the Zaurus.

Features
-------------
- Shows all train (or mass transit) schedules in a friendly list with nearest trains to the current time.
- You can view times for up or down schedules with the tap of a button.
- Allows to set any stations out of all station list in a particular way schedule as origin and any other station as destination.
So you can change your origin/destination stations depending on your commute any time.

Future features
----------------------
- ability to enter or edit any schedule 
  (now the schedule has to be created manually)
- support for multiple schedule files
- show time left for subseqent train / bus timings from current time

How to create a schedule timetable ?
----------------------------------------------------

Its a simple flat file structure.

add a list of the station names delimted with commas in a header row and then in each subsequent row add a list of the time for each station stop delimted with commas.

example :
New York, Newark, New Brunswick, Trenton
15:07, 15:26, 16:01, 17:04
15:25, 15:44, 16:17, 17:20
15:33, 15:53, 16:24, 17:27

Note : all times are in 24 hr format.

So nos of train stations should match the nos of time in hrs in each row. 
If you only want to add just the origin and destination station, then only add 2 comma delimted times per row as follows

New York, Trenton
15:07, 17:04
15:25, 17:20
15:33, 17:27

But remember, in this case you cannot change stations in case you wanted to go to Newark. So it is better to include all station (or as many) for greater flexible schedules.

How to make a "Up" and "Dn" schedule ?
----------------------------------------------------
The "Up" and "Dn" schedules should be two seprate files named as follows (for now).


for "Up" journey - Timetable_up.txt
for down (return leg) - Timetable_dn.txt

so the "up" file would look like this - 
Jersey Ave, New Brunswick, Newark, New York
5:11, 5:16, 5:55, 6:15
5:40, 5:45, 6:26, 6:46
6:20, 6:27, 7:00, 7:23
6:32, 6:39, 7:14, 7:36


while the "dn" file would look like this - 
New York, Newark, New Brunswick, Jersey Ave
15:07, 15:26, 16:01, 17:01
15:25, 15:44, 16:17, 17:02
15:33, 15:53, 16:24, 17:03


Companion Application
----------------------
eZCommute-Mobile - for the Nokia phones with S60 platform

This is a view only (not able to create or edit schedules) application for a fast view of train/bus schedules on your phone.
Must faster and convenient than taking out your Zaurus, starting and wating for the application to start (remember, python apps on Zaurus are a little slower to start) while maybe your train zips by on the platform (often happens to me).

You can create and edit the schedules on the Zaurus and then manually copy over the "up" and "dn" schedule files to the Nokia phone.
The Data files have to be copied under the "data" directory of the parent "eZCommute" directory wherever the eZCommute application was installed on the phone memory.
In the future will design a bluetooth Sync application to sync your timetables between the Zaurus and the Nokia phone (for phones supporting Bluetooth)

Requirement for the phone
--------------------------

Install the compatible (and possibly latest 1.3 version) of python for your model of the S60 phone.
See website  - http://www.mobilenin.com/pys60/which_pys60_for_your_phone_model.php
for details on which version is for your version of the S60 device.

Installation
-------------
Just copy over the .SIS file to your phone (via IrDA or Bluetooth) and then install the application to your phone memory.
Note : It  still does not work flawlessly when installed to internal memory (MMC Card).


support : nilchak@yahoo.com
copyright : nilch



