source: README.txt @ 23fbfe24ca78e880dfe393d4ea31d61755cf863a

As a addicted geocacher I'm really fancy about the new geocaching application
from Geocaching.com called 'Geocaching Live', also called GCL. It runs on nearly
every J2ME enabled device, that's modern smartphones, either Symbian, Windows
Mobile or Android-powered. There's also a PC-enabled version supplied via Java
Webstart. This PC version of GCL also has special feature which is the
generation of offline maps for usage on the mobile. This is great for people
without a data flat rate for their mobile phone or for caching in regions
without a mobile phone net coverage. But there's also a problem with this
feature! :-( Especially the generation of the higher zoom levels is very slow
because of a pause of 10 seconds before fetching a new map tile from the map
server.

There comes my application, called 'GCLiveMapGen'! ;-)

It is a Python script I've written after some 'Reengineering' of the map
database used by GCL. You need to have Python installed on your PC, at least in
version 2.5 or 2.6, to get it working.

'GCLiveMapGen' has two modes: 'Fetch' and 'Generate'. 'Fetch' is used for
fetching map tiles from one of the public available map tile servers like
OpenStreetMap. 'Generate' is used to generate a GCL Map Database from map tiles
downloaded with the 'Fetch' mode.

Some examples for the usage of 'GCLiveMapGen':

 Command: 'GCLiveMapGen.py fetch Osmarender_Tiles Osmarender 47.5:9.5:48.5:10.5'
          - This will fetch map tiles from the 'Osmarender' map tile server and
            store the tiles retrieved in the directory 'Osmarender_Tiles'. The
            map tiles are only fetched from the area which is described by the
            bounding box with the lower left coordinates N 47.5° E 9.5° and the
            upper right coordinates N 48.5° E 10.5°.

 Command: 'GCLiveMapGen.py generate Osmarender_Tiles GCL_Map_Database'
          - This will generate a GCL Map Database in the directory
            'GCL_Map_Database' from the map tiles we have downloaded into the
            directory 'Osmarender_Tiles'  in the first part of our example.

'GCLiveMapGen' supports a lot of more options. Just call it in the following way
and it will tell you all options it supports:

 Command: 'GCLiveMapGen.py -h'

'GCLiveMapGen' is a quick 'hack' I've written for my own needs, so if you are
missing something from it I'm open for your suggestions! ;-)

And always remember, 'GCLiveMapGen' is freeware and therefore without any
warranty! Use it at your own risk! ;-)

HD Stich <hd@palmtopia.de> 2009