gcalendarlet README =================== Author: Antonio Cuni Name: gcalendarlet Version: 0.2 (SVN revision: 60684) Description: A desklet to show Google Calendar events SVN Repository: http://codespeak.net/svn/user/antocuni/gcalendarlet Requirements ------------ Apart from adesklets itself, the only library required by gcalendarlet is gdata, which is needed to access to various Google services, including Google Calendar. gdata can be found here: http://code.google.com/apis/gdata/ Configuration ------------- Before you can run gcalendarlet, you need to configure it by specifying your google username and password. To do it, rename the file ``config.txt.example`` to ``config.txt``, then edit it to insert your Google enabled email address and password. There are a lot of other options you can set to customize the appearance of the desklet; have a look the the ``cfg_default`` field of the ``Config`` class to discover them. If the value of an option starts with a ``$``, it will be substitued with the corresponding environment variable, if present. This is very handy if you want the desklets to appear differently depending on some value set by init scripts. For example, I use it to set the maximum height of the desklet depending on my single head/dual head configuration. Usage ----- To run the desklet, simply type ``python gcalendarlet.py`` from the directory where you unpacked the program. Then, you can choose whether to test the desklet or to register it as a persistent desklet. If you register it, remind to run the ``adesklet`` command to make sure it displays the newly registered desklets. Credits ------- The graphic idea and the images used for the background have been stolen from Leland McInnes's SystemMonitor desklet.