Index of /python/upcalendar
Name Last modified Size Description
Parent Directory -
s60-upcalendar-0.11...> 2008-11-22 09:33 5.8K GZIP compressed docume>
s60-upcalendar-0.1.t..> 2008-11-22 09:33 6.5K GZIP compressed docume>
Changes 2008-11-22 09:33 1.0K
NAME
s60-upcalendar - sync your upcoming.org watchlist with your calendar
SYNOPSIS
Phone > My own > Python > Options > Run script > s60-upcalendar.py
DESCRIPTION
s60-upcalendar is an application to sync your "watchlist" on
upcoming.org with your calendar.
OPTIONS
The following options can be acccessed from the application's Options
menu.
Merge your watchlist
Perform the merge to add items on your upcoming.org watchlist to your
calendar.
If an event already exists in your calendar it will be updated with the
most recent information. Past events are not removed.
Set default alarm
Set a default alarm to be assigned to all items added to your calendar.
The format for alarms is a number followed by one of the following :
* m The number of minutes prior to an event that an alarm should sound.
* h The number of hours prior to an event that an alarm should sound.
* d The number of days prior to an event that an alarm should sound.
To disable alarms, enter *0*. Your watchlist will need to be re-merged
in order for charges to your alarm preferences to stick.
Change your auth token
Please read the AUTHENTICATION section below.
Purge metro and venue cache
upcalendar caches both metro and venue data for faster updates. You may
purge this cache if you think that some of the data is out of sync.
AUTHENTICATION
The Upcoming API uses 'tokens' for user authentication, instead of your
username and password.
Tokens are like passwords, in that each is unique to a user. Unlike
passwords they are often very long and composed of, basically,
gibberish. This is great because it makes them hard to guess but not so
great because they are difficult to enter and users still need to log in
to a website in order to get a token. Both things that are irritating on
cell phones.
With that in mind the best thing to do, to set up an authentication
token for upcalendar, is to sit with your phone the next time you go to
upcoming.org and visit this URL :
http://upcoming.org/services/auth/?api_key=b92238793f
This page will display a custom authentication 'frob' which is a
time-sensitive key to get a proper authentication token.
When you are prompted to configure your auth token in upcalender select
'Enter auth frob by hand' and type in the frob. ` *This is a boring
thing to do have to do* but you should only have to do it once. It is
also better to do it this way than to try and do the same from your
phone's web browser.
(And if you want to, upcalendar will let you.)
REQUIREMENTS
Series 60 Python
<http://postneo.com/postwiki/moin.cgi/PythonForSeries60>
PDIS Python extensions
<http://pdis.hiit.fi/pdis/download/pdis/>
(Specifically the ElementTree/XPath bits)
VERSION
0.11
DATE
$Date: 2006/08/22 18:26:40 $
AUTHOR
Aaron Straup Cope
SEE ALSO
<http://www.upcoming.org/>
<http://upcoming.org/services/api/token_auth.php>
<http://www.aaronland.info/weblog/2006/08/04/zebra#upcalendar>
COPYRIGHT
Copyright (c) 2006 Aaron Straup Cope. All Rights Reserved.
LICENSE
Perl Artistic License.
This is free software, you may use it and distribute it under the same
terms as Perl itself.